URI
<geometryService_uri>/union[.<format>]
支持的方法
父资源
介绍
并集资源表示在几何服务资源中进行的几何图形取并集的操作, 此操作为输入数组中的几何图形取并集。注意,所有输入类型必须相同。
支持的方法:
资源层次
HTTP 请求方法
对如下 URI 执行 HTTP 请求,以 json 输出格式为例加以说明,其中,supermapiserver 是服务器名, {component}是服务组件名。
http://supermapiserver:8090/iserver/services/{component}/arcgisrest/Geometry/GeometryServer/union.json
GET 请求
获取几何数组内几何图形的并集。
请求参数
名称 | 类型 | 含义 |
f | String | 响应格式,支持 json、pjson |
geometries | String | 【必设参数】
需要进行并集操作的几何数组。
例如:
{ "geometryType" : "esriGeometryPolyline", "geometries" : [ { "paths" : [ [[-117,34],[-116,34],[-117,33]], [[-115,44],[-114,43],[-115,43]] ] }, { "paths" : [ [[32,17],[31,17],[30,17],[30,16]] ] } ] } |
geometry | String | 【必设参数】
任意类型的、大小等于或大于 geometries 中元素的单个几何图形。此参数不支持使用简单语法表示。
例如:
{"geometryType" : "esriGeometryPolygon","geometry" : { "rings" : [ [[-117,34],[-116,34],[-117,33],[-117,34]], [[-115,44],[-114,43],[-115,43],[-115,44]] ] }} |
响应结构
对 union 资源执行 GET 请求,返回的是几何图形信息。
字段 | 类型 | 说明 |
geometryType | ArcGISGeometryType | 几何图形的类型。 |
geometries | ArcPointNoProj[] | 坐标构成的点数组。 |
ArcPolylineNoProj[] | 坐标构成的线数组。 | |
ArcPolygonNoProj[] | 坐标构成的面数组。 |
响应示例
对 ArcGIS union 资源:http://supermapiserver:8090/iserver/services/geometry-vvvv/arcgisrest/Geometry/GeometryServer/union?geometries={"geometryType":"esriGeometryPolygon","geometries":[{"rings":[[[-72,40],[-71,40],[-71,39],[-72,39],[-72,40]]]},{"rings":[[[-74,37],[-74,41],[-73,41],[-73,37],[-74,37]]]}]}&geometry={"geometryType":"esriGeometryPolygon","geometry":{"rings":[[[-75,39],[-74,40],[-73,39],[-72,40],[-71,39],[-71,38],[-75,38],[-75,39]]]}}&sr=4269&f=pjson 执行 GET 请求,返回 pjson 格式的资源表述如下:
{
"geometries": [
{"rings": [[
[
-72,
40
],
[
-71,
40
],
[
-71,
39
],
[
-71,
38
],
[
-75,
38
],
[
-75,
39
],
[
-74,
40
],
[
-73,
39
],
[
-72,
40
]
]]},
{"rings": [[
[
-74,
37
],
[
-74,
38
],
[
-75,
38
],
[
-75,
39
],
[
-74,
40
],
[
-74,
41
],
[
-73,
41
],
[
-73,
39
],
[
-72,
40
],
[
-71,
39
],
[
-71,
38
],
[
-73,
38
],
[
-73,
37
],
[
-74,
37
]
]]}
],
"geometryType": "esriGeometryPolygon"
}
POST 请求
跟 GET 请求结构类似。
HEAD 请求
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 union 资源是否存在,或者客户端是否有权限访问 union 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 union 资源是否支持<format>格式的表述。