您当前的位置静态图 API>接口说明

接口说明

1.使用条款与限制

  • 请求频率:无限制
  • URL长度:2048
  • 点标记的数量:50个

2.服务地址

http://api.map.baidu.com/staticimage 

组成说明:
  • 域名:http://api.map.baidu.com
  • 服务名:staticimage

3.服务参数列表

参数名必选默认值描述
width400图片宽度。取值范围:(0, 1024]。
height300图片高度。取值范围:(0, 1024]。
center北京地图中心点位置,参数可以为经纬度坐标或名称。坐标格式:lng<经度>,lat<纬度>,例如116.43213,38.76623。
zoom11地图级别。高清图范围[3, 18];低清图范围[3,19]
copyright0静态图版权样式,0表示log+文字描述样式,1表示纯文字描述样式,默认为0。
dpiTypepl手机屏幕类型。取值范围:{ph:高分屏,非ph:低分屏},高分屏即调用高清地图,低分屏为普通地图。自V3后废弃。
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]。

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

<img style="margin:20px" width="280" height="140" src="http://api.map.baidu.com/staticimage?width=280&height=140&zoom=10" />

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

高清图url:

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

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

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

4.静态图可视化工具

利用静态图可视化工具,可以轻松地修改地图容器的大小,设置地图中心点,添加不同样式的标注等。最后复制自动生成的代码即可。

百度地图静态图可视化工具,请访问:

http://api.map.baidu.com/lbsapi/staticmap/staticmap-helper.html

5.高级模式

5.1 标注参数

标注位置-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, http://api.map.baidu.com/images/marker_red.png,图标大小需小于5k,超过该值会导致加载不上图标的情况发生。
width 自定义icon宽度(不设置默认为0),自v3后废弃。
Height 自定义icon高度(不设置默认为0),自v3后废弃。
标注示例

普通示例:

http://api.map.baidu.com/staticimage?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  //返回一张在北京地图上添加多个普通标注点的地图图片

修改标注点颜色示例:

http://api.map.baidu.com/staticimage?markers=%D6%D0%B9%D8%B4%E5&zoom=15&markerStyles=m,Y,0xFF0000  //自定义marker颜色,参数格式:MarkerStyles=,,

自定义Marker样式示例:

http://api.map.baidu.com/staticimage?zoom=15&markers=%D2%C3%BA%CD%D4%B0&markerStyles=-1,您的图片地址,-1  //自定义icon,支持maker更换成自己喜欢的png图片。参数说明:markerStyles=-1,,-1//自定义icon,支持maker更换成自己喜欢的png图片。参数说明:markerStyles=-1,,-1
http://api.map.baidu.com/staticimage?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,http://api.map.baidu.com/images/marker_red.png,-1,23,25

标注示例

参数 效果展示
center:
markers:
zoom:
默认图标 自定义图标
size :
label:
color:

5.2 标签参数

标签位置-labels

可通过经纬度或地址/地名描述;多个标签之间用竖线分隔。例如:labels=北京|116.403874,39.914889|上海

标签样式-labelStyles

设置标签的样式,共有6个属性,如下表。举例:labelStyles=你好,1,12,0x00ff00,0xffffff,1 表示白底12号红字“你好”右边框。

属性描述
content 标签内容;中文字符需要用encodeURIComponent编码。允许16个字符。
border 设置label是否有边框,0表示无边框(暂不支持),1表示有边框。
fontSize 字体大小0为默认大小;取值范围在(0,96)。
fontColor 字体颜色;十六进制表示的颜色,如0xFF0000为纯红色。
bgColor 标签背景颜色;十六进制表示的颜色,如0xFF0000为纯红色。
fontWeight 设置字体是否是粗体,0表示非粗体(暂不支持),1表示粗体。
标签示例:

http://api.map.baidu.com/staticimage?center=116.403874,39.914889&width=500&height=500&zoom=11&labels=海淀|116.487812,40.017524|朝阳|大红门|116.442968,39.797022|丰台|116.275093,39.935251|116.28377,39.903743&labelStyles=%E6%B5%B7%E6%B7%80,1,32,0x990099,0xff00,1|%E4%B8%9C%E5%8C%97%E4%BA%94%E7%8E%AF,1,14,0xffffff,0x996600,1|%E6%9C%9D%E9%98%B3,1,14,,0xff6633,1|%E5%A4%A7%E7%BA%A2%E9%97%A8,1,32,0,0xffffff,1|%E6%9C%AA%E7%9F%A5%EF%BC%9F%EF%BC%81%23%EF%BF%A5%25%E2%80%A6%E2%80%A6%26*%EF%BC%88%EF%BC%89%EF%BC%81,1,14,0xff0000,0xffffff,1|%E4%B8%B0%E5%8F%B0%E5%A4%A7%E8%90%A5,1,24,0,0xcccccc,1|%E8%A5%BF%E5%9B%9B%E7%8E%AF,,14,0,0xffffff,|%E6%88%91%E4%BB%AC%E4%BC%9F%E5%A4%A7%E7%A5%96%E5%9B%BD%E9%A6%96%E9%83%BD%E5%8C%97%E4%BA%AC,1,25,0xffff00,0xff0000,0

标签示例:

参数 效果展示
center:
zoom:
labels:
content:
fontSize:
fontColor:
bgColor:

5.3 折线参数

折线位置-paths

只能通过设置经纬度坐标;多个折线用竖线"|"分隔;每条折线的点用分号";"分隔;点坐标用逗号","分隔。举例:

paths=116.288891,40.004261;116.487812,40.017524;116.525756,39.967111|116.442968,39.797022;116.270494,39.851993;

折线样式-pathStyles

设置折线样式,共有4个属性。其中,如果设置了填充属性,则折线自动闭合为多边形。举例:pathStyles=0xff0000,5,1 表示宽度为5不透明的红色线段。pathStyles=0xff0000,5,1,0x00ff00 表示用绿色填充的多边形。

属性描述
color 折线颜色, 16进制颜色表示。
weight 折线粗细,3到32之间的正整数。
opacity 折线或者面的透明度0,1之间的一个小数。
fillColor 填充颜色;可选参数!注意!:如果设置了填充颜色则折线自动闭合为多边形。
折线示例

添加折线示例:

http://api.map.baidu.com/staticimage?center=116.403874,39.914888&width=500&height=500&zoom=11&paths=116.288891,40.004261;116.487812,40.017524;116.525756,39.967111;116.536105,39.872373|116.442968,39.797022;116.270494,39.851993;116.275093,39.935251;116.383177,39.923743&pathStyles=0xff0000,5,1

添加多边形示例:

http://api.map.baidu.com/staticimage?center=116.403874,39.914888&width=500&height=500&zoom=11&paths=116.288891,40.004261;116.487812,40.017524;116.525756,39.967111;116.536105,39.872373|116.442968,39.797022;116.270494,39.851993;116.275093,39.935251;116.383177,39.923743&pathStyles=0xff0000,5,0.9,0xffffff

折线示例

参数 效果展示
添加折线 添加多边形
center:
zoom:
paths:
color:
weight:
opacity: