一、map介绍
1.概念
map 组件是一个嵌入式地图视图,可以显示指定区域的地图并支持多种交互操作。它通常依赖于第三方地图服务(例如高德地图、百度地图、腾讯地图等),并通过 API 获取地图数据和功能。UniApp 提供的 map 组件封装了这些 API,使得开发者能够更便捷地在应用中使用地图功能。
2. 主要功能
-
定位功能:
显示用户当前位置:通过show-location
属性,可以在地图上显示用户当前位置,通常用于需要提供实时定位的应用,如导航或共享位置的功能。 -
标记点(Markers):
在地图上标记多个位置,标记点可以自定义图标、文本等信息,通常用于表示兴趣点、商店、餐馆、景点等。 -
地图缩放:
控制地图的缩放级别,可以通过scale
属性来调整显示的范围。比如在城市级别显示或街道级别显示,缩放级别越大,地图显示越详细。 -
绘制路线(Polyline):
使用折线绘制路径或轨迹,适合显示路线图,如驾车路线、步行路线等。可以通过polyline
属性传入一系列坐标点,连接成一条折线。 -
绘制圆形(Circles)和多边形(Polygons):
可以在地图上绘制圆形或多边形区域,适用于标注特定区域或兴趣区域,比如限定的服务区域或活动范围。 -
显示当前位置:
show-location
属性用于控制是否显示当前位置的小圆点,用户可以查看他们的实时位置。 -
旋转功能:
rotate
属性允许用户旋转地图,适用于展示地图的不同角度,给用户提供更加灵活的视角。 -
3D 地图:
如果设备支持,可以通过enable-3D
启用 3D 地图视图,增强用户的沉浸感,特别适合展示具有地形变化的区域。 -
地图控件:
controls
属性允许用户自定义控件的位置,例如添加放大缩小按钮、定位按钮等,增强用户交互体验。 -
区域范围显示:
include-points
属性用于调整地图的显示区域,使得给定的多个坐标点都能显示在视野内,非常适合用于多标记的情况,确保所有标记都能被用户看到。
3. 使用场景
-
导航和路线规划:
通过标记起点和终点,绘制路线,可以帮助用户规划出行路线,尤其是驾车、步行或骑行路径。 -
位置展示:
在地图上显示某些位置的标记,帮助用户找到商店、餐馆、景点等地点。 -
地理定位和实时定位:
实时定位用户的当前位置,并在地图上展示,常用于打车、外卖、社交等应用中。 -
展示地图视角:
通过旋转、缩放地图,或者展示 3D 地图,增强用户的沉浸感,提升地图交互体验。 -
区域标注:
可以通过绘制圆形或多边形来标注特定区域,适用于某些商圈、服务区或活动范围的标注。
二、map组件中常见属性和方法
1. longitude
和 latitude
:
- 作用:定义地图显示的中心点的经纬度,地图会以此为中心显示。
- 类型:
Number
- 默认值:
0
- 使用场景:设置地图的初始位置,通常用在地图初始化时指定一个具体的经纬度。
- 示例: