高质量静态地图服务
描述:获取指定位置的静态地图图片
支持参数:center, zoom, width, height, format, style, marker, scaleFactor等
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| center | string | 是 | 地图中心点坐标,格式:lonlat:经度,纬度 | lonlat:116.4074,39.9042 |
| zoom | number | 否 | 缩放级别 (1-20),默认15 | 15 |
| width | number | 否 | 图片宽度 (最大2048px),默认600 | 600 |
| height | number | 否 | 图片高度 (最大2048px),默认400 | 400 |
| style | string | 否 | 地图样式,默认osm-carto | osm-carto, dark-matter, positron |
| format | string | 是 | 图片格式,必须指定 | png, jpg |
| marker | string | 否 | 标记点,格式:lonlat:经度,纬度;type:类型;color:颜色;size:大小;icon:图标;icontype:图标库 支持多个标记,用|分隔 |
lonlat:116.4074,39.9042;type:awesome;color:%23ff0000;size:64;icon:marker;icontype:awesome |
| scaleFactor | number | 否 | 缩放因子 (1-2),用于高分辨率显示 | 2 |
| 样式名称 | 描述 | 适用场景 |
|---|---|---|
| osm-carto | 标准OpenStreetMap样式 | 通用地图显示 |
| osm-bright | 明亮的OSM样式 | 清晰的街道显示 |
| dark-matter | 深色主题地图 | 夜间模式、数据可视化 |
| positron | 浅色简洁样式 | 数据叠加、简洁显示 |
| klokantech-basic | 基础样式 | 简单地图需求 |
| 参数 | 可选值 | 说明 | 示例 |
|---|---|---|---|
| type | material, awesome, circle, plain | 标记形状类型,plain为无背景形状 | type:awesome |
| color | 十六进制颜色值(URL编码) | 标记颜色,需要URL编码(#号编码为%23) | color:%23ff0000(红色) |
| size | 16-128 | 标记大小(像素) | size:64 |
| icon | marker, home, star, heart, flag, circle, square, h-square, plus, minus, times, check等Font Awesome图标 | 图标类型,支持Font Awesome v6图标库 | icon:marker |
| icontype | material, awesome | 图标库类型,material使用Material Design图标 | icontype:awesome |
| text | 任意文本 | 显示文本而不是图标,会覆盖icon参数 | text:1 |
| contentsize | 数字(像素) | 内部内容(图标或文本)的高度,可选参数 | contentsize:40 |
| contentcolor | 颜色名或十六进制 | 内部图标或文本的颜色 | contentcolor:%230099ff |
| whitecircle | yes, no | 是否在内容后面显示白色圆圈,plain类型忽略 | whitecircle:no |
| shadow | auto, no | 是否在标记下方显示阴影 | shadow:no |
| shadowcolor | RGBA颜色值 | 标记阴影的颜色 | shadowcolor:rgba(0,0,0,0.3) |
| strokecolor | 颜色名或十六进制 | 标记背景形状的轮廓颜色,plain类型忽略 | strokecolor:%230077ff |