zxyTileImage

URI

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

支持的方法

GET、HEAD

父资源

map

介绍

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

支持的方法：

支持的表述格式：PNG、BMP、GIF、JPG、RJSON、JSON、HTML、XML。

资源层次

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 像素。

响应结构

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

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

字段 类型 说明
lastModified long 地图上次修改时间。
imageUrl String 指向地图图片的 URI，图片为 PNG 格式。
mapParam MapParameter 地图参数。

响应示例

执行 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 格式的图片如下所示。

HEAD 请求

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

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

请参见