# 图层配置

basemaps配置地图的基础底图图层，operationallayers配置可叠加矢量数据、模型数据、瓦片数据和其他数据图层，两者配置参数都一样。所有图层使用 type 参数进行类别区分

# 基础底图配置

# 1. Group 分组

使用 type 为 group 来配置虚节点，用于界面中图层控制树结构时使用，"id" 和"pid"控制图层父子关系。示例： {"id": 4, "name": "倾斜摄影模型", "type": "group" }, 也可以将其他任意 type 类型图层放在 layers 参数数组内形成一个组合，方便一起显示隐藏.。示例：

{
 	"name": "微软 Bing 卫星",
 	"type": "group",
 	"icon": "img/basemaps/bingAerial.png",
 	"layers": [{
 			"name": "底图",
 			"type": "www_bing",
 			"layer": "Aerial"
 		},
 		{
 			"name": "注记",
 			"type": "www_tdt",
 			"layer": "img_z"
 		}
 	]
 }

# 2. 单张图片作为底图

使用一张图片底图图层，在简单场景可用示例：{"name": "本地图片", "type": "image","url": "img/globe.jpg" }

# 3. 具有 xyz 格式地址的瓦片图层

当瓦片地图 url 地址具有 xyz 规则的标准图层时使用，其它参数支持 Cesium.UrlTemplateImageryProvider 所有 options。示例：

{
	"name": "OSM 地图",
	"type": "tile",
	"url": "http://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png",
	"subdomains": ["a", "b", "c"]
}

# 4. OGC 标准 wmts 服务图层

示例：

{
	"name": "wmts 地图",
	"type": "wmts",
	"url": "http://127.0.0.1:8888/geowebcache/service/wmts",
	"layer": "china_mercator_img"
}

####配置说明

名称	中文释义	类型
url	服务地址 string	字符串
layer	图层名称 string	字符串
opacity	透明度	0 到 1 的小数值
rectangle	请求的瓦片范围	object 对象

# 5. OGC 标准 wms 服务图层

示例：

{
	"name": "wms 地图",
	"type": "wms",
	"url": "http://geoserver.nationalmap.nicta.com.au/geotopo_250k/ows",
	"layers": "Hydrography:bores",
	"parameters": {
		"transparent": true,
		"format": "image/png"
	}
}

# 6. OGC 标准 tms 服务图层

示例：

{
	"name": "blackmarble",
	"type": "tms",
	"url": "https://cesiumjs.org/blackmarble",
	"flipXY": true
}

# 7. ArcGIS 标准的切片数据

将 arcgis 的切片数据直接通过 http 服务发布后使用，参数 isUpper 标识图片名称是否为大写, imgType 标识图片格式，默认为.jpg 示例：

{
	"name": "ArcGIS 切片",
	"type":"arcgis_cache",
	"url":"http://127.0.0.1:8888/mapcache/china_mercator_img/_alllayers/L{arc_z}/R{arc_y}/C{arc_x}.jpg"}
}

####配置说明

名称	中文释义	类型
url	服务地址	string字符串
crs	坐标系	墨卡托投影（3857）或WGS84(4326)
opacity	透明度	0 到1 的小数值
minimumLevel	最小层级	number
maximumLevel	最大层级	number
minimumTerrainLevel	显示的最小层级	number
maximumTerrainLevel	显示的最大层级	number
rectangle	请求的瓦片范围	object 对象

# 8. ArcGIS Server 标准 MapServer 瓦片服务

加载 arcgis server 发布的标准瓦片服务图层，其它参数支持 L.esri.tiledMapLayer 所有 options 示例：

{
	"name": "ArcGIS 卫星",
	"type": "arcgis_tile",
	"url": "https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer"
}

# 9. OSM 在线地图

示例：

{
	"pid": 102,
	"name": "OSM 地图",
	"type": "www_osm",
	"icon": "img/basemaps/advsearoad.png"
}

# 10. 天地图在线地图

使用 layer 参数标识图层类型，crs 参数标识坐标系，默认为墨卡托坐标系，可以配置 4326 标识 wgs84 坐标系。示例：

{
	"name": "天地图",
	"type": "www_tdt",
	"crs": "3857",
	"layer": "vec"
}

