静态地图最后更新时间: 2024年09月25日

产品介绍

静态地图服务通过返回一张地图图片响应 HTTP 请求，使用户能够将高德地图以图片形式嵌入自己的网页中。用户可以指定请求的地图位置、图片大小、以及在地图上添加覆盖物，如标签、标注、折线、多边形。

静态地图在使用的过程中，需要遵守高德开放平台《自定义地图服务协议》。

使用限制

服务调用量的限制请点击这里查阅。

使用说明

第一步

申请【Web服务API】密钥（Key）

第二步

拼接 HTTP 请求 URL，第一步申请的 Key 需作为必填参数一同发送

第三步

接收 HTTP 请求返回的数据（JSON 或 XML 格式），解析数据

如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8。

成为开发者并创建 Key

为了正常调用 Web 服务 API ，请先注册成为高德开放平台开发者，并申请 Web 服务的 key ，点击具体操作。

功能介绍

添加默认标签

添加自定义标签

添加标注

添加折线

添加多边形

调用高清图

服务示例

https://restapi.amap.com/v3/staticmap?location=116.481485,39.990464&zoom=10&size=750*300&markers=mid,,A:116.481485,39.990464&key=<用户的key>

请求参数及用法

服务地址

URL	请求方式
https://restapi.amap.com/v3/staticmap?parameters	GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

参数名称	含义	规则说明	是否必填	默认值
key	用户唯一标识	用户在高德地图官网申请	必填	无
location	地图中心点	中心点坐标。规则：经度和纬度用","分隔经纬度小数点后不得超过6位。	部分条件必填	无
zoom	地图级别	地图缩放级别:[1,17]	必填	无
size	地图大小	图片宽度图片高度。最大值为10241024	可选	400*400
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

格式：

markers=markersStyle1:location1;location2..|markersStyle2:location3;location4..|markersStyleN:locationN;locationM..

location 为经纬度信息，经纬度之间使用","分隔，不同的点使用";"分隔。 markersStyle 可以使用系统提供的样式，也可以使用自定义图片。

系统 markersStyle：size，color，label。

markersStyle（参数名称）	说明	默认值
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 示例

默认 markers：

https://restapi.amap.com/v3/staticmap?markers=mid,0xFF0000,A:116.37359,39.92437;116.47359,39.92437&key=您的key

自定义 markers 示例

提示

自定义markersStyle： -1，url，0。

-1表示为自定义图片，URL 为图片的网址。自定义图片只支持 PNG 格式。

https://restapi.amap.com/v3/staticmap?markers=-1,https://a.amap.com/jsapi_demos/static/demo-center/icons/poi-marker-default.png,0:116.37359,39.92437&key=您的key

labels

格式：

labels=labelsStyle1:location1;location2..|labelsStyle2:location3;location4..|labelsStyleN:locationN;locationM..

location 为经纬度信息，经纬度之间使用","分隔，不同的点使用";"分隔。

labelsStyle：label, font, bold, fontSize, fontColor, background。各参数使用","分隔，如有默认值则可为空。

labelsStyle（参数名称）	说明	默认值
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=400*400&labels=朝阳公园,2,0,16,0xFFFFFF,0x008000:116.48482,39.94858&key=您的key

paths

格式：

paths=pathsStyle1:location1;location2..|pathsStyle2:location3;location4..|pathsStyleN:locationN;locationM..

location 为经纬度，经纬度之间使用","分隔，不同的点使用";"分隔。

pathsStyle：weight, color, transparency, fillcolor, fillTransparency。

pathsStyle（参数名称）	说明	默认值
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=500*500&paths=10,0x0000ff,1,,:116.31604,39.96491;116.320816,39.966606;116.321785,39.966827;116.32361,39.966957&key=您的key

静态地图 最后更新时间: 2024年09月25日

产品介绍

使用限制

使用说明

功能介绍

服务示例

请求参数及用法

服务地址

请求参数

markers

labels

paths

静态地图最后更新时间: 2024年09月25日