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

请求参数

Query 参数

返回响应

🟢200成功
application/json
Body

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://restapi.amap.com/v3/staticmap?location=&zoom&size&scale&markers&labels&paths&traffic&sig'
响应示例响应示例
{}

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

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

扫码加入交流群
修改于 2025-09-24 10:03:55
上一页
概述
下一页
概述
Built with