unmarkedBlankRegions


URI

<blankRegions uri>/unmarked[.<format>]

Supported methods

GET, HEAD

Parent resource

blankRegions

Introduction

Lists all unmarked blank region information list of the specified tile task.

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/manager/tileservice/jobs/7d59376f-f47a-405b-9862-41ac160b8f23/blankregions/unmarked.rjson

GET request

Gets all unmarked blank 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 unmarkedBlankRegions resource to return the BlankRegion[] field indicating the list of all unmarked blank regions, the structure of the BlankRegion[] field is as follows:

Field Type Description
blankRegionId String The ID of the unmarked blank 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. NONE indicates the blank region is unmarked.
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 unmarkedBlankRegions resource http://localhost:8090/iserver/manager/tileservice/jobs/7d59376f-f47a-405b-9862-41ac160b8f23/blankregions/unmarked.rjson?scale=8.333333333333333e-7&fromIndex=0&toIndex=5 is as follows:

[

    {

        "blankRegionId": "3c515bd2-2452-44e1-9d5e-2dca0dfccfbd",

        "center": {

            "x": 34.29921957064380,

            "y": -67.34746786192080

        },

        "id": 0,

        "markType": "NONE",

        "parts": [5],

        "points": [

            {

                "x": 33.93414423917770,

                "y": -67.71254319338690

            },

            {

                "x": 33.93414423917770,

                "y": -66.9823925304546

            },

            {

                "x": 34.664294902110000,

                "y": -66.9823925304546

            },

            {

                "x": 34.664294902110000,

                "y": -67.71254319338690

            },

            {

                "x": 33.93414423917770,

                "y": -67.71254319338690

            }

        ],

        "style": null,

        "type": "REGION"

    },

    {

        "blankRegionId": "e6f86b92-7718-4bb7-b4f3-ae85a22f51be",

        "center": {

            "x": 124.83790177425500,

            "y": 58.238446162442900

        },

        "id": 0,

        "markType": "NONE",

        "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"

    }

]

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 unmarkedBlankRegions resource exists, or if the unmarkedBlankRegions resource can be accessed by clients. It can also determine if the unmarkedBlankRegions resource supports an output format <format> if performed on a URI with .<format> included.

See