静态地图服务通过返回一张地图图片响应HTTP请求，使用户能够将高德地图以图片形式嵌入自己的网页中。用户可以指定请求的地图位置、图片大小、以及在地图上添加覆盖物，如标签、标注、折线、多边形。
静态地图在使用的过程中，需要遵守高德开放平台《自定义地图服务协议》。
服务调用量的限制请点击这里查阅。
第一步，申请”Web服务API”密钥（Key），注意这个Key是Web服务API的Key，不是Web端的Key；
第二步，拼接HTTP请求URL，第一步申请的Key需作为必填参数一同发送；
第三步，接收HTTP请求返回的数据（json或xml格式），解析数据。
如无特殊声明，接口的输入参数和输出数据编码全部统一为utf-8。
 添加默认标签 |
 添加自定义标签 |
 添加标注 |
 添加折线 |
 添加多边形 |
 调用高清图 |
https://restapi.amap.com/v3/staticmap?location=116.481485,39.990464&zoom=10&size=750300&markers=mid,A:116.481485,39.990464&key=<用户的key>
https://restapi.amap.com/v3/staticmap?parameters parameters代表请求参数，所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及使用规则。
参数名称 |
含义 |
规则说明 |
是否必填 |
默认值 |
|---|---|---|---|---|
key |
用户唯一标识 |
用户在高德地图官网申请 |
必填 |
无 |
location |
地图中心点 |
中心点坐标。 规则：经度和纬度用","分隔 经纬度小数点后不得超过6位。 |
部分条件必填 |
无 |
zoom |
地图级别 |
地图缩放级别:[1,17] |
可选 |
无 |
size |
地图大小 |
图片宽度图片高度。最大值为10241024 |
可选 |
400400 |
scale |
普通/高清 |
1:返回普通图； 2:调用高清图，图片高度和宽度都增加一倍，zoom也增加一倍（当zoom为最大值时，zoom不再改变）。 |
可选 |
1 |
markers |
标注 |
使用规则见markers详细说明，标注最大数10个 |
可选 |
无 |
labels |
标签 |
使用规则见labels详细说明，标签最大数10个 |
可选 |
无 |
paths |
折线 |
使用规则见paths详细说明，折线和多边形最大数4个 |
可选 |
无 |
traffic |
交通路况标识 |
底图是否展现实时路况。 可选值： 0，不展现；1，展现。 |
可选 |
0 |
sig |
数字签名 |
数字签名认证用户必填 |
可选 |
无 |
注：如果有标注/标签/折线等覆盖物，则中心点（location）和地图级别（zoom）可选填。当请求中无location值时，地图区域以包含请求中所有的标注/标签/折线的几何中心为中心点；如请求中无zoom，地图区域以包含请求中所有的标注/标签/折线为准，系统计算出zoom值。
格式：
markers=markersStyle1:location1;location2…|markersStyle2:location3;location4…|markersStyleN:locationN;locationM…
location为经纬度信息，经纬度之间使用",“分隔，不同的点使用”;“分隔。 markersStyle可以使用系统提供的样式，也可以使用自定义图片。
系统marersStyle：label，font ,bold, fontSize，fontColor，background。
参数名称 |
说明 |
默认值 |
|---|---|---|
size |
可选值： small,mid,large |
small |
color |
选值范围：[0x000000, 0xffffff] 例如： 0x000000 black, 0x008000 green, 0x800080 purple, 0xFFFF00 yellow, 0x0000FF blue, 0x808080 gray, 0xffa500 orange, 0xFF0000 red, 0xFFFFFF white |
0xFC6054 |
label |
[0-9]、[A-Z]、[单个中文字] 当size为small时，图片不展现标注名。 |
无 |
markers示例： https://restapi.amap.com/v3/staticmap?markers=mid,0xFF0000,A:116.37359,39.92437;116.47359,39.92437&key=您的key 自定义markersStyle： -1，url，0。
-1表示为自定义图片，URL为图片的网址。自定义图片只支持PNG格式。
markers示例 https://restapi.amap.com/v3/staticmap?markers=-1,http://ico.ooopic.com/ajax/iconpng/?id=158688.png,0:116.37359,39.92437&key=您的key
格式：
labels=labelsStyle1:location1;location2…|labelsStyle2:location3;location4…|labelsStyleN:locationN;locationM…
location为经纬度信息，经纬度之间使用”,“分隔，不同的点使用”;“分隔。
labelsStyle：label, font, bold, fontSize, fontColor, background。 各参数使用”,"分隔，如有默认值则可为空。
参数名称 |
说明 |
默认值 |
|---|---|---|
content |
标签内容，字符最大数目为15 |
无 |
font |
0：微软雅黑； 1：宋体； 2：Times New Roman; 3：Helvetica |
0 |
bold |
0：非粗体； 1：粗体 |
0 |
fontSize |
字体大小，可选值[1,72] |
10 |
fontColor |
字体颜色，取值范围：[0x000000, 0xffffff] |
0xFFFFFF |
background |
背景色，取值范围：[0x000000, 0xffffff] |
0x5288d8 |
labels示例： https://restapi.amap.com/v3/staticmap?location=116.48482,39.94858&zoom=10&size=400400&labels=朝阳公园,2,0,16,0xFFFFFF,0x008000:116.48482,39.94858&key=您的key
格式： paths=pathsStyle1:location1;location2…|pathsStyle2:location3;location4…|pathsStyleN:locationN;locationM…
location为经纬度，经纬度之间使用",“分隔，不同的点使用”;"分隔。
pathsStyle：weight, color, transparency, fillcolor, fillTransparency。
参数名称 |
说明 |
默认值 |
|---|---|---|
weight |
线条粗细。 可选值： [2,15] |
5 |
color |
折线颜色。 选值范围：[0x000000, 0xffffff] 例如： 0x000000 black, 0x008000 green, 0x800080 purple, 0xFFFF00 yellow, 0x0000FF blue, 0x808080 gray, 0xffa500 orange, 0xFF0000 red, 0xFFFFFF white |
0x0000FF |
transparency |
透明度。 可选值[0,1]，小数后最多2位，0表示完全透明，1表示完全不透明。 |
1 |
fillcolor |
多边形的填充颜色，此值不为空时折线封闭成多边形。取值规则同color |
无 |
fillTransparency |
填充面透明度。 可选值[0,1]，小数后最多2位，0表示完全透明，1表示完全不透明。 |
0.5 |
paths示例： https://restapi.amap.com/v3/staticmap?zoom=15&size=500500&paths=10,0x0000ff,1,:116.31604,39.96491;116.320816,39.966606;116.321785,39.966827;116.32361,39.966957&key=您的key