在个性化地图编辑器中发布样式后,只需要在地图 JavaScript API(JSAPI)中调用一行 setMapStyle,网页中的地图就会使用你设计的样式。本文以 JSAPI 4.0 为例,介绍从准备工作到上线的完整步骤。

开始之前,请确认以下三件事:

在页面中引入 JSAPI 4.0,并创建一个地图:
<!DOCTYPE html><html><head><meta charset="utf-8"><title>个性化地图示例</title><style>html, body, #container { width: 100%; height: 100%; margin: 0; }</style><script src="https://api.map.baidu.com/api?v=4.0&ak=您的AK"></script></head><body><div id="container"></div><script>var map = new BMap.Map('container');map.centerAndZoom(new BMap.Point(116.404, 39.915), 12);map.enableScrollWheelZoom(true);</script></body></html>
地图创建后,调用 setMapStyle 并传入样式 ID:
map.setMapStyle({styleId: '5aff805d-d3c2-415b-91a9-97514672a2e1' // 替换为你自己的样式 ID});
刷新页面,地图就会显示为编辑器中发布的样式。完整代码:
<!DOCTYPE html><html><head><meta charset="utf-8"><title>个性化地图示例</title><style>html, body, #container { width: 100%; height: 100%; margin: 0; }</style><script src="https://api.map.baidu.com/api?v=4.0&ak=您的AK"></script></head><body><div id="container"></div><script>var map = new BMap.Map('container');map.centerAndZoom(new BMap.Point(116.404, 39.915), 12);map.enableScrollWheelZoom(true);// 设置个性化样式map.setMapStyle({styleId: '5aff805d-d3c2-415b-91a9-97514672a2e1'});</script></body></html>
setMapStyle 支持两种方式,推荐使用样式 ID:
样式 JSON 可以在编辑器「⋮ > 查看配置 JSON」中点「复制」获得:
map.setMapStyle({styleJson: {"name": "午夜蓝","version": "2.0.0","template": "dark","featureStyles": [// ……从编辑器复制的完整内容]}});

JSAPI 根据样式 ID 的格式自动识别它来自新版还是旧版个性化编辑器,两种样式 ID 都可以直接传给 setMapStyle:
使用样式 ID 时,在编辑器中重新发布后,新打开的网页会加载新版本,已打开的页面刷新后生效,不需要修改代码。
编辑器中只保存、没有发布的修改不会出现在网页中。
地图显示的还是默认样式?
请依次检查:样式是否已经发布;样式 ID 是否复制完整;AK 和样式是否属于同一个开放平台账号;网页域名是否在 AK 的白名单中。
编辑器里改了,网页没变?
确认在编辑器中点了「发布」,然后刷新网页。
多个页面能用同一个样式吗?
可以。同一个账号下的不同页面、不同项目都可以使用同一个样式 ID,样式更新后它们会一起变化。如果希望某些页面不受影响,可以为它们另建一个样式。
上一篇
下一篇