layer参数	说明
vec_d	电子底图
vec_z	电子注记
img_d	卫星底图
img_z	卫星注记
ter_d	地形底图
ter_z	地形注记

如果底图和注记一起使用时，可以用 group 类包含

{
	"name": "天地图卫星",
	"type": "group",
	"layers": [{
			"name": "底图",
			"type": "www_tdt",
			"layer": "img_d"
		},
		{
			"name": "注记",
			"type": "www_tdt",
			"layer": "img_z"
		}
	]
}

# 11. 微软 Bing 在线地图

使用 layer 参数标识图层类型，bigfont标识是否大字体地图，crs 参数配置为 gcj，标识是国测局偏移坐标系。示例：

{ "name": "微软 bing", "type": "www_bing" }

layer参数	说明
Aerial	无标记影像（默认）
AerialWithLabels	有英文标记影像
Road	矢量道路

# 12. 高德在线地图

使用 type 参数标识图层类型，bigfont 标识是否大字体地图，crs 参数配置为 gcj，标识是国测局偏移坐标系示例：

{ "name": "高德", "type": "www_gaode","crs": "gcj","layer": "vec" }

Type 参数	说明
vec	电子地图（含底图和注记）
img_d	卫星底图单图层
img_z	卫星注记单图层
time	高德实时路况信息

# 13. 谷歌国内在线地图(已屏蔽)

使用 type 参数标识图层类型，crs 参数配置为 gcj，标识是国测局偏移坐标系示例：

{ "name": "谷歌", "type": "www_google", "crs": "gcj","layer": "img" }

Type 参数	说明
vec	电子地图（含底图和注记）
img_d	卫星底图单图层
img_z	卫星注记单图层
ter	地形地图（含底图和注记）

# 14. 谷歌无偏影像(已屏蔽)

示例：

{
	"pid": 101,
	"name": "谷歌卫星",
	"icon": "img/basemaps/google_img.png",
	"type": "www_google",
	"crs": "wgs84",
	"layer": "img_d",
	"visible": true
},

# 15. 在线海图数据(已废弃)

示例

{
	"pid": 103,
	"name": "高级海图",
	"type": "tile",
	"icon": "img/basemaps/advsea.png",
	"url": "https://www.tjzcsj.com/ashx/getImage.ashx?tilematrixset=advsea&style=default&tilerow={y}&tilecol={x}&tilematrix={z}"
},

说明	url参数
高级海图	https://www.tjzcsj.com/ashx/getImage.ashx?tilematrixset=advsea&style=default&tilerow={y}&tilecol={x}&tilematrix={z}
基础海陆混合	https://www.tjzcsj.com/ashx/getImage.ashx?tilematrixset=basicsearoad&style=default&tilerow={y}&tilecol={x}&tilematrix={z}
高级海陆混合	https://www.tjzcsj.com/ashx/getImage.ashx?tilematrixset=advsearoad&style=default&tilerow={y}&tilecol={x}&tilematrix={z}

# 16. 船讯网海图

示例：

{
		"pid": 103,
		"name": "海图",
		"type": "tile",
		"icon": "img/basemaps/advsearoad.png",
		"url": "http://m12.shipxy.com/tile.c?l=Na&m=o&y={y}&x={x}&z={z}"
},

# 17. ArcGIS深色背景图

{
		"pid": 102,
		"name": "深色底图",
		"icon": "img/basemaps/bd-c-midnight.png",
		"type": "arcgis",
		"url": "http://map.geoq.cn/arcgis/rest/services/ChinaOnlineStreetPurplishBlue/MapServer"
},

# 18. 百度地图(v3 支持)

{
		"pid": 102,
		"name": "百度地图",
		"type": "www_baidu",
		"crs": "baidu",
		"layer": "vec",
		"icon": "img/basemaps/advsearoad.png"
},

Type 参数	说明
vec	电子地图（含底图和注记）
img_d	卫星底图单图层
img_z	卫星注记单图层
custom	自定义
time	路况数据

# 19. 行政区划

{
		"pid": 4020,
		"name": "行政区划",
		"type": "xyz",
		"url": "https://t{s}.tianditu.gov.cn/DataServer?T=ibo_w&x={x}&y={y}&l={z}&tk=9ae78c51a0a28f06444d541148496e36",
		"subdomains": "01234567",
		"maximumLevel": 10,
		"show": true
},

