AI
产品服务
解决方案
文档与支持
定价
更新时间: 2026/03/20 16:07
高清地图
下载开发文档
使用条款与限制

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

API服务地址

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

服务参数说明
参数名称是否必须默认值描述

ak

用户的访问密钥。需使用服务端ak

width

400

图片宽度。取值范围:(0, 1024]。Scale=2,取值范围:(0, 512]。

height

300

图片高度。取值范围:(0, 1024]。Scale=2,取值范围:(0, 512]。

center

北京

地图中心点位置,参数可以为经纬度坐标或名称。坐标格式:lng<经度>,lat<纬度>,例如116.43213,38.76623。

zoom

11

地图级别。高清图范围[3, 18];低清图范围[3,19]

copyright

pl

静态图版权样式,0表示log+文字描述样式,1表示纯文字描述样式,默认为0。

coordtype

bd09ll

静态图的坐标类型。支持wgs84ll(wgs84坐标)/gcj02ll(国测局坐标)/bd09ll(百度经纬度)/bd09mc(百度墨卡托)。默认bd09ll(百度经纬度)

scale

null

返回图片大小会根据此标志调整。取值范围为1或2:

1表示返回的图片大小为size= width * height;

2表示返回图片为(width*2)*(height *2),且zoom加1

注:如果zoom为最大级别,则返回图片为(width*2)*(height*2),zoom不变。

scaler

null

返回图片大小会根据此标志调整,取值范围为1或2:

1表示返回的图片大小为size= width * height;

2表示返回图片为(width*2)*(height *2),zoom不变

注:如果想要低清图,则scale=1与scaler=1一样,传入一个即可;如果想要高清图,则需要传入scaler=2。

bbox

null

地图视野范围。格式:minX,minY;maxX,maxY。

markers

null

标注,可通过经纬度或地址;多个标注之间用竖线分隔。

markerStyles

null

与markers有对应关系。markerStyles可设置默认图标样式和自定义图标样式。其中设置默认图标样式时,可指定的属性包括size,label和color;设置自定义图标时,可指定的属性包括url,注意,设置自定义图标时需要先传-1以此区分默认图标。

labels

null

标签,可通过经纬度或地址;多个标签之间用竖线分隔。坐标格式:lng<经度>,lat<纬度>,例如116.43213,38.76623。

labelStyles

null

标签样式 content, fontWeight,fontSize,fontColor,bgColor, border。与labels一一对应。

注:支持content文字换行,利用换行符'\n'标识。示例test\ntest。

paths

null

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

pathStyles

null

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

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

API服务地址

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

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

API服务地址

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

返回码说明
状态码含义

500

AK参数无效

502

超出了width的范围

503

超出了height的范围

504

无法参过center得到地理位置

505

超出了Zoom的范围

506

center 格式错误

0

正常

1

服务器内部错误

2

请求参数非法

3

权限校验失败

4

配额校验失败

5

ak不存在或者非法

8

数据解析失败

9

高级权限校验失败

101

AK参数不存在

200

APP不存在,AK有误请检查再重试

201

APP被用户自己禁用,请在控制台解禁

202

APP被管理员删除

203

APP类型错误

210

APP IP校验失败

211

APP SN校验失败

240

APP 服务被禁用

250

用户不存在

251

用户被自己删除

252

用户被管理员删除

260

服务不存在

261

服务被禁用

301

永久配额超限,限制访问

302

天配额超限,限制访问

401

当前并发量已经超过约定并发配额,限制访问

402

当前并发量已经超过约定并发配额,并且服务总并发量也已经超过设定的总并发配额,限制访问

上一篇

使用准备

下一篇

添加点/标签

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