URI
<dataset_uri>/gridValue[.<format>]
Supported methods
Parent resource
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:
- GET: Gets the raster unit information corresponding with a location.
- HEAD: Checks whether the gridValue resource exists or whether it has permission to access the resource.
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.