URI
<blankRegions uri>/markednot[.<format>]
Supported methods
Parent resource
Introduction
Lists all marked normal region information list of the specified tile task.
Supported Methods:
- GET: Gets all marked normal region information list of the specified tile task.
- HEAD: Checks whether the markedNotBlankRegions resource exists, or whether it can be accessed.
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/manager/tileservice/jobs/7d59376f-f47a-405b-9862-41ac160b8f23/blankregions/markednot.rjson
GET request
Gets all marked normal region information list of the specified tile task. The request parameters must be placed in URI.
Request parameter
| Name | Type | Description |
| scale | double | [Required] The display scale of the map. |
| fromIndex | int | [Optional] Returned starting index of the query result. |
| toIndex | int | [Optional] Returned ending index of the query result. |
Response structure
Suppose we implement the GET request on the markedNotBlankRegions resource to return the BlankRegion[] field indicating the list of all marked normal regions, the structure of the BlankRegion[] field is as follows:
| Field | Type | Description |
| blankRegionId | String | The ID of the normally marked region. |
| center | Point2D | The center point for map display. |
| id | int | The ID of the geometric object. |
| markType | MarkType | The type of the marked blank region. VALID indicates normal regions. |
| parts | int[] | The numbers of vertices contained by child objects of the geometric object. |
| points | Point2D[] | The array of 2D coordinates of vertices composing the geometric object. |
| style | Style | The style of the geometry object. |
| type | GeometryType | The type of the geometry object. |
Response example
The returned rjson format representation after implementing the GET request on the markedNotBlankRegions resource http://localhost:8090/iserver/manager/tileservice/jobs/7d59376f-f47a-405b-9862-41ac160b8f23/blankregions/markednot.rjson?scale=8.333333333333333e-7&fromIndex=0&toIndex=5 is as follows:
[
{
"blankRegionId": "e6f86b92-7718-4bb7-b4f3-ae85a22f51be",
"center": {
"x": 124.83790177425500,
"y": 58.238446162442900
},
"id": 0,
"markType": "VALID",
"parts": [5],
"points": [
{
"x": 124.4728264427890,
"y": 57.87337083097670
},
{
"x": 124.4728264427890,
"y": 58.60352149390910
},
{
"x": 125.20297710572100,
"y": 58.60352149390910
},
{
"x": 125.20297710572100,
"y": 57.87337083097670
},
{
"x": 124.4728264427890,
"y": 57.87337083097670
}
],
"style": null,
"type": "REGION"
},
{
"blankRegionId": "e12739b8-eef2-42c4-ae15-d0aa1586303b",
"center": {
"x": 33.5690689077115,
"y": -18.42737344545350
},
"id": 0,
"markType": "VALID",
"parts": [81],
"points": [
{
"x": 39.77534954263640,
"y": -12.22109281052860
},
{
"x": 39.77534954263640,
"y": -12.951243473460900
},
{
"x": 39.77534954263640,
"y": -13.681394136393300
},
{
"x": 40.505500205568800,
"y": -13.681394136393300
},
{
"x": 34.664294902110000,
"y": -16.601996788122700
},
{
"x": 34.664294902110000,
"y": -17.332147451055000
},
{
"x": 35.39444556504240,
"y": -17.332147451055000
},
{
"x": 39.77534954263640,
"y": -11.490942147596200
},
{
"x": 39.77534954263640,
"y": -12.22109281052860
}
],
"style": null,
"type": "REGION"
}
]
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 markedNotBlankRegions resource exists, or if the markedNotBlankRegions resource can be accessed by clients. It can also determine if the markedNotBlankRegions resource supports an output format <format> if performed on a URI with .<format> included.