全部服务产品
开发者频道
定价
登录
添加点/标签
下载开发文档
标注参数说明

标注位置-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。
colorColor = [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
普通示例

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
// 返回一张在北京地图上添加多个普通标注点的地图图片

修改标注点颜色示例

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=,,

自定义Marker样式示例

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

示例代码
填写您的AK

输入AK可生成包含IP/SN校验方式的代码

<?php
// 此处填写你在控制台-应用管理-创建应用后获取的AK
$ak = '您的AK';
// 发起一个http get请求,并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
function request_get($url = '', $param = array()) {
if (empty($url) || empty($param)) {
return false;
}
$getUrl = $url . "?" . http_build_query($param);
$curl = curl_init(); // 初始化curl
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
curl_setopt($curl, CURLOPT_URL, $getUrl); // 抓取指定网页
curl_setopt($curl, CURLOPT_TIMEOUT, 1000); // 设置超时时间1秒
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // curl不直接输出到屏幕
curl_setopt($curl, CURLOPT_HEADER, 0); // 设置header
$data = curl_exec($curl); // 运行curl
if (!$data) {
print("an error occured in function request_get(): " . curl_error($curl) . "\n");
}
curl_close($curl);
return $data;
}
// 请求地址
$url = 'https://api.map.baidu.com//staticimage/v2';
// 构造请求参数
$param['center'] = '116.403874,39.914889';
$param['width'] = '512';
$param['height'] = '256';
$param['zoom'] = '11';
$param['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';
$param['markerStyles'] = 'l,A|m,B|l,C|l,D|m,E|,|l,G|m,H';
$param['ak'] = $ak;
$res = request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res . "\n");
?>
在线运行
参数备注
center
116.403874,39.914888
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",
width
400
zoom
11
markerStyles
l,A|m,B|l,C|l,D|m,E|,|l,G|m,H
height
300
服务状态码
返回码定义注释
0正常
1服务器内部错误该服务响应超时或系统内部错误,请留下联系方式
10上传内容超过8MPost上传数据不能超过8M
101AK参数不存在请求消息没有携带AK参数
102Mcode参数不存在,mobile类型mcode参数必需对于Mobile类型的应用请求需要携带mcode参数,该错误码代表服务器没有解析到mcode
200APP不存在,AK有误请检查再重试根据请求的ak,找不到对应的APP
201APP被用户自己禁用,请在控制台解禁
202APP被管理员删除恶意APP被管理员删除
203APP类型错误当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone(类型22))及Browser(类型3),除此之外其他类型认为是APP类型错误
210APP IP校验失败在申请SERVER类型应用的时候选择IP校验,需要填写IP白名单,如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
211APP SN校验失败SERVER类型APP有两种校验方式IP校验和SN校验,当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败
220APP Referer校验失败浏览器类型的APP会校验referer字段是否存在,且在referer白名单里面,否则返回该错误码
230APP Mcode码校验失败服务器能解析到mcode,但和数据库中不一致,请携带正确的mcode
240APP 服务被禁用用户在API控制台中创建或设置某APP的时候禁用了某项服务,若需开通权限,可进入API控制台为AK勾选对应服务
250用户不存在根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id
251用户被自己删除该用户处于未激活状态
252用户被管理员删除恶意用户被加入黑名单
260服务不存在服务器解析不到用户请求的服务名称
261服务被禁用该服务已下线
302天配额超限,限制访问配额超限,如果想增加配额请联系我们
401当前并发量已经超过约定并发配额,限制访问并发控制超限,请控制并发量或联系我们
1001没有IPv6地址访问的权限如需通过IPv6来获取位置信息,请提交工单申请

上一篇

高清地图

下一篇

添加折线/面

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