URI
<root_uri>/{version}/geometry[.<format>]
Supported methods
Parent resource
Child resources
Introduction
geometry resource represents the root resource of gometry services. By performing a GET request on geometry resource, you can obtain the supported interfaces, including area measurement, distance measurement and coordinate conversion funcition.
Supported Methods:
- GET: Gets child resource information list. Including area measurement, distance measurement and coordinate conversion.
- HEAD: Checks whether the geometry resource exists, and if the client has the permission to access this 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/geometry/restjsr/v1/geometry.rjson
GET request
Gets child resource information list.
Response structure
By performing a GET request on data resource, the response entity is a description set of the child resources, and the description structure of one single resource is as follows:
| Field | Type | Description |
| name | String | Resource name. |
| path | String | Resource access path. |
| resourceConfigID | String | ID of the resource configuration item. |
| resourceType | String | Resource type. |
| supportedMediaTypes | String[] | The supported media types. |
Response example
By executing a GET request on distance resource with URI: http://supermapiserver:8090/iserver/services/geometry/restjsr/v1/geometry.rjson, the returned response result in rjosn format is as follows:
[
{
"name": "area",
"path": "http://supermapiserver:8090/iserver/services/geometry-geometry/restjsr/v1/geometry/area",
"resourceConfigID": null,
"resourceType": null,
"supportedMediaTypes": null
},
{
"name": "distance",
"path": "http://supermapiserver:8090/iserver/services/geometry-geometry/restjsr/v1/geometry/distance",
"resourceConfigID": null,
"resourceType": null,
"supportedMediaTypes": null
},
{
"name": "coordtransfer",
"path": "http://supermapiserver:8090/iserver/services/geometry-geometry/restjsr/v1/geometry/coordtransfer",
"resourceConfigID": null,
"resourceType": null,
"supportedMediaTypes": null
}
]
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 geometry resource exists, or if the client has the authority to access it. By executing an HEAD request with a .<format> URI, you can quickly determine whether the geometry resource supports the <format> representation.