高德地图 API
  1. 静态地图
高德地图 API
  • 概述
  • 入门指南
  • 开发指南
    • 获取Key
    • 错误码说明
    • 流量限制说明
    • 天气对照表
    • 更新日志
    • 相关下载
    • 路径规划
      • 概述
      • 步行路径规划
      • 公交路径规划
      • 骑行路径规划
      • 驾车路径规划
      • 未来路径规划
      • 距离测量
    • 路径规划2.0
      • 概述
      • 驾车路线规划
      • 步行路线规划
      • 骑行路线规划
      • 电动车路线规划
      • 公交路线规划
    • 行政区域查询
      • 概述
      • 行政区域查询
    • 地理/逆地理编码
      • 地理编码
      • 逆地理编码
    • 搜索POI
      • 概述
      • 关键字搜索
      • 周边搜索
      • 多边形搜索
      • ID查询
      • AOI边界查询
    • 搜索POI 2.0
      • 概述
      • 关键字搜索
      • 周边搜索
      • 多边形区域搜索
      • ID搜索
    • 交通事件
      • 概述
      • 交通事件查询
    • IP定位
      • 概述
      • IP定位
    • 静态地图
      • 概述
      • 请求参数及用法
        GET
    • 坐标转换
      • 概述
      • 坐标转换
    • 天气查询
      • 概述
      • 天气查询
    • 输入提示
      • 概述
      • 输入提示
    • 交通态势
      • 概述
      • 矩形区域交通态势
      • 圆形区域交通态势
      • 指定线路交通态势
    • 轨迹纠偏
      • 概述
      • 轨迹纠偏
    • 三方数据空间检索接口
      • 概述
      • 关键字搜索
      • 多边形搜索
      • 周边搜索
      • 属性筛选
  1. 静态地图

请求参数及用法

GET
/v3/staticmap
**注:**如果有标注/标签/折线等覆盖物,则中心点(location)和地图级别(zoom)可选填。当请求中无location值时,地图区域以包含请求中所有的标注/标签/折线的几何中心为中心点;如请求中无zoom,地图区域以包含请求中所有的标注/标签/折线为准,系统计算出zoom值。
markers#
格式:
markers=markersStyle1:location1;location2..|markersStyle2:location3;location4..|markersStyleN:locationN;locationM..
location为经纬度信息,经纬度之间使用","分隔,不同的点使用";"分隔。 markersStyle可以使用系统提供的样式,也可以使用自定义图片。
系统marersStyle:label,font ,bold, fontSize,fontColor,background。
参数名称说明默认值
size可选值: small,mid,largesmall
color选值范围:[0x000000, 0xffffff]例如:0x000000 black,0x008000 green,0x800080 purple,0xFFFF00 yellow,0x0000FF blue,0x808080 gray,0xffa500 orange,0xFF0000 red,0xFFFFFF white0xFC6054
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,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。 各参数使用","分隔,如有默认值则可为空。
参数名称说明默认值
content标签内容,字符最大数目为15无
font0:微软雅黑;1:宋体;2:Times New Roman;3:Helvetica0
bold0:非粗体;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。
参数名称说明默认值
weight线条粗细。可选值: [2,15]5
color折线颜色。 选值范围:[0x000000, 0xffffff]例如:0x000000 black,0x008000 green,0x800080 purple,0xFFFF00 yellow,0x0000FF blue,0x808080 gray,0xffa500 orange,0xFF0000 red,0xFFFFFF white0x0000FF
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
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://restapi.amap.com/v3/staticmap?Key='
响应示例响应示例
{}

请求参数

Query 参数
location
string 
可选
地图中心点 中心点坐标。 规则:经度和纬度用","分隔 经纬度小数点后不得超过6位。
zoom
string 
可选
地图级别 地图缩放级别:[1,17]
size
string 
可选
地图大小 图片宽度图片高度。最大值为10241024
scale
string 
可选
普通/高清 1:返回普通图; 2:调用高清图,图片高度和宽度都增加一倍,zoom也增加一倍(当zoom为最大值时,zoom不再改变)。
markers
string 
可选
标注 使用规则见markers详细说明,标注最大数10个
labels
string 
可选
标签 使用规则见labels详细说明,标签最大数10个
paths
string 
可选
折线 使用规则见paths详细说明,折线和多边形最大数4个
traffic
string 
可选
交通路况标识 底图是否展现实时路况。 可选值: 0,不展现;1,展现。
sig
string 
可选
数字签名 数字签名认证用户必填
Key
string 
必需
用户在高德地图官网申请Web服务API类型Key
默认值:
{{Key}}

返回响应

🟢200成功
application/json
Body
object {0}

【高德地图】API开发者 微信交流群

用微信扫右侧二维码,加入【高德地图】API开发者 交流群,互助沟通

扫码加入交流群
上一页
概述
下一页
概述
Built with