地图瓦片(zxyTileImage)

POST

/rest/services/{servicename}/map/zxyTileImage

获取zxy规范的地图格网图片。默认返回的地图图片的格式是 PNG。

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

**支持的表述格式：**PNG、BMP、GIF、JPG、WebP。
{BaseURL}/zxytileimage
{BaseURL}/zxyTileImage/6/52/24.png?width=256&height=256
目前只有3857的地图调用此接口能出图，需要修复4326调用此接口也应出图。

支持读取ZXY规范的地图瓦片，可对接 OpenStreetMap 等互联网的瓦地图服务。ZXY规范的地图瓦片规则如下：将地图全幅显示时的图片从左上角开始，往下和往右进行切割，切割的大小默认为 256*256 像素，左上角的格网行号为 0，列号为 0，往下和往右依次递增。如下图所示： tile_divide

)

ZXY规范的地图瓦片仅支持 Web Mercator 坐标系(即 PCS_WGS_1984_WORLD_MERCATOR ，EPSG Code：3857)下的固定比例尺集合，如表1所示，这种比例尺定义的初始化显示级别0中包含了1张覆盖全球的256*256大小的切片，并且定义原点坐标为（-20037508.34,20037508.34），即全球范围的左上角。

表1 zxyTileImage 资源各显示级别参数列表

显示级别	地图宽高 (像素)	切片数量	地面分辨率(米 / 像素)	地图比例尺(96 dpi)
0	256	1	156543.033928	1:591658710.909131
1	512	4	78271.516964	1:295829355.454566
2	1024	16	39135.758482	1:147914677.727283
3	2048	64	19567.879241	1:73957338.863641
4	4096	256	9783.939621	1:36978669.431821
5	8192	1024	4891.969810	1:18489334.715910
6	16384	4096	2445.984905	1:9244667.357955
7	32768	16384	1222.992453	1:4622333.678978
8	65536	65536	611.496226	1:2311166.839489
9	131072	262144	305.748113	1:1155583.419744
10	262144	1048576	152.874057	1:577791.709872
11	524288	4194304	76.437028	1:288895.854936
12	1048576	16777216	38.218514	1:144447.927468
13	2097152	67108864	19.109257	1:72223.963734
14	4194304	268435456	9.554629	1:36111.981867
15	8388608	1073741824	4.777314	1:18055.990934
16	16777216	4294967296	2.388657	1:9027.995467
17	33554432	17179869184	1.194329	1:4513.997733
18	67108864	68719476736	0.597164	1:2256.998867
19	134217728	274877906944	0.298582	1:1128.499433
20	268435456	1099511627776	0.149291	1:564.249717
21	536870912	4398046511104	0.074646	1:282.124858
22	1073741824	17592186044416	0.037323	1:141.062429
23	2147483648	70368744177664	0.0186615	1:70.5312145

请求参数

Path 参数

servicename

string

服务名称

必需

Body 参数application/json

layerNames

array[string]

可选

图层名称数组，如果不设置，则获取全部图层的信息

layerIds

array[string]

可选

图层id。和layerName效果一致，需要具有唯一性。优先级高于layerName

dynamicLayers

object

可选

具体参见【DynamicLayers】 DynamicLayers通过指定临时图层渲染及数据源信息（此种方式图层出图后立即释放）。备注：此信息和layerIds、layerNames互斥，且优先级高于其他layer标识。（此标签内部存储内容可以为base64编码字符串）

encparam

string

可选

海图显示控制参数，具体参见 “海图显示参数结构定义” 海图显示参数结构定义

integer

地图缩放级别。

必需

number

必需

格网在地图中列号，从左向右递增。默认情况下，切片从地图最左上角开始，其格网列号为0。

number

必需

格网在地图中行号，从上向下递增。默认情况下，切片从地图最左上角开始，其格网行号为0。

width

integer

可选

指定用户显示视窗的宽度，即产生图片的宽度。必须跟 height 一起使用，优先级高于 viewer。默认为 256。

height

integer

可选

指定用户显示视窗的高度，即产生图片的高度。必须跟 width 一起使用，优先级高于 viewer。默认为 256。

transparent

boolean

可选

地图图片是否透明。默认false，背景不透明。

antialias

boolean

可选

是否反锯齿出图。底层是否支持？

backgroundColor

