blankRegions

URI

<tileJob uri>/blankregions[.<format>]

支持的方法

GET、PUT、HEAD

父资源

tileJob

子资源

markedBlankRegions、markedNotBlankRegions、unmarkedBlankRegions、allBlankRegions、retileJob

介绍

指定切图任务的白图统计信息，包括每个比例尺的白图信息集，例如当前指定比例尺的白图区域数量，已标记为白图区域的数量，已标记为正常区域的数量以及待处理的数量等。可以通过发送 PUT 请求，更新指定切图任务的白图统计信息。

支持的方法：

支持的表述格式：（rjson、json、html、xml）。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://localhost:8090/iserver/manager/tileservice/jobs/1dc385d1-a821-448e-8ac8-0a168a73e509/blankregions.rjson

GET 请求

获取指定切图任务的白图统计信息。请求参数必须放在 URI 中。

请求参数

名称 类型 含义
scale double 【必选参数】
地图的显示比例尺。

响应结构

对 blankRegions 资源执行 GET 请求，返回操作结果的表述如下：

字段 类型 说明
currentScaleCount int 当前比例尺的白图区域数量。
markedNormal int 已经标记为正常区域的数量。
markedReTile int 已经标记为需要重切的白图区域的数量。
marking int 用户还没处理需要标记的数量。
scaleDenominator double 当前的比例尺分母。
total int 白图区域数量总计。

响应示例

对 blankRegions 资源：http://localhost:8090/iserver/manager/tileservice/jobs/1dc385d1-a821-448e-8ac8-0a168a73e509/blankregions.rjson?scale=8.333333333333333e-7执行 GET 请求，返回的 rjson 格式的资源描述如下：

{

    "currentScaleCount": 1946,

    "markedNormal": 0,

    "markedReTile": 0,

    "marking": 1946,

    "scaleDenominator": 1200000,

    "total": 1946

}

PUT 请求

更新指定缓存任务的白图统计信息。

请求参数

请求体中传递参数如下所示：

字段 类型 说明
invalidRegionIds String[] 标记为错误的需要重切的白图区域 id 数组。
validRegionIds String[] 标记为正确的不需要需要重切的白图区域 id 数组。
noneRegionIds String[] 没有标记的白图区域 id 数组。

 

响应结构

对  blankRegions 资源执行 PUT 请求，返回的操作结果表述的结构如下（表述在响应消息的实体主体里）：

字段 类型 说明
succeed boolean 更新当前切图任务的白图统计信息是否成功。

 

示例

当对  blankRegions 资源：http://localhost:8090/iserver/manager/tileservice/jobs/1dc385d1-a821-448e-8ac8-0a168a73e509/blankregions.rjson?scale=8.333333333333333e-7 执行 put 请求时，更新当前切图任务的白图统计信息，这时传入以下参数：

{

    "invalidRegionIds": ["7c6c8537-12f1-42e4-93a4-30ed0814100a", "0cd3e6e0-96a3-49aa-a53e-15ba887af611"],

    "validRegionIds": ["c8f52a39-32f7-4753-9426-be66995495d9", "d66d299f-ba7b-47eb-a3a4-1c063351c18a", "e49ed74d-87dc-4e62-b8dd-8bf2c85f70e6"],

    "noneRegionIds": ["1d161fe0-50a0-441a-a594-835b1af93a64"]

}

则返回 rjson 格式的操作结果表述如下：

{"succeed": true}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 blankRegions 资源是否存在，或者客户端是否有权限访问 blankRegions 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 blankRegions 资源是否支持<format>格式的表述。

请参见