geometry

URI

<root_uri>/{version}/geometry[.<format>]

Supported methods

GET, HEAD

Parent resource

root

Child resources

area, distance, coordtransfer

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:

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.

See