UniApp 内置组件:`<map>` 详解

2,011 阅读1分钟

在 UniApp 开发中,<map> 组件用于展示地图,它封装了原生的地图能力,提供了多项地图控制能力。

简介

<map> 组件是一个全功能的地图组件,支持显示位置、标记点、路线规划等功能。

示例

<map :latitude="latitude" :longitude="longitude" :markers="markers"></map>

基础属性

  • longitude:经度,范围为 -180 ~ 180。
  • latitude:纬度,范围为 -90 ~ 90。
  • scale:缩放级别,取值范围为 5-18。

控制属性

  • markers:标记点用于在地图上显示标记的位置。
  • polyline:指定一系列坐标点,从数组第一个点连线至最后一个点。
  • circles:在地图上显示圆。
  • controls:地图控件。控件不随着地图移动。

事件

  • bindmarkertap:点击标记点时触发,e.detail = {markerId}。
  • bindcallouttap:点击标记点对应的气泡时触发。
  • bindcontroltap:点击控件时触发,e.detail = {controlId}。

注意事项

  • 确保在使用 <map> 组件之前,已经向相应平台申请了地图使用权限,并正确配置了AK(Access Key)。
  • markers, polyline, circles 等属性接受数组格式,每个元素定义了相应的地图元素属性。

参考链接

在这篇文章中,我们详细介绍了 UniApp 的 <map> 组件,展示了如何使用地图和相关属性。希望本文能帮助您更好地在 UniApp 中集成和操作地图功能。