zxyTileImage


URI

  1. <map_uri>/zxyTileImage[.<format>]
  2. <map_uri>/zxyTileImage/z/x/y.[.<format>]

支持的方法

GETHEAD

父资源

map

介绍

将完整的地图图片以像素为单位切割成多个相同大小的格网,那么地图就可以由多个小块拼合而成。zxyTileImage 资源就表示以 ZXY 规范划分的地图的小块。详细请参考:ZXY标准地图瓦片

支持的方法:

支持的表述格式:PNG、BMP、GIF、JPG、WebP、RJSON、JSON、HTML、XML、JSONP、FASTJSON。

资源层次

HTTP 请求方法

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

  1. http://supermapiserver:8090/iserver/services/map-China400/rest/maps/China/zxyTileImage.png

  2. http://supermapiserver:8090/iserver/services/map-China400/rest/maps/China/zxyTileImage/0/0/0.png

GET 请求

获取地图的格网图片,URI 中的参数确定了格网的位置等信息。

请求参数

对 zxyTileImage 资源执行 GET 请求,获取地图的格网图片,需要在 URI 中包含相关参数,如果没有指定参数,则会按照地图的当前状态为准,进行切割和出图。参数如下所示:

名称 类型 含义
z int 地图缩放级别。
x long 格网在地图中列号,从左向右递增。默认情况下,切片从地图最左上角开始,其格网列号为0。
y long 格网在地图中行号,从上向下递增。默认情况下,切片从地图最左上角开始,其格网行号为0。
width int 格网的宽度,单位是像素,默认为 256 像素。
height int 格网的高度,单位是像素,默认为 256 像素。
rasterfunction RasterFunctionParameter 栅格运算。仅支持请求栅格瓦片。
当前支持NDVI、HILLSHADE两种运算。可参见响应示例2
  1. NDVI 即 近红外区与红光区的反射率差值/近红外区与红光区的反射率和值。可用于反应出植物冠层的背景影响。参数使用时,可参照NDVI参数构成
  2. HILLSHADE 即 山体阴影,通过考虑照明源的角度和阴影,根据表面栅格创建地貌晕渲。参数使用时,可参照HILLSHADE参数构成
layersID String 获取进行切片的地图图层 ID,即指定进行地图切片的图层,可以是临时图层集,也可以是当前地图中图层的组合。如果此参数缺省则对全部图层进行切片。
layersID 可以是临时图层创建时 templayers 的 ID,如 layersID=382139acf0,也可以是当前地图中的某些图层的 ID 编号。
其中,当前地图图层 ID 的定义规则如下:
1. 各级图层按照图层顺序自上而下从0开始编号;
2. 冒号(:)前为顶级图层;
3. 英文句号(.)表示其他各级图层间的从属关系;
4. 英文逗号(,)表示图层间的分隔。
例如:
1. [0:0,1,2.0]表示顶级图层0下面的子图层:0、1及其下属所有子图层,和2下的子图层0;
2. [1:1.2,2]表示顶级级图层1下面的子图层:1下的子图层2,和图层2及其下属所有子图层;
3. 两个示例合并在一起则是:[0:0,1,2.0,1:1.2,2]
此外,[0,1,2,3]表示顶级图层0下面的图层0、1、2、3及所有子图层,[0:,1:,2:]表示顶级图层0、1、2及其所有子图层。
transparent boolean 格网图片是否透明。

响应结构

如果直接获取地图图片,可指定表述格式为 PNG、BMP、GIF 、WebP 或 JPG,则返回一幅图片。

如果获取地图图片信息,可指定表述格式为 RJSON、JSON、HTML 或 XML,则返回的表述结构如下:

字段 类型 说明
lastModified long 地图上次修改时间。
imageUrl String 指向地图图片的 URI,图片为 PNG 格式。
mapParam MapParameter 地图参数。
customResponse String 自定义处理结果
image BufferedImage 地图图片对应的 BufferedImage 对象。
imageData byte[] 地图图片对应的二进制流。

响应示例1

执行 GET 请求:http://supermapiserver:8090/iserver/services/map-China400/rest/maps/China/zxyTileImage.png?z=6&x=52&y=24&width=256&height=256,或http://supermapiserver:8090/iserver/services/map-China400/rest/maps/China/zxyTileImage/6/52/24.png?width=256&height=256,则返回 PNG 格式的图片如下所示。

响应示例2

执行 GET 请求:http:///supermapiserver:8090/iserver/services/map-test/rest/maps/map1/zxyTileImage.png?z=0&x=0&y=0&width=256&height=256,返回的是 PNG 格式的图片,如下表左图所示。

对上述 zxyTileImage 资源请求进行NDVI分析后的图片,即执行 GET 请求:http:///supermapiserver:8090/iserver/services/map-test/rest/maps/map1/zxyTileImage.png?z=0&x=0&y=0&width=256&height=256&rasterfunction={%22type%22:%22NDVI%22,%22redIndex%22:0,%22nirIndex%22:2},如下表右图所示。

上述 zxyTileImage 资源请求进行HILLSHADE析后的图片,即执行 GET 请求:http:///supermapiserver:8090/iserver/services/map-test/rest/maps/map1/zxyTileImage.png?z=0&x=0&y=0&width=256&height=256&rasterfunction={%22type%22:%22HILLSHADE%22,%22altitude%22:75,%22azimuth%22:120,%22zFactor%22:1.0},如下表右图所示。

响应示例2

执行 GET 请求:http://supermapiserver:8090/iserver/services/map-Jingjin/rest/maps/京津地区地图/zxyTileImage/8/210/98.png?transparent=true,则返回 PNG 格式的图片如下所示。

HEAD 请求

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

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

请参见