添加点/标签 | 百度地图API SDK

所有文档

静态图

服务概览

快速开始

使用准备

接口文档

服务功能

高清地图添加点/标签添加折线/面

相关资料

常见问题资源下载使用指南

更新时间: 2026/03/20 16:07

添加点/标签

下载开发文档

标注参数说明

标注位置-markers：
可通过经纬度；多个标签之间用竖线分隔。例如：markers=116.288891,40.004261|116.487812,40.017524|116.525756,39.967111
标注样式-markerStyles：
设置标注的样式，若标注样式数少于点标记的个数，则多余的点标记的风格采用风格集合的最后一种。

属性	描述
属性	描述
size	有大中小三个值，分别为s、m、l。
label	可以为[0-9]、[A-Z]，不指定时显示A。
color	Color = [0x000000, 0xffffff]或使用css定义的颜色表。 black 0x000000 silver 0xC0C0C0 gray 0x808080 white 0xFFFFFF maroon 0x800000 red 0xFF0000 purple 0x800080 fuchsia 0xFF00FF green 0x008000 lime 0x00FF00 olive 0x808000 yellow 0xFFFF00 navy 0x000080 blue 0x0000FF teal 0x008080 aqua 0x00FFFF
url	自定义icon的地址，图片格式目前仅支持png32的。设置自定义图标标注时，忽略以上三个属性，只设置该属性且该属性前增加-1，如markerStyles=-1, https://api.map.baidu.com/images/marker_red.png 图标大小需小于5k，超过该值会导致加载不上图标的情况发生,图标的尺寸应小于256*256

API服务地址

https://api.map.baidu.com/staticimage/v2?ak='您的AK'&center=116.403874,39.914889&width=400&height=300&zoom=11&markers=116.288891,40.004261|116.487812,40.017524|116.525756,39.967111|116.536105,39.872374|116.442968,39.797022|116.270494,39.851993|116.275093,39.935251|116.383177,39.923743&markerStyles=l,A|m,B|l,C|l,D|m,E|,|l,G|m,H// 返回一张在北京地图上添加多个普通标注点的地图图片

API服务地址

https://api.map.baidu.com/staticimage/v2?ak='您的AK'&markers=116.288891,40.004261|116.487812,40.017524|116.525756,39.967111|116.536105,39.872374|116.442968,39.797022|116.270494,39.851993|116.275093,39.935251|116.383177,39.923743&zoom=15&markerStyles=m,Y,0xFF0000// 自定义marker颜色，参数格式：MarkerStyles=,,

API服务地址

https://api.map.baidu.com/staticimage/v2?ak='您的AK'&zoom=15&markers=116.288891,40.004261|116.487812,40.017524|116.525756,39.967111|116.536105,39.872374|116.442968,39.797022|116.270494,39.851993|116.275093,39.935251|116.383177,39.923743&markerStyles=-1,您的图片地址,-1// 自定义icon，支持maker更换成自己喜欢的png图片。参数说明：markerStyles=-1,,-1 https://api.map.baidu.com/staticimage/v2?ak='您的AK'&center=116.403874,39.914889&width=300&height=200&zoom=16&markers=116.403874,39.914889&markerStyles=-1,https://api.map.baidu.com/images/marker_red.png,-1,23,25

标签参数说明

标签位置-labels:
可通过经纬度；多个标签之间用竖线分隔。例如：labels=116.288891,40.004261|116.487812,40.017524|116.525756,39.967111
标签样式-labelStyles:

属性	描述
属性	描述
content	标签名，支持文字换行，利用换行符'\n'标识。示例test\ntest。
fontWeight	文字是否加粗，0标识不加粗。
fontSize	文字大小。
fontColor	文字颜色： Color = [0x000000, 0xffffff]或使用css定义的颜色表。 black 0x000000 silver 0xC0C0C0 gray 0x808080 white 0xFFFFFF maroon 0x800000 red 0xFF0000 purple 0x800080 fuchsia 0xFF00FF green 0x008000 lime 0x00FF00 olive 0x808000 yellow 0xFFFF00 navy 0x000080 blue 0x0000FF teal 0x008080 aqua 0x00FFFF
bgColor	背景颜色： Color = [0x000000, 0xffffff]或使用css定义的颜色表。 black 0x000000 silver 0xC0C0C0 gray 0x808080 white 0xFFFFFF maroon 0x800000 red 0xFF0000 purple 0x800080 fuchsia 0xFF00FF green 0x008000 lime 0x00FF00 olive 0x808000 yellow 0xFFFF00 navy 0x000080 blue 0x0000FF teal 0x008080 aqua 0x00FFFF
border	是否加边框，默认不加。

API服务地址

https://api.map.baidu.com/staticimage/v2?zoom=11&ak='您的AK'&center=116.403874,39.914889&width=400&height=300&labels=116.383177,39.923743&labelStyles=test\ntest,0,20,0x0000ff,0xC2FEFF,0

服务状态码

返回码	定义	注释
返回码	定义	注释
0	正常
1	服务器内部错误	该服务响应超时或系统内部错误，请留下联系方式
10	上传内容超过8M	Post上传数据不能超过8M
101	AK参数不存在	请求消息没有携带AK参数
102	Mcode参数不存在，mobile类型mcode参数必需	对于Mobile类型的应用请求需要携带mcode参数，该错误码代表服务器没有解析到mcode
200	APP不存在，AK有误请检查再重试	根据请求的ak，找不到对应的APP
201	APP被用户自己禁用，请在控制台解禁
202	APP被管理员删除	恶意APP被管理员删除
203	APP类型错误	当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone（类型22））及Browser（类型3），除此之外其他类型认为是APP类型错误
210	APP IP校验失败	在申请SERVER类型应用的时候选择IP校验，需要填写IP白名单，如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
211	APP SN校验失败	SERVER类型APP有两种校验方式IP校验和SN校验，当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败
220	APP Referer校验失败	浏览器类型的APP会校验referer字段是否存在，且在referer白名单里面，否则返回该错误码
230	APP Mcode码校验失败	服务器能解析到mcode，但和数据库中不一致，请携带正确的mcode
240	APP 服务被禁用	用户在API控制台中创建或设置某APP的时候禁用了某项服务，若需开通权限，可进入API控制台为AK勾选对应服务
250	用户不存在	根据请求的user_id, 数据库中找不到该用户的信息，请携带正确的user_id
251	用户被自己删除	该用户处于未激活状态
252	用户被管理员删除	恶意用户被加入黑名单
260	服务不存在	服务器解析不到用户请求的服务名称
261	服务被禁用	该服务已下线
302	天配额超限，限制访问	配额超限，如果想增加配额请联系我们
401	当前并发量已经超过约定并发配额，限制访问	并发控制超限，请控制并发量或联系我们
1001	没有IPv6地址访问的权限	如需通过IPv6来获取位置信息，请提交工单申请

高清地图

添加折线/面

本篇文章对您是否有帮助？