瓦片地图服务

瓦片地图服务提供地图浏览服务接口，支持OGC标准的WMTS服务接口。支持以下服务接口：

• 请求服务的元数据
• 请求地图服务
• 请求关于地图要素的信息

瓦片地图服务的数据源支持MongoDB、Oracle、MBTiles和本地文件，其中本地瓦片包括MBTiles、国标离散瓦片、以及ArcGIS离散型瓦片和紧凑型瓦片。

瓦片服务元信息

URL模板	/{serviceName}/tile
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的瓦片服务名称

URL示例

http://192.98.105.254:8080/ime-server/rest/testwmts/tile (opens new window)

XYZ形式获取瓦片

URL模板	/{serviceName}/tile/data
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的瓦片服务名称
col	是	无	瓦片所在列，对应对应col
row	是	无	瓦片所在行，对应row
level	是	无	瓦片所在级别

URL 示例

http://192.98.105.254:8080/ime-server/rest/testwmts/tile/data?level=0&row=0&col=0 (opens new window)

WMTS GetCapabilities KVP接口

URL模板	/{serviceName}/wmts
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
request	是	无	固定为GetCapabilities
service	是	无	固定为wmts
version	否	1.0.0	版本

URL 示例

http://192.98.105.254:8080/ime-server/rest/testwmts/wmts?request=GetCapabilities&service=wmts (opens new window)

WMTS GetTile KVP接口

URL模板	/{serviceName}/wmts
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
request	是	无	固定为GetTile
service	是	无	固定为wmts
tilematrixSet	是	无
tilematrix	是	无
tilerow	是	无
tilecol	是	无
format	是	无
version	否	1.0.0	版本

URL 示例

http://192.98.105.254:8080/ime-server/rest/testwmts/wmts?request=GetTile&service=wmts&tilematrixSet=db200w&tileMatrix=2&tilerow=1&tilecol=3 (opens new window)

获取当前范围内瓦片服务的所有版本

URL模板	/{serviceName}/wmts/version
HTTP请求类型	Get
是否支持jsonp	是

参数说明

参数	是否必须	默认值	参数说明
format	否	json	结果返回格式，json或xml
callback	否	无	fomat为json时，指定callback返回jsonp
xmin	否	无	范围最小x
ymin	否	无	范围最小y
xmax	否	无	范围最大x
ymax	否	无	范围最大y

URL 示例

http://192.98.105.254:8080/ime-server/rest/testwmts/version (opens new window)

WMTS GetCapabilities KVP接口带版本信息

URL模板	/{serviceName}/{tileversion}/wmts
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
tileversion	是	无	瓦片版本时间
request	是	无	固定为GetCapabilities
service	是	无	固定为wmts
version	否	1.0.0	版本

URL 示例

http://192.98.105.254:8080/ime-server/rest/testwmts/wmts?request=GetCapabilities&service=wmts (opens new window)

WMTS GetTile KVP接口带版本信息

URL模板	/{serviceName}/{tileversion}/wmts
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
tileversion	是	无	瓦片版本时间
request	是	无	固定为GetTile
service	是	无	固定为wmts
tilematrixSet	是	无
tilematrix	是	无
tilerow	是	无
tilecol	是	无
format	是	无
version	否	1.0.0	版本

URL 示例

http://192.98.105.254:8080/ime-server/rest/testwmts/wmts?request=GetTile&service=wmts&tilematrixSet=db200w&tileMatrix=2&tilerow=1&tilecol=3 (opens new window)

export导出大图

URL模板	/{serviceName}/wmts/export
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
bbox	是	无	地图导出地理范围，格式 xmin,ymin,xmax,ymax
width	是	无	地图导出宽度
height	是	无	地图导出高度

URL 示例

http://192.98.105.254:8080/ime-server/rest/testwmts/wmts/export?bbox=102,35,103,36&width=1024&height=768 (opens new window)

影像地图服务

影像地图服务提供地图浏览服务接口，支持OGC标准的WMTS和WMS服务接口。支持以下服务接口：

• 请求服务的元数据
• 请求地图瓦片
• 请求关于地图要素的信息
• 请求地图图像

影像地图服务的数据源是影像镶嵌数据集，存储格式支持Oracle、Postgresql、SQLite数据库存储。

获取服务元数据

URL模板	/{serviceName}/dtile/map/info
HTTP请求类型	Get
是否支持jsonp	是

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
format	否	json	结果返回格式，json或xml
callback	否	无	fomat为json时，指定callback返回jsonp

URL示例

http://localhost:8084/ime-cloud/rest/GDEMV2_30M/dtile/map/info (opens new window)

XYZ形式获取瓦片

URL模板	/{serviceName}/dtile/map/data
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
col	是	无
row	是	无
level	是	无
tilesize	否	256	生成瓦片大小，默认256
style	否	无	影像渲染样式，目前支持下面4种： dem山体阴影 {"mode":"hillshade","Altidude":50,"Azimuth":210,"ZFactor":1} dem坡向 {"mode":"slope","UsePercent":"true","Scale":15} dem坡向 {"mode":"aspect","ZeroForFlat":"true"} dom波段组合 {"mode":"composite","ReadBandIndex":"2,0,1"}
code	否	无	影像所属区域编码，需在生成镶嵌数据集中写入该参数