# 20. 高德路况(v3支持)

{
		"pid": 4020,
		"name": "高德路况",
		"type": "xyz",
		"url": "https://localhost:44349/ashx/GetAMap.ashx?v=1.0&;t=1&x={x}&y={y}&z={z}",
		"subdomains": "01234567"
},

# 21. 全球OSM白模(v3支持)

{
		"id": 204011,
		"pid": 2040,
		"type": "osmbuilding",
		"name": "全球OSM白模"
},

# 22. 高德poi分块显示(v3支持)

{
		"pid": 50,
		"name": "高德兴趣点",
		"type": "www_poi"
},

# 其他内置图层

说明	配置
经纬网	{ "name": "经纬网", "type": "custom_graticule" }
网格线	{ "name": "网格线", "type": "custom_grid" }
瓦片信息	{ "name": "瓦片信息", "type": "custom_tilecoord" }

# 叠加图层配置

# Geojson数据配置

# 一、普通数据源配置

# 点数据

			{
				"pid": 3010,
				"type": "geojson",
				"name": "桩号(50米)",
				"url": "data/geojson/zhuanghao/ZDHAtt.json",
				"symbol": {
					"styleOptions": {
						"image": "img/marker/mark2.png",
						"scale": 0.8,
						"label": {
							"field": "TextString",
							"font_size": 17,
							"color": "#ffffff",
							"border": true,
							"border_color": "#000000",
							"pixelOffset": [0, -40],
							"distanceDisplayCondition":true,
							"distanceDisplayCondition_far":1000.0
						},
						"distanceDisplayCondition":true,
						"distanceDisplayCondition_far":1000.0
						
					}
				},
				"popup": "桩号：{TextString}"
			},

# 线数据

           {
				"pid": 3010,
				"type": "geojson",
				"name": "中心线",
				"url": "data/geojson/zhuanghao/CenterLine.json",
				"symbol": {
					"styleOptions": {
						"outlineWidth":5.0,
						"outline":true,
						"lineType":"solid",
						"color":"#3388ff"//面填充
					}
				},
				"distanceDisplayCondition":200,
				"popup": "名称：{name}"
			},

# 二、动态水面数据配置

		  {
				"pid": 3010,
				"type": "geojson",
				"name": "海河",
				"url": "data/geojson/haihe.json",
				"effect": "water"
			},

# 三维图层配置

# 1. 倾斜摄影 3dtiles 模型

3dtiles 模型，其中 offset 参数 xyz 为修正模型数据的原始经纬位置和高度

           {
				"id": 203012,
				"pid": 2031,
				"type": "3dtiles",
				"name": "3dtiles",
				"url": "/tileset.json",
				"maximumScreenSpaceError": 16,
				"offset": {
					"z": 68
				},
				"center": {
					"x": 103.073319,
					"y": 29.979713,
					"z": 2000,
					"heading": 39.6,
					"pitch": -90,
					"roll": 0.1
				},
				"visible": true
			},

# 2. gltf 实体模型

gltf 模型，其中 position 参数为模型所在位置信息示例

{
	"type": "gltf",
	"name": "电线塔",
	"url": "http://localhost/gltf/dianxianta.gltf",
	"position": {
		"x": 117.217,
		"y": 31.821,
		"heading": 90
	},
	"center": {
		"y": 31.83,
		"x": 117.291,
		"z": 86,
		"heading": 343,
		"pitch": -17,
		"roll": 0
	}
}

# ArcGIS 服务

# ArcGIS FeatureLayer

加载 arcgis server 发布的标准 featureLayer 服务图层，其它参数where 进行条件筛选，支持 minimumLevel 配置显示的最低层级（大数据时必须配置，否则在全国视图数据太大会很慢），支持 symbol 参数配置样式，额外支持popup或columns 配置信息窗格式，symbol 配置显示样式。，点可以设置 image 等参数，线面可以设置 color 和 width 参数。

名称	中文释义	类型
url	服务地址	string 字符串
minimumLevel	最小层级	最小层级，可输入1-18
debuggerTileInfo	测试信息	boolean 单选（是、否）
symbol	图例	string 字符串
tooltip	鼠标提示框	string 字符串
popup	气泡窗	string 字符串
center	视角参数	string 字符串
buildings	建筑物特殊支持	{ "cloumn": 楼层数,"height":楼高 }

