服务文档

使用条款与限制

服务相关配额及并发请求限制:

请访问开发者权益页面查看。

云端存储

URL长度：2048

点标记的数量：50个

调用次数：同一个开发者帐号下的HTTP/HTTPS请求，配额、并发共享。

服务地址

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

组成说明：

域名：https://api.map.baidu.com

服务名：staticimage

版本号：v2

服务参数列表

参数名	必选	默认值	描述
ak	是	无	用户的访问密钥。支持浏览器端AK和Android/IOS SDK的AK，服务端AK不支持sn校验方式。
mcode	否	无	安全码。若为Android/IOS SDK的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。
dpiType	否	pl	手机屏幕类型。取值范围:{ph：高分屏，pl：低分屏(默认)}，高分屏即调用高清地图，低分屏为普通地图。
coordtype	否	bd09ll	静态图的坐标类型。支持wgs84ll（wgs84坐标）/gcj02ll（国测局坐标）/bd09ll（百度经纬度）/bd09mc（百度墨卡托）。默认bd09ll（百度经纬度）
scale	否	null	返回图片大小会根据此标志调整。取值范围为1或2： 1表示返回的图片大小为size= width * height; 2表示返回图片为(width2)(height 2)，且zoom加1 注：如果zoom为最大级别，则返回图片为（width2）（height2），zoom不变。
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一一对应。
paths	否	null	折线，可通过经纬度或地址/地名描述；多个折线用竖线"|"分隔；每条折线的点用分号";"分隔；点坐标用逗号","分隔。坐标格式：lng<经度>，lat<纬度>，例如116.43213,38.76623。
pathStyles	否	null	折线样式 color,weight,opacity[,fillColor]。

高分屏设备，从低清图切换至高清图示例：

低清图url:

 <img style="margin:20px" width="280" height="140" src="https://api.map.baidu.com/staticimage/v2?ak=E4805d16520de693a3fe707cdc962045&width=280&height=140&zoom=1"/>

示例效果：在iphone4（ios系统）中显示一张280*140，缩放级别为10的北京市地图。

高清图url:

<img style="margin:20px" width="280" height="140" src="https://api.map.baidu.com/staticimage/v2?ak=E4805d16520de693a3fe707cdc962045&width=280&height=140&zoom=11&scale=2"/>

示例效果：在iphone 4（ios系统）显示一张560*280，缩放级别为11的北京市高清地图

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

高级模式

标注参数

标注位置-markers

可通过经纬度或地址/地名描述；多个标签之间用竖线分隔。例如：markers=百度大厦|115.404,38.915|颐和园

标注样式-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

标注示例

普通示例:

https://api.map.baidu.com/staticimage/v2?ak=E4805d16520de693a3fe707cdc962045&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=E4805d16520de693a3fe707cdc962045&markers=%D6%D0%B9%D8%B4%E5&zoom=15&markerStyles=m,Y,0xFF0000

// 自定义marker颜色，参数格式：MarkerStyles=,,

自定义Marker样式示例：

https://api.map.baidu.com/staticimage/v2?ak=E4805d16520de693a3fe707cdc962045&zoom=15&markers=%D2%C3%BA%CD%D4%B0&markerStyles=-1,您的图片地址,-1

// 自定义icon，支持maker更换成自己喜欢的png图片。参数说明：markerStyles=-1,,-1

https://api.map.baidu.com/staticimage/v2?ak=E4805d16520de693a3fe707cdc962045&center=%E5%A4%A9%E5%AE%89%E9%97%A8&width=300&height=200&zoom=16&markers=%E5%A4%A9%E5%AE%89%E9%97%A8&markerStyles=-1,https://api.map.baidu.com/images/marker_red.png,-1,23,25

标注示例