URL 示例

http://localhost:8084/ime-cloud/rest/GDEMV2_30M/dtile/map/data?level=11&row=349&col=1638 (opens new window)

export导出大图

URL模板	/{serviceName}/dtile/map/export
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
bbox	是	无	地图导出地理范围，格式 xmin,ymin,xmax,ymax
width	是	无	地图导出宽度
height	是	无	地图导出高度
style	否	无	影像渲染样式，目前支持下面4种： dem山体阴影 {"mode":"hillshade","Altidude":50,"Azimuth":210,"ZFactor":1} dem坡向 {"mode":"slope","UsePercent":"true","Scale":15} dem坡向 {"mode":"aspect","ZeroForFlat":"true"} dom波段组合 {"mode":"composite","ReadBandIndex":"2,0,1"}
code	否	无	影像所属区域编码，需在生成镶嵌数据集中写入该参数

URL 示例

http://localhost:8084/ime-cloud/rest/GDEMV2_30M/dtile/map/export?bbox=109.3277,28.1677,111.7776,29.7704&width=800&height=600&style={%22mode%22:%22hillshade%22,%22Altidude%22:50,%22Azimuth%22:120,%22ZFactor%22:3} (opens new window)

WMTS KVP GetCapabilities

URL模板	/{serviceName}/dtile
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
request	是	无	固定为GetCapabilities
service	是	无	固定为wmts
version	否	1.0.0	版本

URL 示例

http://localhost:8084/ime-cloud/rest/GDEMV2_30M/dtile?request=GetCapabilities&service=wmts (opens new window)

WMTS KVP GetTile

URL模板	/{serviceName}/dtile
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
request	是	无	固定为GetTile
service	否	无	固定为wmts
tilematrixSet	否	无
tilematrix	是	无
tilerow	是	无
tilecol	是	无
format	否	无
version	否	1.0.0	版本

URL 示例

http://localhost:8084/ime-cloud/rest/GDEMV2_30M/dtile?request=GetTile&service=wmts&tilematrixSet=db200w&tileMatrix=2&tilerow=1&tilecol=3 (opens new window)

WMTS KVP GetCapabilities 512瓦片

URL模板	/{serviceName}/dtile/512
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
request	是	无	固定为GetCapabilities
service	是	无	固定为wmts
version	否	1.0.0	版本

URL 示例

http://localhost:8084/ime-cloud/rest/GDEMV2_30M/dtile?request=GetCapabilities&service=wmts (opens new window)

WMTS KVP GetTile 512瓦片

URL模板	/{serviceName}/dtile/512
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
request	是	无	固定为GetTile
service	否	无	固定为wmts
tilematrixSet	否	无
tilematrix	是	无
tilerow	是	无
tilecol	是	无
format	否	无
version	否	1.0.0	版本

URL 示例

http://localhost:8084/ime-cloud/rest/GDEMV2_30M/dtile?request=GetTile&service=wmts&tilematrixSet=db200w&tileMatrix=2&tilerow=1&tilecol=3 (opens new window)

地名地址服务

地名地址服务提供地名地址、POI、AOI的查询服务，支持OGC标准的WFS-G服务。支持以下服务接口：

• 实现关键字查询
• 获取关键字建议
• 基于关键字查询做矩形查询
• 基于关键字查询做缓冲查询
• 实现关键字区域分类统计
• 获取最近的地名地址/POI/AOI

地名地址服务的数据源支持SQLite、PostgreSQL和Oracle，用于发布地名地址服务的数据集是一张经过标准化处理的二维表，需要包含名称、类型、经度、纬度等必选字段，以及地址、电话、各级行政区代码等关键字段。

POI关键字查询

URL模板	/{serviceName}/place/search
HTTP请求类型	Get
是否支持jsonp	是

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
q	否	无	查询关键字，如果为空，查询所有
type	否	无	poi类型编码，如果为空，不指定类型
province	否	无	poi所在省编码
city	否	无	poi所在市编码
county	否	无	poi所在区县编码
page_num	否	0	分页数，起始值为0
page_size	否	10	每个分页的个数，默认为10
format	否	json	结果返回格式，json或xml
callback	否	无	fomat为json时，指定callback返回jsonp

URL示例

http://192.98.105.254:8080/ime-server/rest/beijing/place/search?q= (opens new window)万商大厦&type=10010&page_num=0&page_size=20&format=json&callback=callbackfunction

在关键字查询基础上做矩形查询

URL模板	/{serviceName}/place/search
HTTP请求类型	Get
是否支持jsonp	是

参数说明

参数	是否必须	默认值	参数说明
sq_type	是	无	sq_type固定为bounds
bounds	是	无	矩形的4至范围，逗号分隔，(ymin,xmin,ymax,xmax)

