Vue3使用高德地图

Vue3 使用高德地图 JSAPI 2.0 的完整教程:申请 Key、安装 Loader、封装地图组件

在 Vue3 项目中使用高德地图 JSAPI 2.0,官方推荐通过 @amap/amap-jsapi-loader 按需加载地图脚本。本文介绍从申请 Key 到封装组件的完整流程。

官方文档

申请高德 Key

  1. 打开 高德开放平台 并登录
  2. 创建应用,服务平台选择「Web端(JS API)」
  3. 获取 Key 与安全密钥(新版需要配置代理服务或安全密钥,用于 JSAPI 2.0 鉴权)

安装 Loader

npm i @amap/amap-jsapi-loader

使用

<!-- MyMap.vue -->
<template>
  <div :id="state.id"></div>
</template>
<script setup lang="ts">
import { onMounted, reactive } from "vue";
import AMapLoader from "@amap/amap-jsapi-loader";
const props = defineProps({
  modelValue: null, // 坐标
});
const state = reactive({
  id: "",
  map: null as any,
});
const initMap = () => {
  state.id =
    Math.random().toString(36).substring(7) + Math.floor(Math.random() * 100);
  AMapLoader.load({
    key: "", // 申请好的Web端开发者Key,首次调用 load 时必填
    version: "2.0", // 指定要加载的 JSAPI 的版本
    plugins: ["AMap.Scale", "AMap.Marker"], // 需要使用的的插件列表
  })
    .then((AMap) => {
      state.map = new AMap.Map(state.id, {
        //设置地图容器id
        viewMode: "3D", //是否为3D地图模式
        zoom: 18, //初始化地图级别
        center: props.modelValue, //初始化地图中心点位置
        doubleClickZoom: false, // 禁止双击放大地图
        layers: [],
      });
      if (state.map) {
        //   比例尺
        const scale = new AMap.Scale({
          visible: true,
        });
        state.map.addControl(scale);
        // 点
        const marker = new AMap.Marker({
          position: props.modelValue,
        });
        state.map.add(marker);
      }
    })
    .catch((e) => {
      console.log(e);
    });
};
onMounted(() => {
  initMap();
});
</script>
<style lang="less" scoped>
#container {
  padding: 0px;
  margin: 0px;
  width: 100%;
  height: 800px;
}
</style>

代码说明

  • 随机容器 id:每次初始化生成随机 id 并作为容器,避免多实例(如列表循环)时 id 冲突导致地图渲染异常
  • AMapLoader.load:按需加载 JSAPI 脚本,key 填入申请到的 Web 端 Key,version 指定版本,plugins 声明需要使用的插件
  • new AMap.Map:创建地图实例,center 传入经纬度数组(如 [116.39, 39.9]),viewMode: "3D" 开启 3D 视角
  • AMap.Scale / AMap.Marker:通过 addControl 添加比例尺,通过 add 在地图上添加标记点

页面中使用

<template>
  <MyMap v-model="[116.397428, 39.90923]" />
</template>

注意:AMap.Map 必须在容器已挂载且有宽高后创建,因此初始化逻辑放在 onMounted 中执行;如果容器是异步渲染(如弹窗),需要等 DOM 渲染完成后(nextTick)再调用。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注