<tileService_uri>/jobs[.<format>]
分布式缓存的入口资源,支持创建新的切图任务。
支持的方法:
支持的表述格式:rjson、json、html、xml。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/manager/tileservice/jobs.rjson
获取切图任务列表。
返回切图任务列表,包括每个切图任务的信息。 单个切图任务的主要信息有:
字段 | 类型 | 说明 |
id | String | 切图任务 ID。 |
state | JobState | 切图任务当前的工作状态。 |
info | JobInfo | 切图任务的基本信息。 |
对 tileJobs 资源:http://localhost:8090/iserver/manager/tileservice/jobs.rjson 执行 GET 请求,返回切图任务列表,rjson 格式的响应结果如下:
创建新的切图任务。
请求体参数结构如下:
名称 | 类型 | 含义 |
dataConnectionString | String | 待切图数据的连接信息,支持直接传入服务组件名,如"map-china400"。 |
mapName | String | 待切图的地图名称。 |
tileSize | TileSize | 缓存图片大小,默认为“SIZE_256”。 |
format | OutputFormat | 缓存图片格式,如“PNG”。 |
transparent | boolean | 图片是否透明,默认为 false。 |
scaleDenominators | double[] | 切图比例尺分母集合,如 ["1000000", "2000000"]。 |
originalPoint | Point2D | 切图索引的起始,计算瓦片行列号的起始坐标点,默认为地图左上角。 |
epsgCode | int | 切图的坐标系,不指定时默认使用原地图的坐标系。 |
cacheBounds | Rectangle2D | 缓存切图范围,如[0,0,180,90],可以不指定,默认为地图全幅范围。 |
storageID | String | 存储配置的 ID。 |
storeConfig | TileSourceInfo | 瓦片存储配置。 |
createNewTileVersion | boolean | 是否新建切片版本。 |
parentTileVersion | String | 待新建切片版本的父版本,null 表示基于最后一个更新版本进行新建版本。 |
tileType | tileType | 切片类型。 |
utfGridParameter | UTFGridJobParameter | 属性切片配置参数。当切片类型为 UTFGrid 时,该参数才生效。 |
vectorParameter | VectorJobParameter | 矢量切片配置参数。当切片类型为 Vector 时,该参数才生效。 |
scheduledTimeRanges | List<String> | 设置可定时切图的时间段 ,如:["16:08:00-16:09:00","16:11:00-16:12:00"] |
字段 | 类型 | 说明 |
succeed | String | 切图是否成功。 |
newResourceID | String | 创建的切图任务资源的 ID。 |
customResult | TileJob | 创建的切图任务资源的相关信息。 |
newResourceLocation | String | 创建的切图任务资源地址。 |
postResultType | enum | POST 请求的结果类型。"CreateChild"类型指的是创建子资源。 |
创建一个新的切图任务,即对 http://localhost:8090/iserver/manager/tileservice/jobs.rjson 执行 POST 请求,rjson 格式请求体如下
{
"dataConnectionString":"map-China400",
"mapName":"China",
"transparent":false,
"scaleDenominators":["250000000", "125000000", "64000000", "32000000", "16000000", "8000000", "4000000"],
"cacheBounds":{
"left":"-20037508.342789244",
"bottom":"-20037508.34278914",
"right":"20037508.342789244",
"top":"20037508.342789095"
},
"storeConfig":{
"outputPath":"D:/code/dev/master/etc/iserver-debug/src/test/resources/iserver/output/cache/05291",
"type":"UGCV5",
"storageType":"Original"
},
"tilesetName":"China",
"originalPoint":{
"x":"-20037508.342789244",
"y":"20037508.342789095"
},
"epsgCode":-1,
"tileType":"Image",
"format":"WEBP",
"tileSize":"SIZE_256",
"compressionQuality":"0.75",
"dataPreProcessInfo":{
"rowCount":"50",
"columnCount":"50"
},
"convertToPng8":true,
"autoAvoidEffectEnabled":true,
"useLocal":true,
"scheduledTimeRanges":["0:00:00-8:00:00"]
}
则返回的 rjson 格式响应结果如下:
{
"customResult":{
"id":"5d6e3487-1bfc-4b38-a03f-f160a63742dc",
"state":null,
"targetTilesetInfo":{"name":"UGCV5_tileset_China"},
"info":{
"originalPoint":{
"x":-2.0037508342789244E7,
"y":2.0037508342789095E7
},
"fileVerificationMode":"FILESIZE",
"cacheRegions":null,
"utfGridParameter":null,
"resolutions":[
66145.83333333331,
33072.91666666666,
16933.333333333332,
8466.666666666666,
4233.333333333333,
2116.6666666666665,
1058.3333333333333
],
"dataConnectionString":"<?xml version="1.0" encoding="UTF-8"?>
<MapCompConnInfo>
<name>map-China400</name>
<providerConnectionInfos> <com.supermap.services.components.commontypes.ProviderConnInfo>
<name>map-China400</name>
<config class="com.supermap.services.providers.UGCMapProviderSetting">
<cacheVersion>5.0<cacheVersion> <workspacePath>E:/work/data/data/China400/China400.smwu</workspacePath>
<layerCountPerDataType>0</layerCountPerDataType>
<multiThread>true</multiThread>
<poolSize>0</poolSize>
<ugcMapSettings/>
<useCompactCache>false</useCompactCache>
<extractCacheToFile>true</extractCacheToFile>
<queryExpectCount>1000</queryExpectCount>
<ignoreHashcodeWhenUseCache>false</ignoreHashcodeWhenUseCache>
<cacheDisabled>false</cacheDisabled>
<isMultiInstance>false</isMultiInstance>
<inflatDisabled>false</inflatDisabled>
<mapEditable>false</mapEditable>
<dpi>96.0</dpi>
</config>
<type>com.supermap.services.providers.UGCMapProvider</type>
</com.supermap.services.components.commontypes.ProviderConnInfo>
</providerConnectionInfos>
<config>
<useCache>false</useCache>
<useUTFGridCache>false</useUTFGridCache>
<useVectorTileCache>false</useVectorTileCache>
<expired>0</expired>
<cacheReadOnly>false</cacheReadOnly>
</config>
</MapCompConnInfo>",
"transparent":false,
"tileVersionDescription":null,
"realspaceParameter":null,
"createStandardMBTiles":false,
"epsgCode":3857,
"createNewTileVersion":false,
"mapName":"China",
"tilesetName":"China",
"convertToPng8":true,
"refMapRestAdress":null,
"scaleDenominators":[
250000000,
125000000,
640000000,
32000000,
16000000,
8000000,
4000000
],
"cacheVersion":null,
"parentTileVersion":null,
"format":"WEBP",
"cacheBounds":{
"top":2.0037508342789095E7,
"left":-2.0037508342789244E7,
"bottom":-2.003750834278914E7,
"leftBottom":{
"x":-2.0037508342789244E7,
"y":-2.003750834278914E7
},
"right":2.0037508342789244E7,
"rightTop":{
"x":2.0037508342789244E7,
"y":2.0037508342789095E7
}
},
"storeConfig":{
"innerTileSourceInfo":{
"outputPath":"D:/code/dev/master/etc/iserver-debug/src/test/resources/iserver/output/cache/05291",
"s3ConnectionInfo":null,
"storageType":"Original",
" type":"UGCV5",
"datastoreType":"TILES"
},
"tileStorageServers":[],
"type":"Remote",
"datastoreType":"TILES",
"token":"super123."
},
"dataPreProcessInfo":{
"rowCount":50,
"columnCount":50
},
"actualTileVersion":null,
"taskAssignmentType":"DEFAULT",
"scheduledTimeRanges":["0:00:00-8:00:00"],
"tileType":"Image",
"autoAvoidEffectEnabled":true,
"useLocal":true,
"tileSize":"SIZE_256",
"compressionQuality":0.75,
"storageType":null,
"vectorBounds":null,"vectorParameter":null
}
},
"newResourceID":"5d6e3487-1bfc-4b38-a03f-f160a63742dc",
"newResourceLocation":"http://172.16.120.153:8099/iserver/manager/tileservice/jobs/5d6e3487-1bfc-4b38-a03f-f160a63742dc.json",
"postResultType":"CreateChild",
"succeed":true
}
访问生成的子资源地址 http://localhost:8090/iserver/manager/tileservice/jobs/5d6e3487-1bfc-4b38-a03f-f160a63742dc,即可查看创建的切图任务的状态详见tileJob。
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 tileJobs 资源是否存在,或者客户端是否有权限访问 tileJobs 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 tileJobs 资源是否支持<format>格式的表述。