URL 示例

http://192.98.105.254:8080/ime-server/rest/beijing/place/search?sq_type=bounds&bounds=30,130,35,140&format=json&callback=callbackfunction (opens new window)

在关键字查询基础上做缓冲查询

URL模板	/{serviceName}/place/search
HTTP请求类型	Get
是否支持jsonp	是

参数说明

参数	是否必须	默认值	参数说明
sq_type	是	无	sq_type固定为buffer
location	是	无	中心点坐标，逗号分隔,(y,x)
radius	是	无	缓冲半径，单位为米

URL 示例

http://192.98.105.254:8080/ime-server/rest/beijing/place/search?sq_type=buffer&location=30,130&radius=500&format=json&callback=callbackfunction (opens new window)

POI关键字建议

URL模板	/{serviceName}/place/suggest
HTTP请求类型	Get
是否支持jsonp	是

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
q	否	无	查询关键字，如果为空，查询所有
type	否	无	poi类型编码，如果为空，不指定类型
province	否	无	poi所在省编码
city	否	无	poi所在市编码
county	否	无	poi所在区县编码
page_num	否	0	分页数，起始值为0
page_size	否	10	每个分页的个数，默认为10
format	否	json	结果返回格式，json或xml
callback	否	无	fomat为json时，指定callback返回jsonp

URL 示例

http://192.98.105.254:8080/ime-server/rest/beijing/place/search?q= (opens new window)万商大厦&type=10010&page_num=0&page_size=20&format=json&callback=callbackfunction

根据ID获取文档详情

URL模板	/{serviceName}/place/detail
HTTP请求类型	Get
是否支持jsonp	是

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
id	是	无	文档ID
format	否	json	结果返回格式，json或xml
callback	否	无	fomat为json时，指定callback返回jsonp

URL 示例

http://192.98.105.254:8080/ime-server/rest/beijing/place/search?id=beijing_7289&format=json&callback=callbackfunction (opens new window)

POI关键字区域分类统计

URL模板	/{serviceName}/place/statistic
HTTP请求类型	Get
是否支持jsonp	是

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
q	是	无	查询关键字
type	否	无	poi类型编码，如果为空，不指定类型
level	否	2	统计级别，1表示省，2表示市，3表示县，默认按照市分组
format	否	json	结果返回格式，json或xml
callback	否	无	fomat为json时，指定callback返回jsonp

URL 示例

http://192.98.105.254:8080/ime-server/rest/beijing/place/search?q= (opens new window)万商大厦&type=10010&page_num=0&page_size=20&format=json&callback=callbackfunction

获取最近的POI

URL模板	/{serviceName}/place/nearest
HTTP请求类型	Get
是否支持jsonp	是

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的服务名称，必须为英文
location	否	无	查询关键字，如果为空，查询所有
province	否	无	poi所在省编码
city	否	无	poi所在市编码
county	否	无	poi所在区县编码
format	否	json	结果返回格式，json或xml
callback	否	无	fomat为json时，指定callback返回jsonp

URL 示例

http://192.98.105.254:8080/ime-server/rest/beijing/place/nearest?location=24.39812119,111.55769105&format=json&callback=callbackfunction (opens new window)

三维地形服务

三维地形服务提供三维地形浏览服务，支持OGC标准的WMTS服务接口。 支持以下服务接口：

• 请求服务的元数据
• 请求地形瓦片
• 请求关于地形要素的信息

三维地形服务的数据源支持数据库（MongoDB）和本地文件（MBTiles）。三维地形瓦片数据由栅格图层组成的mxd配图文档切片生成。

获取服务元信息

URL模板	/{serviceName}/terrain
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的瓦片服务名称

URL 示例

http://172.16.67.34/ime-cloud/rest/globe_world_01_10_v2/tile (opens new window)

根据行列级别获取瓦片

URL模板	/{serviceName}/terrain/data
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的瓦片服务名称
col	是	无	瓦片所在列，对应col
row	是	无	瓦片所在行，对应row
level	是	无	瓦片所在级别

URL 示例

http://172.16.67.34/ime-cloud/rest/globe_world_01_10_v2/terrain/data?level=0&row=0&col=0 (opens new window)

获取坐标点的高程、坡度、坡向

URL模板	/{serviceName}/terrain/height
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的瓦片服务名称
coords	是	无	坐标点串，格式如下 x1,y1;x2,y2;x3,y3
surface	否	FALSE	是否获取坐标点的坡度坡向值，默认为否
level	是	无	地形级别

URL 示例

http://172.16.67.34/ime-cloud/rest/globe_world_01_10_v2/terrain/height?level=10&coords=100,25;105,30&surface=true (opens new window)

统计矩形范围的的最大高程、最小高程、平均高程

URL模板	/{serviceName}/terrain/statistic
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的瓦片服务名称
bbox	是	无	矩形范围 xmin,ymin,xmax,ymax
level	是	无	地形级别

URL 示例

