百度地图开放平台

所有文档

个性化地图编辑器

更新时间: 2026/11/12 10:21

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

准备工作

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

准备项说明

已发布的样式

在编辑器中完成编辑并点击「发布」。只保存草稿、没有发布的样式无法加载

样式 ID

在样式列表中点击样式 ID 即可复制,或在编辑器「⋮ > 复制样式 ID」

浏览器端 AK

在开放平台控制台申请浏览器端 AK,并把网页的域名加入 AK 的 Referer 白名单。AK 必须和样式属于同一个开放平台账号

第一步:创建地图

在页面中引入 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:

方式写法特点

样式 ID(推荐)

map.setMapStyle({styleId: '样式ID'})

在编辑器中重新发布后,网页无需改代码,刷新即可用上新样式

样式 JSON

map.setMapStyle({styleJson: 配置JSON})

把样式配置直接写在代码里,不依赖发布;样式更新时需要修改代码重新上线

样式 JSON 可以在编辑器「⋮ > 查看配置 JSON」中点「复制」获得:

map.setMapStyle({
styleJson: {
"name": "午夜蓝",
"version": "2.0.0",
"template": "dark",
"featureStyles": [
// ……从编辑器复制的完整内容
]
}
});
新版与旧版样式 ID

JSAPI 根据样式 ID 的格式自动识别它来自新版还是旧版个性化编辑器,两种样式 ID 都可以直接传给 setMapStyle:

来源样式 ID 格式示例

新版个性化地图编辑器

36 位,带连字符

5aff805d-d3c2-415b-91a9-97514672a2e1

旧版个性化编辑器

32 位,不带连字符

a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

样式更新
  • 使用样式 ID 时,在编辑器中重新发布后,新打开的网页会加载新版本,已打开的页面刷新后生效,不需要修改代码。

  • 编辑器中只保存、没有发布的修改不会出现在网页中。

常见问题

地图显示的还是默认样式?
请依次检查:样式是否已经发布;样式 ID 是否复制完整;AK 和样式是否属于同一个开放平台账号;网页域名是否在 AK 的白名单中。
编辑器里改了,网页没变?
确认在编辑器中点了「发布」,然后刷新网页。
多个页面能用同一个样式吗?
可以。同一个账号下的不同页面、不同项目都可以使用同一个样式 ID,样式更新后它们会一起变化。如果希望某些页面不受影响,可以为它们另建一个样式。

上一篇

操作手册

下一篇

在 SDK 中使用
本篇文章对您是否有帮助?