gridValue

URI

<dataset_uri>/gridValue[.<format>]

Supported methods

GET, HEAD

Parent resource

dataset

Introduction

gridValue indicates the raster information value. Through sending get request to gridValue, you can query the raster unit information corresponding with a location, which includes raster value, raster row, raster column.

Supported Methods:

Supported output formats: rjson, json, html, xml.

Resource hierarchy

HTTP request methods

Implement the HTTP request on the following URI, where supermapiserver is the server name, with rjson being the output format.

http://supermapiserver:8090/iserver/services/data-World/rest/data/datasources/World/datasets/LandCover/gridValue.rjson

GET request

Gets the raster unit information corresponding with a location.

Request parameter

To acquire raster information through implementing the GET request on gridValue resource, following parameters can be included in the URI:

Name Type Description

X coordinate

 double The x-coordinate of location
Y coordinate double The y-coordinate of location

Response structure

The structure of the response resource representation after implementing the GET request on the gridValue resource will be as follows:

Field Type Description
column int The raster row number corresponded with the queried location
row int The raster column number corresponded with the queried location
value double The raster value corresponded with the queried location

Response example

Sending get request to gridValue resource: http://supermapiserver:8090/iserver/services/data-world/rest/data/datasources/World/datasets/LandCover/gridValue.rjson?x=-110&y=50, the rjson representation of the raster unit information is given below:

{

    "column": 1120,

    "row": 640,

    "value": 10

}

HEAD request

Asks for the response identical to the one that would correspond to a GET request, but without the response body. This is useful for retrieving meta-information written in response headers, without having to transport the entire content. The meta-information includes the media-type, content-encoding, transfer-encoding, content-length, etc.

HEAD request can be used to check if the gridValue resource exists, or if the gridValue resource can be accessed by clients. It can also determine if the gridValue resource supports an output format <format> if performed on a URI with .<format> included.

See