http://172.16.67.34/ime-cloud/rest/globe_world_01_10_v2/terrain/statistic?level=10&bbox=100,25,105,30 (opens new window)

画线剖面分析，获取这条线上的高程、坡度、坡向

URL模板	/{serviceName}/terrain/profile
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的瓦片服务名称
wkt	是	无	绘制的线，LineString形式
tolerance	否	0.01	获取点间隔的容差
surface	否	FALSE	是否获取坐标点的坡度坡向值，默认为否
level	是	无	地形级别

URL 示例

[http://172.16.67.34/ime-cloud/rest/globe_world_01_10_v2/terrain/profile?level=10&polyline=LINESTRING(103](http://172.16.67.34/ime-cloud/rest/globe_world_01_10_v2/terrain/profile?level=10&polyline=LINESTRING(103) 30,103 27,105 27)&tolerance=0.01surface=true

对划定区域生成坡度坡向分析图

URL模板	/{serviceName}/terrain/analyst
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的瓦片服务名称
wkt	是	无	绘制的多边形，Polygon形式
width	是	无	生成的图片的宽度
level	是	无	地形级别
mode	否	all	分析类别 all，同时生成坡度坡向图 slope，只生成坡度分级设色图 aspect，只生成坡向箭头图

URL 示例

http://172.16.67.34/ime-cloud/rest/globe_world_01_10_v2/terrain/analyst?mode=all&width=1024&level=10&wkt=POLYGON((103%2030,105%2027,103%2027,103%2030)) (opens new window)

倾斜模型服务

倾斜模型服务采用基于WebGL的三维地图服务发布技术，支持海量三维精模、倾斜模型的快速加载，提供流畅的三维模型浏览体验。 支持以下服务接口：

• 请求服务的元数据

精细模型的数据源支持SQLite数据库存储，支持*.3ds、.3d、.obj等数据格式； 倾斜模型的数据源支持BDB数据库存储，支持PhotoScan（.obj），Smart3d (.osgb)，Pixel4D (.tif)等数据格式。

获取3dtiles瓦片数据集信息

URL模板	/{serviceName}/3dtiles/tileset.json
HTTP请求类型	Get
是否支持jsonp	否

参数说明

参数	是否必须	默认值	参数说明
serviceName	是	无	发布的瓦片服务名称

URL 示例

http://192.98.105.254:8066/ime-cloud/rest/testfuwu/3dtiles/tileset.json (opens new window)

矢量瓦片服务

后端底图瓦片服务

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/vmap/{severName}/getMAP?x={x}&y={y}&l={z}&styleId=style&ratio={r} (opens new window)&titlesize={titlesize}
服务描述	矢量瓦片地图服务接口根据应用终端发送的http协议请求，将对应地图的瓦片数据返回给用户终端的服务，其中返回的地图瓦片数据是被分割成相同大小如256x256像素的正方形栅格图片（非高清版）或512*512像素的正方形栅格图片（高清版，适用于高清屏和手机端）。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	x	瓦片行号	是
	y	瓦片列号	是
	l	瓦片层级	是
	tilesize	瓦片大小 256/512，默认为256	否
	ratio	是否高清，其中：1为非高清版本，2为高清版本，默认为1	否
	control	图层、要素的过滤、高亮设置，详情参见4.1	否
	mask	要素裁剪设置，详情参见4.2	否
	mask	按给定wkt范围裁剪要素并给剪半要素添加边框设置，详情参见4.3	否
返回值说明	返回地图瓦片png
请求示例	http://ditu.zjzwfw.gov.cn/mapserver/vmap/zjvmap/getMAP?x=13615&y=2761&l=14&styleId=tdt_biaozhunyangshi_2017&ratio=1 (opens new window)
V2.0到V3.0变更说明	1） V3.0的control参数中增加了参数：纹理透明度参数" textureOpacity": Number，详情参见4.1； 2） V3.0的control逻辑发生了变化，如果control里面指定了填充色，那么填充色按指定的颜色显示，没指定的项目，按照原有样式显示； 3） V3.0(NJ14V3.0.24)增加了mask参数：按给定wkt范围裁剪要素并给裁剪时减半要素添加边框设置，详细参见4.3； **注意****：**新增的mask参数与原来的mask参数不能同时使用，二者只能选择其一使用。
备注

前端底图数据服务

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/data/{severName}/getData?x={x}&y={y}&l={z}&styleId=style&ratio={r} (opens new window)&titlesize={titlesize}
服务描述	前端底图数据服务接口根据应用终端发送的http协议请求，将对应地图的底图数据返回给用户终端的服务；前端底图数据服务支持256和512的标准格网请求。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	x	瓦片行号	是
	y	瓦片列号	是
	l	瓦片层级	是
	tilesize	瓦片大小 256/512，默认为256	否
	ratio	是否高清，其中：1为非高清版本，2为高清版本，默认为1	否
返回值类型	json二进制压缩格式
返回值解析为json格式说明
请求示例	http://ditu.zjzwfw.gov.cn/mapserver/data/zjvmap/getData?x=13615&y=2761&l=14&styleId=tdt_biaozhunyangshi_2017&ratio=1
V2.0到V3.0变更说明	V3.0返回值类型变化，由原来V2.0的json格式变成json二进制压缩格式；
备注

前端注记数据服务

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/label/{severName}/getDatas?x={x}&y={y}&l={z} (opens new window) http://ditu.zjzwfw.gov.cn/mapserver/label/{severName}/getData?x={x}&y={y}&l={z} (opens new window)
服务描述	前端注记数据服务接口根据应用终端发送的http协议请求，将对应地图的注记数据返回给用户终端的服务；前端注记数据服务支持256和512的标准格网请求。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	x	瓦片行号	是
	y	瓦片列号	是
	l	瓦片层级	是
	tilesize	瓦片大小 256/512，默认为256	否
返回值类型	json二进制压缩格式
返回值解析为json格式说明
请求示例	http://ditu.zjzwfw.gov.cn/mapserver/label/zjvmap/getDatas?x=13615&y=2761&l=14&styleId=tdt_biaozhunyangshi_2017 (opens new window)
V2.0到V3.0变更说明	V3.0返回值类型变化，由原来V2.0的json格式变成json二进制压缩格式；
备注	接入第三方系统，需要产品提供sdk

后端注记瓦片服务

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/label/{severName}/getImg?x={x}&y={y}&l={z}&styleId={style}&ratio={r}&titlesize={titlesize}
服务描述	后端注记瓦片服务接口根据应用终端发送的http协议请求，将对应地图的注记瓦片返回给用户终端的服务；后端注记瓦片服务支持256和512的标准格网请求。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	x	瓦片行号	是
	y	瓦片列号	是
	l	瓦片层级	是
	tilesize	瓦片大小 256/512，默认为256	否
	ratio	是否高清，其中：1为非高清版本，2为高清版本，默认为1	否
	control	图层、要素的过滤、无注记高亮设置，详情参见4.1	否
	mask	要素裁剪设置，详情参见4.2	否
	mask	按给定wkt范围裁剪注记并给剪半注记添加边框设置，详情参见4.3	否
返回值说明	返回地图瓦片png
请求示例	http://ditu.zjzwfw.gov.cn/mapserver/label/zjvmap/getImg?x=13615&y=2761&l=14&styleId=tdt_biaozhunyangshi_2017&ratio=1
V2.0到V3.0变更说明	1） V3.0的control参数支持按日期过滤； 2） V3.0(NJ14V3.0.24)增加了mask参数：按给定wkt范围裁剪要素并给裁剪时减半要素添加边框设置，详细参见4.3； **注意：**新增的mask参数与原来的mask参数不能同时使用，二者只能选择其一使用。
备注

三维注记服务

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/label/{severName}/getImgData?x={x}&y={y}&l={z} (opens new window)
服务描述	三维注记服务接口根据应用终端发送的http协议请求，将对应地图的注记数据返回给用户终端的服务；三维注记服务支持512的标准格网请求。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	x	瓦片行号	是
	y	瓦片列号	是
	l	瓦片层级	是
	tilesize	瓦片大小512，默认为512	否
返回值类型	json格式
返回值说明
请求示例	http://ditu.zjzwfw.gov.cn/mapserver/label/poi/getImgData?x=13615&y=2761&l=14&styleId=p (opens new window)oi_hh&tilesize=512&ratio=2
V2.0到V3.0变更说明	V3.0新增接口
备注	1.只针对点注记，支持注记符号； 2.ratio=2时，width=1024；ratio=1时，width=512； 3.getImgData接口返回图片与getImg返回结果有所不同，getImg返回的是经过第一、二次过滤+避让计算的结果；getImgData返回的是经过第一、二次过滤的结果（即没有设置避让计算的结果）；

获取数据图层列表

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/styleInfo/{serverName}/{styleId}/layer.json (opens new window)
服务描述	根据服务名称获取该服务样式的要素列表中所有图层信息和字段信息，为图层的过滤等接口调用提供基本信息。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
返回值类型	json格式
返回值说明	返回配图系统中该样式的要素列表的图层结构，name为要素名称（DLTB2020），ID为要素父节点名称_要素名称（DLTB_DLTB2020）
请求示例	http://ditu.zjzwfw.gov.cn/mapserver/styleInfo/zjvmap/tdt_biaozhunyangshi_2017/layer.json (opens new window)
V2.0到V3.0变更说明	V3.0新增点要素的图层信息
备注

获取服务图层字段

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/serverInfo/{serverName}.json
服务描述	服务根据服务名称获取该服务的元数据信息及所有图层和字段（仅图层注册时选择的字段）信息，返回服务金字塔类型及金字塔信息、服务图片和瓦片缓存信息，为图层过滤接口调用提供基本信息。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
返回值说明	返回值为json格式数据
请求示例	http://ditu.zjzwfw.gov.cn/mapserver/serverInfo/zjvmap.json
V2.0到V3.0变更说明	V3.0修改返回信息，返回结果如下图所示： 从20210625的V3.0.13开始，****增加了字段别名。 与V2.0版本接口返回信息不完全一致，下图为V2.0的返回结果：

wmts地图服务

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/{type}/WMTS/{version}/{version}/{serverName}/{style}?Request={Request}&TileMatrix={TileMatrix}&TileRow ={TileRow}&TileCol={TileCol} http://ditu.zjzwfw.gov.cn/mapserver/{type}/WMTS/{version}/{serverName}/{style}/{Request}/{TileMatrix}/{TileRow}/{TileCol} (opens new window)
服务描述	WMTS（Web Map Tile Service）地图服务提供满足OGC标准的restful注记服务获取接口，包括服务元数据、瓦片和要素信息。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	type	服务类型，底图/注记，vmap/label	是
	version	1.0	是
	Request	getCapabilities/getTile	是
	TileMatrix	层级	否
	TileRow	瓦片行号	否
	TileCol	瓦片列号	否
	control	图层、要素的过滤、高亮设置，详情参见4.1	否
	mask	要素裁剪设置，详情参见4.2	否
	mask	按给定wkt范围裁剪要素并给剪半要素添加边框设置，详情参见4.3	否
返回值说明	Xml/Png,Request为getCapabilities，返回xml，getTile返回png
请求示例	返回元数据信息： http://ditu.zjzwfw.gov.cn/mapserver/label/WMTS/1.0/zjvmap/tdt_biaozhunyangshi_2017?REQUEST=getcapabilities (opens new window) 返回过滤后瓦片： http://172.16.67.52:8091/mapserver/vmap/WMTS/1.0/jiekoutest/ty?SERICE=WMTS&REQUEST=GetTile&TileMatrixSet=default028mm&VERSION=1.0.0&LAYER=vmap&tileMatrix=14&tileRow=1359&tileCol=6831&tilesize=512&format=image/png&control={"otherDisplay":false,"layers":[{"id":"水系_面","filters":{"Q_code_N_IN":"8202"},"filterStr":null,"display":true,"color":{"color":"red","opacity":0.8,"strokeColor":"yellow","strokeOpacity":0.8,"strokeWidth":2}},{"id":"水系_线","filters":{},"idFilter":"110254","filterStr":"Q_name_S_EQ=","display":true,"color":{"color":"white","opacity":0.8}}],"order":[]}
V2.0到V3.0变更说明	1） V3.0返回元数据信息xml文件bbox显示为数据真实信息； 2） V3.0在arcgis中加载wmts服务，会仅显示为服务保存页面的样式中心点、层级，故如果想看完整服务，需要将服务保存在显示完整样式的层级和中心点位置。 3） V3.0(NJ14V3.0.24)增加了mask参数：按给定wkt范围裁剪要素并给裁剪时减半要素添加边框设置，详细参见4.3； **注意****：**新增的mask参数与原来的mask参数不能同时使用，二者只能选择其一使用。
备注

wms地图服务

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/{type}/WMS/{version}/{serverName}/{style}?request={request}&BBOX={bbox}&WIDTH={width}&HEIGHT={height} (opens new window)
服务描述	WMS（Web Map Service）地图服务提供满足OGC标准的restful注记服务获取接口，包括服务元数据、瓦片和要素信息。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	type	服务类型，底图/注记，vmap/label	是
	version	1.0	是
	Request	getCapabilities/GetMap	是
	BBox	请求的地图范围，如BBOX=85,19,133,54	是
	WIDTH	地图的像素宽度	是
	HEIGTH	地图的像素高度	是
返回值说明	Xml/Png,Request为getCapabilities，返回xml，GetMap返回png
请求示例	返回元数据信息： http://ditu.zjzwfw.gov.cn/mapserver/label/WMS/1.0/zjvmap/tdt_biaozhunyangshi_2017?REQUEST=getcapabilities (opens new window) 返回图片： http://172.16.67.51:8091/mapserver/vmap/WMS/1.3.0/tt0119/tt?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&CRS=EPSG:0&BBOX=85.290090073829916,19.454314943594781,133.05776976587279,54.253932149748579&WIDTH=803&HEIGHT=585&LAYERS=0&STYLES=&EXCEPTIONS=XML&FORMAT=image/png&BGCOLOR=0xFEFFFF&TRANSPARENT=TRUE
V2.0到V3.0变更说明	V3.0新增接口
备注

图元要素拾取服务

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/{serverName}/{styleId}/pickup?level={level}&lon={lon}&lat={lat}
服务描述	图元要素拾取服务依据前端请求输入地图层级和经纬度，提供图元要素的在线拾取功能。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	level	地图层级	是
	lon	经度	是
	lat	纬度	是
	includelabel	是否包含注记 true/false 默认为false	否
	control	图层、要素的过滤、高亮设置，详情参见4.1	否
返回值类型	json
返回值说明	{ //图层id "政区境界_行政区划面": { //要素id "14314": { "objectid": 14314, "fcode": "6501000500", "fname": "海宁市", "fscale": 21 }, "14346": { "objectid": 14346, "fcode": "6401000500", "fname": "嘉兴市", "fscale": 21 }, "14555": { "objectid": 14555, "fcode": "6601000500", "fname": "黄湾镇", "fscale": 21 } }, "水系_水系_面状水系": { "158652": { "objectid": 158652, "fcode": "2101010500", "fscale": 7, "fname": "钱塘江" } }, "政区境界_境界线": { "2435": { "objectid": 2435, "fcode": "6402011314", "adjname": "浙江省嘉兴市海宁市黄湾镇-浙江省绍兴市上虞", "fscale": 8 } } }
请求示例	http://ditu.zjzwfw.gov.cn/mapserver/zjvmap/tdt_biaozhunyangshi_2017/pickup?level=11.381027294801406&lon=120.14622186028424&lat=30.247891212720987
V2.0到V3.0变更说明	无变化
备注	不支持提取层级拾取

图层元数据信息查询接口

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/{severName}/{layerName}/getInfo.json (opens new window) http://ditu.zjzwfw.gov.cn/mapserver/{severName}/{layerName}/level/getInfo.json (opens new window)
服务描述	查询指定服务、指定图层的原始数据(区别于切片数据)的元数据信息
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	layerName	图层id	是
	level	瓦片层级	否
返回值类型	Json
返回值说明	{ "idType": "Integer",//主键类型 "id": "fid",//主键名称 "spatial": "geom",//空间字段名称 "fields": [//字段列表 { "name": "fid", "type": "Integer"//字段类型 }, { "name": "qhname", "type": "String" }, { "name": "geom", "type": "geometry" }, { "name": "userid", "type": "Integer" }, { "name": "qhcode", "type": "String" }, { "name": "population", "type": "Integer" } ] }
请求示例	http://127.0.0.1 (opens new window):8091/mapserver/region/road/getInfo.json
V2.0到V3.0变更说明	无变化
备注	此接口为数据库查询接口，因此要求服务必须包含原始切片信息，用于切片的原始数据库能正常访问

图层数据数量查询接口

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/{severName}/{layerName}/count (opens new window)
服务描述	查询指定服务、指定图层的原始数据(区别于切片数据)的元数据信息
请求方式	get、post
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	layerName	图层id	是
	level	瓦片层级	否
	filter	过滤条件，如provinces=安徽省 模糊查询tbbh like‘%xx%’	否
	spatialFilter	空间过滤条件，格式为wkt字符串（面wkt必须是闭合的）	否
返回值类型	json
返回值说明	{"count":7}
请求示例	http://127.0.0.1/mapserver/region/road/count (opens new window) http://127.0.0.1:8091/mapserver/jiekoutest/ (opens new window)省界/12/count http://172.16.67.51:8092/mapserver/jiekoutest/ (opens new window)省界/12/count?filter=provinces=上海市 http://172.16.67.51:8092/mapserver/jiekoutest/ (opens new window)省界/12/count?spatialFilter=Point(121.71%2031.02)
V2.0到V3.0变更说明	V3.0的3.0.31版本开始支持post请求
备注	此接口为数据库查询接口，因此要求服务必须包含原始切片信息，用于切片的原始数据库能正常访问

图层数据查询接口

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/{severName}/{layerName}/{ids}.json (opens new window) http://ditu.zjzwfw.gov.cn/mapserver/{severName}/{layerName}/query (opens new window) http://ditu.zjzwfw.gov.cn/mapserver/{severName}/{layerName}/{level}/{ids}.json (opens new window) http://ditu.zjzwfw.gov.cn/mapserver/{severName}/{layerName}/{level}/ (opens new window)query
服务描述	查询指定服务、指定图层的数据
请求方式	get、post
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	layerName	图层id	是
	level	瓦片层级	否
	ids	要素id，多个id以英文逗号间隔，如123,124	否
	filter	过滤条件，如provinces=安徽省 模糊查询tbbh like‘%xx%’	否
	spatialFilter	空间过滤条件，格式为wkt字符串（面wkt必须是闭合的）	否
	fields	需要返回的字段，字段以英文逗号间隔，如fid,name,code	否
	withGeometry	是否返回空间字段，true/false，默认为false，当已经指定fields参数时，此参数无效	否
	withExtent	查询要素的最小外接矩形wkt，true/false，默认为false，，当已经指定fields参数时，此参数无效	否
	start	起始游标	否
	limit	返回数据的最大条目数	否
	withCenter	返回要素的中心点，true/false，默认为false	否
返回值类型	json
返回值说明	[ { "fid": 8, "qhname": "富阳区", "userid": 0, "population": 733500, "qhcode": "330111000000", “geom”:” MULTIPOLYGON (((119.96708818930766 29.76761329893755, 119.96688657448435 29.76738307867019, 119.96630514628087 29.767037788889592, 119.96576608294474 29.766464623299107)))” } ]
请求示例	http://127.0.0.1/mapserver/region/road/query?spatialFilter=POINT(120%2030)&withGeometry=false
V2.0到V3.0变更说明	V3.0修改了参数filter的写法，由V2.0的Q_code_S_EQ=1001这种写法，修改成code=10001； V3.0新增了参数withCenter，且不支持withCenter=true与withExtent=true一起使用； V3.0的V3.0.30新增了post请求；
备注	此接口为数据库查询接口，因此要求服务必须包含原始切片信息，用于切片的原始数据库能正常访问 http://172.16.67.52:8091/mapserver/osm/省界/query?filter=provinces=安徽省 (opens new window) http://172.16.67.52:8091/mapserver/jiekoutest/水系_面/20/query?filter=name=团城湖调节池&fields=fid,name,code,shape http://172.16.83.40:8091/mapserver/poitest/poi/query?start=1&limit=10000&withExtent=true (opens new window) http://172.16.67.52:8091/mapserver/tuyuanbr0414/建筑物/query?spatialFilter=MULTIPOLYGON (((104.1090674 30.723341, 104.1091752 30.7236144, 104.1097867 30.7234362, 104.1096789 30.7231628, 104.1090674 30.723341))) http://172.16.83.75:8091/mapserver/iekoutest/chinasl/36,317.json (opens new window)

地图导出接口

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/vmap/{severName}/export (opens new window)
服务描述	导出指定服务、样式、范围的地图图片
请求方式	get，新增Mask参数支持get和post
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	l	瓦片层级	是
	bbox	导出范围，minx,miny,maxx,maxy,如119,29,121,30	是
	withlabel	是否包括注记，0/1，默认为0（不包括）	否
	control	图层、要素的过滤、高亮设置，详情参见4.1	否
	mask	要素裁剪设置，详情参见4.2	否
	mask	按给定wkt范围裁剪要素并给剪半要素添加边框设置，详情参见4.3	否
返回值说明	返回json格式数据
请求示例	http://172.16.83.75:8091/mapserver/vmap/poitest/export?styleId=uu&ratio=1&bbox=121.4991,31.0975,121.5050,31.1005&l=17&withlabel=1
V2.0到V3.0变更说明	1、V3.0导出接口支持control参数，支持control中添加isMask参数 2、V3.0（V3.0.31）导出接口支持mask和新增mask参数，其中新增mask支持get和post请求，但是存在被裁剪要素的边框参数设置不生效；
备注	1. 导出范围bbox不能过大或过小，导出的图片最大长、宽不能超过20000像素，最小不能小于1像素; 2. 提取层级不支持control参数;

图例接口

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/styleInfo/{serverName}/{styleId}/{level}/legend.json
服务描述	获取指定服务、样式、层级的图例信息
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	level	地图层级	否
返回值类型	json
返回值说明	id是父样式，pid是子样式，点要素是否有图例待确认？
请求示例	http://ditu.zjzwfw.gov.cn/mapserver/styleInfo/zjvmap/tdt_biaozhunyangshi_2017/14/legend.json (opens new window)
V2.0到V3.0变更说明	无变化
备注

获取服务样式接口

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/styleInfo/{serverName}/{styleId}/style.json
服务描述	获取指定服务样式json信息
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
返回值类型	json
返回值说明	返回值与在线导出的样式json一致
请求示例	http://127.0.0.1:8091/mapserver/styleInfo/jiekoutest/ty/style.json (opens new window)
V2.0到V3.0变更说明	V3.0新增接口
备注	只有正式样式有，临时样式无

后端底图和注记瓦片服务

服务地址	http://ditu.zjzwfw.gov.cn/mapserver/all/{severName}/getMAP?x={x}&y={y}&l={z}&styleId=style&ratio={r} (opens new window)&titlesize={titlesize}
服务描述	矢量瓦片地图服务接口根据应用终端发送的http协议请求，将对应地图的底图和注记瓦片数据返回给用户终端的服务，其中返回的地图瓦片数据是被分割成相同大小如256x256像素的正方形栅格图片（非高清版）或512*512像素的正方形栅格图片（高清版，适用于高清屏和手机端）。
请求方式	get
参数说明	参数名	描述	是否必要
	serverName	服务名称，如浙江矢量电子地图服务名称为zjvmap	是
	styleId	矢量瓦片电子地图样式id，可以为同一个服务提供多个样式	是
	x	瓦片行号	是
	y	瓦片列号	是
	l	瓦片层级	是
	tilesize	瓦片大小 256/512，默认为512	否
	ratio	是否高清，其中：1为非高清版本，2为高清版本，默认为1	否
	control	图层、要素的过滤、高亮设置，详情参见4.1	否
返回值说明	返回地图瓦片png
请求示例	http://ditu.zjzwfw.gov.cn/mapserver/all/zjvmap/getMAP?x=13615&y=2761&l=14&styleId=tdt_biaozhunyangshi_2017&ratio=1 (opens new window)
V2.0到V3.0变更说明	V3.0新增接口
备注	存在如下问题： 1） 对mask（原）、mask（new）注记可以生效，但底图不生效； 2） ratio=2时，注记无效；