grid3dIntersection

URI

<geometry_uri>/grid3d/intersection[.<format>]

支持的方法

GET、POST、HEAD

父资源

geometry

子资源

无

介绍

三维网格相交判断资源。该资源支持判断多组三维几何对象在指定网格层级下是否有网格空间冲突（相交），用于空域冲突检测和航线安全性评估。

网格相交判断通过将几何对象转换为指定层级的网格编码，在网格空间层面比较两组几何对象的网格是否有重叠。当前版本仅支持 GeoSOT 网格类型。

对该资源发送 POST 请求，可以执行三维网格相交判断。

支持的方法：

GET：返回一个进行 POST 请求的表单。
POST：执行三维网格相交判断。
HEAD：检查 grid3dIntersection 资源是否存在，或权限是否可以访问该资源。

支持的表述格式：RJSON、JSON、HTML、XML。

HTTP 请求方法

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

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

GET 请求

返回一个进行 POST 请求的表单。

POST 请求

执行三维网格相交判断。

请求参数

请求体中需传递如下参数：

名称	类型	含义
gridType	Spatial3DGridType	【可选参数】三维网格类型，默认为 GEOSOT。
geometryPair	Geometry3DGridIntersectPair	【必填参数】几何相交对（单个对象），包含 sourceGeometries、targetGeometries 和 level（三维网格层级）。一般建议最高使用 24-25 层级，过高的层级会导致网格数量过多，可能超出数据库的限制。
returnGrid3DPositioning	boolean	【可选参数】是否返回相交三维网格定位字符串列表，默认为 false。

响应结构

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

字段	类型	说明
succeed	boolean	操作是否成功。
message	String	失败时返回的错误信息。
gridType	Spatial3DGridType	三维网格类型。
intersectGridCodes	String[]	相交三维网格编码列表，无相交时为空数组 [ ]。
intersectGrid3DPositioning	String[]	相交三维网格包围盒字符串列表，格式为 "xmin,xmax,ymin,ymax,zmin,zmax"。仅当 returnGrid3DPositioning=true 时返回。

响应示例

执行 POST 请求，请求参数如下：

{
"gridType": "GEOSOT",
"geometryPair": {"sourceGeometries": [{"type": "POINT3D", "x": 116.397, "y": 39.908, "z": 100.0}], "targetGeometries": [{"type": "LINE3D", "points": [{"x": 116.395, "y": 39.906, "z": 100.0}, {"x": 116.400, "y": 39.910, "z": 100.0}]}], "level": 17},
"returnGrid3DPositioning": false
}

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

{
"succeed": true,
"message": "",
"status": "FINISHED",
"gridType": "GEOSOT",
"intersectGridCodes": ["G001310322-232132-032220.312,1101"],
"intersectGrid3DPositioning": null
}

HEAD 请求

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

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

URI