Map 地图 | AIUI | Rokid

map 使用 MVT 矢量瓦片绘制地图,并可叠加 GPX 轨迹与航点。

Map 地图

map 使用 MVT 矢量瓦片绘制地图,并可叠加 GPX 轨迹与航点。

显示指定区域

<map
  tile-url="https://tiles.example.com/{z}/{x}/{y}.mvt"
  longitude="116.397"
  latitude="39.908"
  zoom="12"
  style="width: 640px; height: 360px;"
></map>

瓦片地址必须包含 {z}、{x}、{y} 占位符。地图按最终布局尺寸绘制;布局尺寸不可用时使用 300 × 200。

叠加 GPX 轨迹

<map tile-url="https://tiles.example.com/{z}/{x}/{y}.mvt" style="width: 640px; height: 360px;">
  <map-gpx slot="overlays" src="https://example.com/route.gpx" stroke-color="#2563eb" />
</map>

未显式设置 longitude、latitude 或 zoom 时,组件会根据已加载 GPX 内容补全对应取景参数。map-gpx 也可以通过 data 提供内联 GPX XML。

属性

属性类型默认值说明
tile-urlString""MVT 瓦片模板;也支持别名 url、src。
longitudeNumber自动中心经度,限制在 -180 至 180;别名为 lng、center-longitude。
latitudeNumber自动中心纬度,限制在 Web Mercator 有效范围;别名为 lat、center-latitude。
zoomNumber自动缩放级别,取整并限制在 0 至 22。
pitchNumber0俯仰角,限制在 0 至 60。
bearingNumber0旋转角度;别名为 rotation。
map-styleJSON String内置样式地图颜色和线宽配置;别名为 style-json。

map-style 支持 background、land、water、road、building、boundary、labelPoint、lineWidth 和 pointRadius。地图样式也可通过 --map-* CSS 自定义属性设置。

没有可用于自动取景的 GPX 内容时,未设置的中心坐标和缩放级别回退为 0。

map-gpx 属性

属性类型默认值说明
srcString-GPX 文件地址;别名为 url。
dataString-内联 GPX XML;别名为 content,并优先于 src。
visibleBooleantrue是否显示覆盖层。
stroke-colorString#2563eb轨迹颜色。
stroke-widthNumber3轨迹宽度,最小为 1。
waypoint-colorString#0f172a航点颜色。
start-colorString#16a34a起点颜色。
end-colorString#dc2626终点颜色。
point-radiusNumber4点半径,最小为 2。
label-visibleBooleantrue是否显示航点标签。
label-colorString#0f172a标签颜色。