静态地图 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，数值越大地图越详细。指定 location 但未指定 zoom 时默认使用 8；未指定 location 时由最佳视野决定缩放级别	14
size	否	string	地图图片大小，格式为“宽度高度”，单位为像素；默认值为 400 400	600*400
markers	否	string	标注点，可设置多个，使用规则见 markers 详细说明	small,,A:116.397428,39.90923
labels	否	string	标签，使用规则见 labels 详细说明	起点,0,0,20,0xffff00,: 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	背景样式，格式为“类型,颜色”。1 为普通地图，2 为纯色背景；仅在类型为 2 时颜色生效	2,0x808080

注意：未传markers、labels、paths、trajs等覆盖物相关参数时，需传location参数

请求示例

GET

shell

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

shell

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"
}'

响应

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

响应示例

静态地图示例

使用说明

通用规则

坐标统一使用“经度,纬度”顺序。
location 为经纬度，经纬度之间使用","分隔，不同的点使用";"分隔。
多组不同样式使用 | 分隔。
颜色可使用 0xFFFFFF、0XFFFFFF、#FFFFFF。在 URL 查询参数中使用 # 时需进行 URL 编码，建议使用 0x 前缀。
URL 查询参数中包含 #、|、;、空格、中文或换行等保留字符时，需要进行 URL 编码。

markers

格式:

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

普通 marker：markersStyle 为 size,color,label，各字段使用","分隔。

markersStyle（参数名称）	说明	默认值	必填
size	marker 大小；可选值：small、mid、large	small	否
color	marker 颜色，取值范围：[0x000000, 0xFFFFFF]	0xFC6054	否
label	marker 中的标注内容；可选值：[0-9]、[A-Z]、单个汉字。当 size 为 small 时，不展示标注	无	否

自定义图片 marker：markersStyle 为 -1,imageUrl,label。
- 图片地址必须以 http:// 或 https:// 开头；
- label 为 0 或空时不显示文字，其他值会在图标下方显示文字，支持使用 %0A 或 \n 换行；
- 自定义图片仅支持 PNG 格式，服务获取的图片大小限制约为 20 KB。

示例

普通 marker

https://lbs.xiaojukeji.com/api/v2/staticmap?key=YOUR_API_KEY&size=660*732&markers=large,0xcceecc,停:116.37359,39.92437:116.36994171142578,39.978111267089844&zoom=14

自定义图片 marker

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&zoom=14

labels

格式:

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

labelsStyle：content,font,bold,fontSize,fontColor,background。各参数使用","分隔；可使用空字段保留默认值。%0A 或 \n 会作为换行处理。

labelsStyle（参数名称）	说明	默认值
content	标签内容；显示标签时必填	无
font	字体 0：思源黑体； 1：思源宋体； 2：Times New Roman； 3：Arial	0
bold	0：非粗体； 1：粗体；	0
fontSize	字体大小，可选值[1,72]	10
fontColor	字体颜色，取值范围：[0x000000, 0xffffff]	0xFFFFFF
background	背景色；空字符串表示透明，无效颜色也按透明处理	无

示例

https://lbs.xiaojukeji.com/api/v2/staticmap?key=YOUR_API_KEY&size=660*732&zoom=14&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..

pathsStyle：weight,color,transparency,borderColor,borderWeight。各参数使用","分隔；可使用空字段保留默认值。

pathsStyle（参数名称）	说明	默认值	必填
weight	线条粗细。可选值： [2,15]	5	是
color	折线颜色。选值范围：[0x000000, 0xffffff]	0x29B395	否
transparency	透明度。可选值[0,1]，0表示完全透明，1表示完全不透明。	1	否
borderColor	边框颜色。选值范围：[0x000000, 0xffffff]	0x0000FF	否
borderWeight	边框宽度，可选值：[0,5]	0	否

示例

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&zoom=14

trajs

格式:

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

trajsStyle：weight, color, arrowColor, circleSize。各参数使用","分隔，如有默认值则可为空。

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

示例

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&zoom=14

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=14

使用建议

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

静态地图 API ​

获取静态地图 API ​

接口描述 ​

请求方式 ​

请求 ​

查询参数（GET） ​

请求示例 ​

响应 ​

响应示例 ​

使用说明 ​

通用规则 ​

markers ​

格式: ​

示例 ​

labels ​

格式: ​

示例 ​

paths ​

格式: ​

示例 ​

trajs ​

格式: ​

示例 ​

background ​

格式: ​

示例 ​

使用建议 ​

静态地图 API

获取静态地图 API

接口描述

请求方式

请求

查询参数（GET）

请求示例

响应

响应示例

使用说明

通用规则

markers

格式:

示例

labels

格式:

示例

paths

格式:

示例

trajs

格式:

示例

background

格式:

示例

使用建议