URI
<SpatialQuery3D_uri>/{datasetSpatialQuery3DResultID}[.<format>]
Supported methods
Parent resource
Introduction
The 3D spatial analysis result resource, used to get the result with the specified spatial relation.
Supported methods:
- GET: Returns the result of 3D spatial analysis.
- HEAD: Checks whether the datasetSpatialQuery3DResult resource exists, or if the client has the authority to access the datasetSpatialQuery3DResult resource.
Supported output formats: RJSON, JSON, HTML, XML.
Resource hierarchy
HTTP request methods
Execute HTTP request on the following URI, here we take rjosn as the output format as an example. Where, supermapiserver is the server name.
http://supermapiserver:8090/iserver/services/spatialAnalysis-BIM2/restjsr/spatialanalyst/datasets/结构柱@8ExportModel/SpatialQuery3D/{datasetSpatialQuery3DResultID}.rjson
GET request
Returns the result of 3D spatial analysis.
Response structure
Perform a GET request on the current resource, the response fields are as follows:
| Field | Type | Description |
| succeed | boolean | Marks whether the analysis is successful. |
| ids | int[] | The IDs of analysis result. |
| posMode | PositionMode | Spatial relation types, including: UNKNOWN, IDENTICAL, DISJOINT, INTERSECTS, WITHIN, CONTAINS, INTERSECTSORCONTAINS. |
| message | String | The information generated duiring 3D spatial analysis process. |
Response example
Perform a GET request on the current resource, the returned result in json format is as follows:
{
"succeed":true,
"ids":[15,18],
"posMode":"UNKNOWN",
"message":"[15, 18]"
}。
HEAD request
Returns the same HTTP response header as the GET request, but no response entity, which can be used to retrieve the meta data contained in response message header without having to transmit the entire response content. Meta data information includes media type, character coding, compression coding, entity content length, etc.
HEAD request is used to determine whether the datasetSpatialQuery3DResult resource exists, or if the user has the authority to access it. By executing an HEAD request with a .<format> URI, you can quickly determine whether the datasetSpatialQuery3DResult resource supports the <format> representation.