浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
高清地图
下载开发文档
使用条款与限制

服务相关配额及并发请求限制:
请访问开发者权益页面查看。
云端存储
URL长度:2048
点标记的数量:50个
调用次数:同一个开发者帐号下的HTTP/HTTPS请求,配额、并发共享。

API服务地址

https://api.map.baidu.com/staticimage/v2 //GET请求

服务参数说明
参数名称是否必须默认值描述
ak用户的访问密钥。支持浏览器端和服务端ak,网页应用推荐使用服务端ak
mcode安全码。若为Android/IOS SDK的ak, 该参数必需。
width400图片宽度。取值范围:(0, 1024]。Scale=2,取值范围:(0, 512]。
height300图片高度。取值范围:(0, 1024]。Scale=2,取值范围:(0, 512]。
center北京地图中心点位置,参数可以为经纬度坐标或名称。坐标格式:lng<经度>,lat<纬度>,例如116.43213,38.76623。
zoom11地图级别。高清图范围[3, 18];低清图范围[3,19]
copyrightpl静态图版权样式,0表示log+文字描述样式,1表示纯文字描述样式,默认为0。
dpiTypepl手机屏幕类型。取值范围:{ph:高分屏,pl:低分屏(默认)},高分屏即调用高清地图,低分屏为普通地图。
coordtypebd09ll静态图的坐标类型。支持wgs84ll(wgs84坐标)/gcj02ll(国测局坐标)/bd09ll(百度经纬度)/bd09mc(百度墨卡托)。默认bd09ll(百度经纬度)
scalenull

返回图片大小会根据此标志调整。取值范围为1或2:
1表示返回的图片大小为size= width * height;
2表示返回图片为(width*2)*(height *2),且zoom加1
注:如果zoom为最大级别,则返回图片为(width*2)*(height*2),zoom不变。

bboxnull地图视野范围。格式:minX,minY;maxX,maxY。
markersnull标注,可通过经纬度或地址;多个标注之间用竖线分隔。
markerStylesnull与markers有对应关系。markerStyles可设置默认图标样式和自定义图标样式。其中设置默认图标样式时,可指定的属性包括size,label和color;设置自定义图标时,可指定的属性包括url,注意,设置自定义图标时需要先传-1以此区分默认图标。
labelsnull标签,可通过经纬度或地址;多个标签之间用竖线分隔。坐标格式:lng<经度>,lat<纬度>,例如116.43213,38.76623。
labelStylesnull标签样式 content, fontWeight,fontSize,fontColor,bgColor, border。与labels一一对应。
pathsnull

折线,可通过经纬度或地址;多个折线用竖线"|"分隔;每条折线的点用分号";"分隔;点坐标用逗号","分隔。坐标格式:lng经度,lat纬度,例如116.43213,38.76623。

pathStylesnull

折线样式 color,weight,opacity[,fillColor]。

高分屏设备,从低清图切换至高清图示例:

低清图示例

https://api.map.baidu.com/staticimage/v2?ak='您的AK'&width=280&height=140&zoom=10

示例效果:在iphone4(ios系统)中显示一张280*140,缩放级别为10的北京市地图。

高清图示例

https://api.map.baidu.com/staticimage/v2?ak='您的AK'&width=280&height=140&zoom=11&scale=2

示例效果:在iphone 4(ios系统)显示一张560*280,缩放级别为11的北京市高清地图

注意:用户在使用高分屏设备时,若要从低清图切换至高清图且保持同等显示效果,则需要在图片的请求url中指定scale=2。

示例代码
填写您的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['width'] = '280';
$param['height'] = '140';
$param['zoom'] = '10';
$param['ak'] = $ak;
$res = request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res . "\n");
?>
在线运行
参数备注必选
width
512
height
256
zoom
10
返回码说明
状态码含义
500AK参数无效
502超出了width的范围
503超出了height的范围
504无法参过center得到地理位置
505超出了Zoom的范围
506center 格式错误
0正常
1服务器内部错误
2请求参数非法
3权限校验失败
4配额校验失败
5ak不存在或者非法
8数据解析失败
9高级权限校验失败
101AK参数不存在
200APP不存在,AK有误请检查再重试
201APP被用户自己禁用,请在控制台解禁
202APP被管理员删除
203APP类型错误
210APP IP校验失败
211APP SN校验失败
240APP 服务被禁用
250用户不存在
251用户被自己删除
252用户被管理员删除
260服务不存在
261服务被禁用
301永久配额超限,限制访问
302天配额超限,限制访问
401当前并发量已经超过约定并发配额,限制访问
402当前并发量已经超过约定并发配额,并且服务总并发量也已经超过设定的总并发配额,限制访问

上一篇

使用准备

下一篇

添加点/标签

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