Appearance
静态地图 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 |
请求示例
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"响应
成功响应为二进制图片数据。
响应示例
使用说明
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.98773labels
格式:
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.94858paths
格式:
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.966957trajs
格式:
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.919356background
格式:
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之间，可获得较好的地图显示效果 。