URI

<geometryService_uri>/intersect[.<format>]

支持的方法

GET、POST、HEAD

父资源

geometryService

介绍

相交资源表示在几何服务资源中进行的几何图形取交集的操作， 此操作为一组几何图形和另一个几何图形之间取交集。得到的结果的大小为由 geometries 定义的几何数组和 geometry 定义的几何中最小几何图形的尺寸。

支持的方法：

  • GET：获取几何数组与另一几何图形的交集。
  • POST：根据给定条件，创建几何数组与另一几何图形的交集。
  • HEAD：检查 intersect 资源是否存在，或权限是否可以访问 intersect 资源。

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/{component}/arcgisrest/Geometry/GeometryServer/intersect.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]]

  ]

 }}

响应结构

对 intersect 资源执行 GET 请求，返回的是几何图形信息。

字段 类型 说明
geometryType ArcGISGeometryType 几何图形的类型。
geometries ArcPointNoProj[] 坐标构成的点数组。
ArcPolylineNoProj[] 坐标构成的线数组。
ArcPolygonNoProj[] 坐标构成的面数组。

响应示例

对 ArcGIS intersect 资源：http://supermapiserver:8090/iserver/services/geometry-vvvv/arcgisrest/Geometry/GeometryServer/intersect?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]]]}} 执行 GET 请求，返回 pjson 格式的资源表述如下:

{

    "geometries": [

        {"rings": [[

            [

                -71,

                39

            ],

            [

                -72,

                39

            ],

            [

                -72,

                40

            ],

            [

                -71,

                39

            ]

        ]]},

        {"rings": [[

            [

                -74,

                38

            ],

            [

                -74,

                40

            ],

            [

                -73,

                39

            ],

            [

                -73,

                38

            ],

            [

                -74,

                38

            ]

        ]]}

    ],

    "geometryType": "esriGeometryPolygon"

POST 请求

跟 GET 请求结构类似。

HEAD 请求

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

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

请参见