geometryThiessenPolygonResults

URI

<geometry_uri>/thiessenpolygon[.<format>]

支持的方法

GET、POST、HEAD

父资源

geometry

子资源

geometryThiessenPolygonResult

介绍

几何对象邻近分析结果集资源，可以基于点数组生成泰森多边形。

支持的方法：

支持的表述格式：rjson、json、html、xml。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/thiessenpolygon.rjson

GET 请求

html表述返回一个 POST 请求的表单，其他表述返回几何对象邻近分析结果集。

POST 请求

返回生成的泰森多边形结果资源。

请求参数

名称 类型 含义
points Point2D[] 使用点数组进行分析时使用的几何对象。
clipRegion Geometry 结果数据裁剪区域，可以为 null，表示不对结果进行裁剪。
createResultDataset boolean 是否返回结果数据集，默认不返回。
resultDatasetName String 指定结果数据集名称。
resultDatasourceName String 指定结果数据集所在数据源。
returnResultRegion boolean 是否返回分析得到的多边形面数组，默认返回。

响应结构

正常响应情况：响应码201。响应参数如下：

字段 类型 说明

succeed

 boolean 分析是否成功。
newResourceID String 分析结果资源的 ID。
postResultType PostResultType

POST 请求的结果类型，枚举说明 POST 请求对目标资源的影响，即处理结果是什么样的。
newResourceLocation String 创建的新资源的 URI。

响应示例

对 geometryThiessenPolygenResults 资源 http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/thiessenpolygon.rjson，执行 POST 请求，发送 rjson 格式请求体如下：

{

    "usePoints": false,

    "points": [{

        "y": 33.173365394332386,

        "x": 98.01763839650486

    },

    {

        "y": 45.929526570323986,

        "x": 10.1903868382616

    },

    {

        "y": 34.64343254047105,

        "x": 15.129150755768138

    },

    {

        "y": 62.09158448581845,

        "x": 87.3898730056924

    },

    {

        "y": 54.93740505446476,

        "x": 10.900651499852987

    },

    {

        "y": 50.50252956794513,

        "x": 20.505418251361472

    }],

    "clipRegion": {

        "center": {

            "y": 50,

            "x": 50

        },

        "id": 0,

        "style": null,

        "parts": [5],

        "points": [{

            "y": 0,

            "x": 0

        },

        {

            "y": 0,

            "x": 100

        },

        {

            "y": 100,

            "x": 100

        },

        {

            "y": 100,

            "x": 0

        },

        {

            "y": 0,

            "x": 0

        }],

        "type": "REGION"

    },

    "createResultDataset": false,

    "returnResultRegion": true

}

则返回的 rjson 格式结果如下：

{

    "succeed": true,

    "newResourceID": "n8zmmavh_36ccd0a04b3b40399a0627ee0fb6ff0f",

    "postResultType": "CreateChild",

    "newResourceLocation": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/thiessenpolygon/n8zmmavh_36ccd0a04b3b40399a0627ee0fb6ff0f"

}

对资源：http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/thiessenpolygon/n8zmmavh_36ccd0a04b3b40399a0627ee0fb6ff0f，执行 GET 请求，即可获取分析结果的具体信息。请参见geometryThiessenPolygonResult。

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 geometryThiessenPolygonResults 资源是否存在，或者客户端是否有权限访问 geometryThiessenPolygonResults 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 geometryThiessenPolygonResults 资源是否支持<format>格式的表述。

请参见