object

可选

具体参见 “颜色参数” color颜色参数地图的背景色，支持#FFFFFFFF格式（通道顺序底层确认，例如ARGB），以及 { "blue": 255, "green": 255, "red": 255，“alpha”:255}。

dpi

integer

可选

地图显示的dpi，默认96。

showLabel

boolean

可选

是否显示标注，默认true。

rasterfunction

object

可选

底层是否支持？（可选实现） 栅格运算。仅支持请求栅格瓦片。当前支持NDVI、HILLSHADE两种运算。可参见示例2。NDVI 即近红外区与红光区的反射率差值/近红外区与红光区的反射率和值。可用于反应出植物冠层的背景影响。参数使用时，可参照NDVI参数构成
{
"type":"NDVI",//类型
"redIndex":0,//红光谱波段索引
"nirIndex":2 //近红外光谱波段索引
}
HILLSHADE 即山体阴影，

{
"type":"HILLSHADE",//类型
"altitude":75,//（可选）高于地平线的光源高度角。高度角由正度数表示，0 度代表地平线，而 90 度代表头顶正上方。默认值为 45 度。
"azimuth":120,//（可选）光源的方位角方位角由0到360度之间的正度数表示，以北为基准方向按顺时针进行测量默认值为 315 度。
"zFactor":1.0 //（可选）一个表面 z 单位中地面 x,y 单位的数量。z 单位与输入表面的 x,y 单位不同时，可使用 z 因子调整 z 单位的测量单位。计算最终输出表面时，将用 z 因子乘以输入表面的 z 值。如果 x,y 单位和 z 单位采用相同的测量单位，则 z 因子为 1。这是默认设置。如果 x,y 单位和 z 单位采用不同的测量单位，则必须将 z 因子设置为适当的因子，否则会得到错误的结果。例如，如果 z 单位是英尺而 x,y 单位是米，则应使用 z 因子 0.3048 将 z 单位从英尺转换为米（1 英尺 = 0.3048 米）。如果输入栅格位于球面坐标系中（如十进制度球面坐标系），则生成的山体阴影可能看起来很独特。这是因为水平地面单位与高程 z 单位之间的测量值存在差异。由于经度的长度随着纬度而变化，因此需要为该纬度指定一个适当的 z 因子。如果 x,y 单位是十进制度而 Z 单位是米，特定纬度的一些合适的 Z 因子为：Latitude Z-factor 0 0.00000898 10 0.00000912 20 0.00000956 30 0.00001036 40 0.00001171 50 0.00001395 60 0.00001792 70 0.00002619 80 0.00005156
}通过考虑照明源的角度和阴影，根据表面栅格创建地貌晕渲。参数使用时，可参照HILLSHADE参数构成

customParams

string

可选

自定义定义参数。可以是任何形式组织的字符串。用户可以通过该属性传入自定义的参数。（可选实现，动态专题图实现考虑）

format

string

可选

图片格式，支持PNG、BMP、GIF、JPG、WebP,默认PNG,不区分大小写

mask

object (Mask定义（掩码定义）)

可选

数据显示的掩码区域，主要用于控制显示的范围（包括裁剪范围等）

method

string

可选

允许的值:inside、outside。 inside：遮罩内部区域 outside：遮罩外部区域。缺省值为:outside

polygon

object

必需

几何图形对象，必须为封闭的polygon类型

geoSRS

string

可选

空间参考字符串，参考通用参数中的空间参考格式

cache

boolean

可选

是否缓存响应图片文件，默认缓存，true，用户加速在此访问性能

默认值:

true

updatecache

boolean

可选

cache为true是，如果缓存已经存在是否更新缓存。默认为fasle

默认值:

false

示例

{
  "width": 256,
  "height": 256,
  "z": 6,
  "transparent": false,
  "x": 52,
  "y": 24
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/rest/services//map/zxyTileImage' \
--header 'Content-Type: application/json' \
--data-raw '{
    "width": 256,
    "height": 256,
    "z": 6,
    "transparent": false,
    "x": 52,
    "y": 24
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

成功示例失败返回

如果直接获取地图图片，指定格式为 PNG、BMP、GIF、WebP  或 JPG，则返回一幅图片内存

修改于 2024-08-09 03:36:55

地图瓦片(tileImage)

地图全幅图片(entireImage)