symbol 参数说明，可以配置点、线、面的样式，见下图示例（1）点图层：同一个图片图标时（2）点图层：根据数据使用不同图片图标时，增加配置 styleField 和styleFieldOptions （3）线面图层：使用同一种样式时（4）线面图层：根据数据使用不同样式时，增加配置 styleField 和 styleFieldOptions popup 参数说明，可以配置点击后有信息面板弹窗例如："popup": "名称：{NAME}
类型：{TYPE}
长度：{LENGTH}米"

点数据示例

{
	"pid": 4010,
	"type": "arcgis_feature2",
	"name": "兴趣点",
	"url": "../POI/MapServer/0",
	"where": " 1=1 ",
	"minimumLevel": 15,
	"heightOffset":1,
	"symbol": {
		"styleOptions": {
			"image": "img/marker/mark3.png",
			"scale": 1,
			"scaleByDistance": true,
			"scaleByDistance_far": 20000,
			"scaleByDistance_farValue": 0.5,
			"scaleByDistance_near": 1000,
			"scaleByDistance_nearValue": 1,
			"label": {
				"field": "NAME",
				"font_size": 15,
				"color": "#ffffff",
				"border": true,
				"border_color": "#000000",
				"pixelOffset": [0, -50],
				"distanceDisplayCondition": true,
				"distanceDisplayCondition_far": 2000,
				"distanceDisplayCondition_near": 0
			}
		},
		"styleField": "类别",
		"styleFieldOptions": {
			"AB03": {
				"image": "img/marker/mark1.png"
			},
			"A980": {
				"image": "img/marker/mark2.png"
			},
			"A900": {
				"image": "img/marker/mark4.png"
			}
		}
	},
	"popup": "类别：{类别}<br />名称:{NAME}<br />地址：{ADDRESS}"
}

# ArcGIS 动态地图服务

           {
				"pid": 4010,
				"type": "arcgis_dynamic",
				"name": "道路",
				"url": "/arcgis/rest/services/TJPOI84/MapServer",
				"layers": "0",
				"center": {
					"y": 31.814176,
					"x": 117.225362,
					"z": 5105.3,
					"heading": 359.2,
					"pitch": -83.1,
					"roll": 360
				},
				"popup": "all"
			},

配置选中后的样式其中

名称	说明
stroke	面边线颜色，默认黄色
strokeWidth	面边线宽度，默认为3
fill	面填充色
fillAlpha	面填充透明度

{
	"pid": 4010,
	"type": "arcgis_dynamic",
	"name": "全国省",
	"url": "http:///arcgis/rest/services/Test/China3857/MapServer",
	"layers": "1",
	"showClickFeature": true,
	"pickFeatureStyle": {
		"stroke": "#ffff00",
		"strokeWidth": 3,
		"fill": "#ffff00",
		"fillAlpha": 0.5
	},
	"visible": true
},

# 特效图层

# 1、精灵线

{
		"pid": 50,
		"name": "精灵线",
		"type": "geojson",
		"effect": "jinglingxian",
		"url": "data/geojson/nanshan/nanshan-road3.geojson"
},

效果

# 2、动态墙

{
		"pid": 50,
		"name": "动态墙",
		"type": "geojson",
		"effect": "dynamicwall",
		"url": "data/geojson/nanshan/nanshan-road2.geojson"
},

效果

# 3、动态运输线

{
		"pid": 50,
		"name": "动态运输线",
		"type": "geojson",
		"effect": "dynamictransline",
		"url": "data/geojson/nanshan/nanshan-road2.geojson"
},

效果

# 4、尾迹线

{
		"pid": 50,
		"name": "尾迹线",
		"type": "geojson",
		"effect": "weijixian",
		"url": "data/geojson/nanshan/nanshan-road1.geojson"
},

效果

# 5、闪烁白模

{
		"id": 204011,
		"pid": 2040,
		"type": "flashbuilding",
		"name": "闪烁白模",
		"url": "demodata/nanshan/tileset.json",
		"offset": {
			"z": 0
		}
},

效果

← 地形配置配置示例 →