静态地图 API

静态地图API提供了获取静态地图图片的功能，可根据指定的中心点、缩放级别、图片大小等参数返回地图图片。

获取静态地图 API

接口描述

根据请求参数获取静态地图图片，支持设置地图中心点、大小、缩放级别以及标记点等。

请求方式

URL	请求方式
https://lbs.xiaojukeji.com/api/v2/staticmap	POST、GET

请求

查询参数（GET）

参数名	必选	类型	描述	示例值
key	是	string	鉴权用的 API Key	YOUR_API_KEY
location	是	string	地图中心点坐标，格式为"经度,纬度"	116.397428,39.90923
zoom	否	integer	地图缩放级别，取值范围：[4，20]，数字越大地图越详细	14
size	否	string	地图图片大小，格式为"宽度×高度"，单位像素	600*400
markers	否	string	标注点，可设置多个，使用规则见 markers 详细说明	0:116.397428,39.90923
labels	否	string	标签，使用规则见 labels 详细说明	起点,0,0,20,,:116.397428,39.90923
paths	否	string	折线，使用规则见 paths 详细说明	10,0x0000ff,1,,:116.31604,39.96491...
trajs	否	string	轨迹，使用规则见 trajs 详细说明	1,0xFF0000,,7:116.31604,39.96491...
background	否	string	背景样式，格式为"类型, 颜色"，当类型取值为2时，使用纯色背景模式	2,0x808080

请求示例

GET

curl -X GET "https://lbs.xiaojukeji.com/api/v2/staticmap?key=YOUR_API_KEY&zoom=14&location=121.426826,31.272120&size=400*400&paths=10,0x0000ff,1,,:121.429047,31.265471;121.429047,31.265471;121.429047,31.265471;121.428360,31.265360;121.428169,31.265329;121.428009,31.265310"

POST

curl -X POST "https://lbs.xiaojukeji.com/api/v2/staticmap?key=YOUR_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "zoom": 14,
  "location": "121.426826,31.272120",
  "size": "400*400",
  "paths": "10,0x0000ff,1,,:121.429047,31.265471;121.429047,31.265471;121.429047,31.265471;121.428360,31.265360;121.428169,31.265329;121.428009,31.265310"
}'

响应

成功响应为二进制图片数据。

响应示例

使用说明

markers

格式:

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

• location 为经纬度信息，经纬度之间使用","分隔，不同的点使用";"分隔。
• markersStyle 可取值-1，url，0。其中，-1表示为自定义图片（自定义图片只支持 PNG 格式），URL 为图片的网址。

示例

https://lbs.xiaojukeji.com/api/v2/staticmap?key=YOUR_API_KEY&size=660*732&markers=-1,https://s3-gz01.didistatic.com/packages-mait/img/kERlHnO4Th1722587528641.png,0:116.36994171142578,39.978111267089844&paths=6,0xea0353,1,0x245d2f,1:116.41219,39.91400;116.29701,39.98773

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；	0
bold	0：非粗体； 1：粗体；	0
fontSize	字体大小，可选值[1,72]	10
fontColor	字体颜色，取值范围：[0x000000, 0xffffff]	0xFFFFFF
background	背景色，取值范围：[0x000000, 0xffffff]	无

示例

https://lbs.xiaojukeji.com/api/v2/staticmap?key=YOUR_API_KEY&size=660*732&labels=%E6%9C%9D%E9%98%B3%E5%85%AC%E5%9B%AD,0,0,20,0x0000FF,:116.48482,39.94858

paths

格式:

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

• location 为经纬度，经纬度之间使用","分隔，不同的点使用";"分隔。
• pathsStyle：weight, color, transparency, borderWeight, borderColor。

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	否
borderWeight	边框宽度	无	否
borderColor	边框颜色。选值范围：[0x000000, 0xffffff]	无	否

示例

https://lbs.xiaojukeji.com/api/v2/staticmap?key=YOUR_API_KEY&size=660*732&paths=10,0x0000ff,1,,:116.31604,39.96491;116.320816,39.966606;116.321785,39.966827;116.32361,39.966957

trajs

格式:

trajs=trajsStyle1:location1;location2..|trajsStyle2:location3;location4..|trajsStyleN:locationN;locationM..

• location 为经纬度，经纬度之间使用","分隔，不同的点使用";"分隔。
• trajsStyle：weight, color, arrowColor, circleSize。各参数使用","分隔，如有默认值则可为空。

trajsStyle（参数名称）	说明	默认值	必填
weight	线条粗细。可选值： [1,15]	1	否
color	轨迹线颜色。 选值范围：[0x000000, 0xffffff]	0x3366FF	否
arrowColor	箭头颜色。选值范围：[0x000000, 0xffffff]	0xFFFFFF	否
circleSize	圆形节点大小。可选值： [4,10]	4	否

示例

https://lbs.xiaojukeji.com/api/v2/staticmap?key=YOUR_API_KEY&size=660*732&trajs=1,0xFF0000,,7:116.403909%2C39.915156;116.404909%2C39.916156;116.405409%2C39.916156;116.404109%2C39.919156;116.404109%2C39.919856;116.402909%2C39.919356

background

格式:

background=style,color

• style为背景模式。
• color为背景颜色。

background（参数名称）	说明	默认值	必填
style	int 1: 默认地图模式 2:纯色背景模式	1	否
color	style==2时的背景颜色 ，取值范围：[0x000000, 0xffffff]	无	否

示例

https://lbs.xiaojukeji.com/api/v2/staticmap?key=YOUR_API_KEY&size=660*732&background=2,0x808080&paths=10,0x0000ff,1,,:116.31604,39.96491;116.320816,39.966606;116.321785,39.966827;116.32361,39.966957

缓存策略

• 静态地图图片有缓存机制，相同请求参数的图片会被缓存，提高访问速度。
• 若需要获取最新地图图片，可在请求参数中添加一个随机数。

使用建议

• 在移动应用中，建议根据设备屏幕分辨率设置合适的图片大小和比例尺。
• 地图缩放级别(zoom)建议设置为10-15之间，可获得较好的地图显示效果 。