Uniappmap使用指南

Uniappmap是一个开源地图组件库，能够支持各类地图操作并提供大量的交互控件，如标注、导航、缩放等。本篇文章主要介绍Uniappmap的使用方式以及常见控件的应用。

一、地图初始化

在使用Uniappmap前，需要先初始化地图并获取实例化对象。Uniappmap支持常见的地图服务商，如高德地图、腾讯地图、百度地图等。我们以高德地图为例：

import uniappmap from '@/uniappmap'
const mapOptions = {
  subkey: '', // 注册高德开发者网站获取的数字签名
  gestureEnable: true, // 是否支持缩放手势
  zoomLevel: 16, // 初始的缩放级别
  showsUserLocation: true // 是否显示定位蓝点
}
onReady() {
  const map = uniappmap.createMap('map_container', 'amap', mapOptions)
}

二、地图控件

1、标注

标注是地图中非常常见的交互控件，能够为地图提供重要的信息展示。Uniappmap提供了Marker控件完成标注功能。

const markerOptions = {
  iconPath: '', // 标注的图标路径
  longitude: 104.06, // 标注的经度
  latitude: 30.67 // 标注的纬度
}
const marker = uniappmap.createMarker(markerOptions)
// 将标注展示在地图上
map.addMarker(marker)

2、导航

Uniappmap提供了Polyline控件实现导航功能，能够使用户更加方便的在地图上进行导航。

const polylineOptions = {
  color: '#ff0000', // 导航线的颜色
  width: 10, // 导航线的宽度
  points: [{
    latitude: 30.67,
    longitude: 104.06
  }, {
    latitude: 30.66,
    longitude: 104.05
  }, {
    latitude: 30.65,
    longitude: 104.04
  }], // 导航线的坐标点数组
  dottedLine: false // 是否为虚线
}
const polyline = uniappmap.createPolyline(polylineOptions)
// 将导航线展示在地图上
map.addPolyline(polyline)

3、缩放

Uniappmap提供Zoom控件实现地图缩放功能，能够让用户更加便捷的进行地图缩放。

const zoomOptions = {
  position: 'RB', // 缩放控件在地图的位置
  showScale: true // 是否显示比例尺
}
const zoom = uniappmap.createZoom(zoomOptions)
// 添加缩放控件到地图上
map.addControl(zoom)

三、地图事件

Uniappmap能够响应多种地图操作事件，如地图移动、缩放、点击等。

// 绑定地图移动事件
map.on('move', function(event) {
  console.log(event)
})
// 绑定地图缩放事件
map.on('zoom', function(event) {
  console.log(event)
})
// 绑定地图点击事件
map.on('tap', function(event) {
  console.log(event)
})

四、结语

本篇文章简单介绍了Uniappmap的使用方式以及常见控件的应用。在实际开发中，Uniappmap能够给我们带来很多便利，希望大家在掌握了Uniappmap的基础用法后，能够更加深入的应用到项目实践中。