tileJobs


URI

<tileService_uri>/jobs[.<format>]

支持的方法

GETPOSTHEAD

父资源

tileService

子资源

tileJob

介绍

分布式缓存的入口资源,支持创建新的切图任务。

支持的方法:

支持的表述格式:rjson、json、html、xml。

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/manager/tileservice/jobs.rjson

GET 请求

获取切图任务列表。

响应结构

返回切图任务列表,包括每个切图任务的信息。 单个切图任务的主要信息有:

字段 类型 说明
id String 切图任务 ID。
state JobState 切图任务当前的工作状态。
info JobInfo 切图任务的基本信息。

响应示例

对 tileJobs 资源:http://localhost:8090/iserver/manager/tileservice/jobs.rjson 执行 GET 请求,返回切图任务列表,rjson 格式的响应结果如下:

POST 请求

创建新的切图任务。

请求参数

请求体参数结构如下:

名称 类型 含义
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

HEAD 请求

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

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

请参见