Vue-amap文档详解

一、安装

Vue-amap提供了两种安装方式：npm安装和引入CDN文件。对于npm安装，需要按照以下步骤进行：

npm install vue-amap -S // 安装vue-amap
import VueAMap from 'vue-amap' // 引入VueAMap
Vue.use(VueAMap) // 使用VueAMap
VueAMap.initAMapApiLoader({ // 初始化AMapAPI
  key: 'your amap key', // 高德地图的key值
  plugin: ['AMap.Geolocation'] // 引入的插件
})

对于引入CDN文件，需要按照以下步骤进行：

<!-- 引入Vue -->
<script src="https://cdn.bootcdn.net/ajax/libs/vue/3.2.1/vue.global.js"></script>
<!-- 引入VueAMap -->
<script src="https://cdn.bootcdn.net/ajax/libs/vue-amap/0.14.1/vue-amap.min.js"></script>
<!-- 创建Vue实例 -->
<div id="app">
  <div id="map-container"></div>
</div>
<script>
  Vue.use(VueAMap) // 使用VueAMap
  VueAMap.initAMapApiLoader({ // 初始化AMapAPI
    key: 'your amap key', // 高德地图的key值
    plugin: ['AMap.Geolocation'] // 引入的插件
  })
</script>

二、地图组件使用

Vue-amap提供了多种地图组件，包括地图组件、POI搜索组件、行政区划组件等等。这里以地图组件的使用为例：

<template>
  <div id="map-container">
    <a-map :zoom="zoom"></a-map> // a-map组件
  </div>
</template>

<script>
  export default {
    data() {
      return {
        zoom: 10 // zoom属性
      }
    }
  }
</script>

在上述代码中，使用了a-map组件，并且设置了zoom属性的值为10。zoom属性用于设置地图的缩放级别。

三、地图事件绑定

Vue-amap提供了多个地图事件，包括click、moveend、zoomchange等等。使用地图事件需要在a-map组件上使用v-on指令绑定相应的事件。例如：

<template>
  <div id="map-container">
    <a-map :zoom="zoom" @zoomchange="handleZoomchange"></a-map> // 绑定zoomchange事件
  </div>
</template>

<script>
  export default {
    data() {
      return {
        zoom: 10 // zoom属性
      }
    },
    methods: {
      handleZoomchange(e) { // zoomchange事件处理函数
        console.log(e) // 打印事件对象
      }
    }
  }
</script>

在上述代码中，使用了@zoomchange指令绑定了handleZoomchange方法作为zoomchange事件的处理函数。处理函数可以接收事件对象e。

四、地图覆盖物

Vue-amap提供了多种类型的地图覆盖物，包括标记Marker、信息窗体InfoWindow、折线Polyline等等。这里以标记Marker为例：

<template>
  <div id="map-container">
    <a-map :zoom="zoom">
      <a-marker :position="position" title="Marker"></a-marker> // a-marker组件
    </a-map>
  </div>
</template>

<script>
  export default {
    data() {
      return {
        zoom: 10, // zoom属性
        position: [116.4, 39.9] // position属性
      }
    }
  }
</script>

在上述代码中，使用了a-marker组件作为标记覆盖物，并设置了position属性的值为[116.4, 39.9]，表示标记的经纬度。

五、高德地图API

Vue-amap封装了大部分常用的高德地图API，如全局对象AMap、地理编码服务Geocoder等等。需要在mounted生命周期函数中引入全局对象AMap，以使用高德地图API。例如：

<template>
  <div id="map-container"></div>
</template>

<script>
  export default {
    mounted() {
      const map = new AMap.Map('map-container') // 使用全局对象AMap
      console.log(map) // 打印地图对象
    }
  }
</script>

在上述代码中，使用全局对象AMap创建了地图对象，并打印了地图对象。

六、vue-amap文档转markdown

vue-amap文档转markdown是用于将Vue-amap官方文档转换为markdown格式的工具，使用该工具可以将Vue-amap官方文档方便地嵌入到代码库的README.md文件中。使用步骤如下：

1. 安装vue-amap-docs-to-md

npm install -g vue-amap-docs-to-md

2. 运行vue-amap-docs-to-md工具

vue-amap-docs-to-md --output ./docs https://elemefe.github.io/vue-amap/#/zh-cn/home

3. 将生成的markdown文件拷贝到README.md中