URI

<vectorMap_uri>/v2/mapserver/{serverName}/{styleId}/pickup
[.<format>]

Supported Methods

GET、HEAD

Parent Resource

vectorMap

Introduction

This resource is used to query the feature belonging to a specified map level and point location under a specified style, returning the fields and attribute values of features in all matching layers in the map.

This API can cover the corresponding capabilities of the JW vector tiles service.

Supported Methods:

  • GET: Query the feature belonging to a specified map level and point location under a specified style.
  • HEAD: Check whether the datas resource exists and whether the client has access permission.

Supported Representation Formats: RJSON, JSON, JSONP.

HTTP Request Method

Perform an HTTP request on the following URI, using JSON output format as an example. In this URI, supermapiserver is the server name, {component} is the component name, {serverName} is the "service name" defined during service publishing (If not set, it will be the default service name generated by iServer), and {styleId} is the style ID.

http://supermapiserver:8090/iserver/services/vectorMap-DLTB-public/restjsr/v2/mapserver/{serverName}/{styleId}/pickup.json

GET Request

Query the feature belonging to a specified map level and point location under a specified style, returning the fields and attribute values of features in all matching layers in the map.

Request Parameters

Name Type Description
level int [Required parameter] Map level
lon double [Required parameter] Longitude of the point for point query.
lat double [Required parameter] Latitude of the point for point query.
includelabel boolean Whether to include labels; default is false

Response Structure

Executing a GET request on the pickup resource returns the following structure of the resource representation:

Field Type Description
layer JSON object Uses layer ID to represent the layer, expressing the specified feature in the specified layer. The feature is an object, represented by the feature ID, and the fields it contains are all feature attribute values.

Response Example

Perform a GET request on the pickup resource: http://supermapiserver:8090/iserver/services/vectorMap-DLTB-public/restjsr/v2/mapserver/test/DLTB/pickup.json?level=14&lon=108.32708358764648&lat=23.329034821872966&includelabel=false . The JSON format resource representation returned is as follows:

{
    "dltb40w_4490": {
        "6755903": {
            "smid": 6755903,
            "dlbm": "113",
            "dlmc": "Reservoir water surface"
        }
    }
}

HEAD Request

Returns the same HTTP response headers as a GET request, but without a response body. This allows obtaining metadata information contained in the response headers, including media type, character encoding, compression encoding, entity content length, etc., without needing to transmit the entire response content.

The HEAD request can be used to determine whether the pickup resource exists, or whether the client has permission to access the pickup resource. By performing a HEAD request on the URI with .<format> appended, you can also quickly check whether the pickup resource supports the representation of the <format> format.

See Also