Vue3+nuxt+ts项目引入高德地图API实现步骤

看了好多相关的文章都没有完全贴合选用Vue3+nuxt+ts框架的,也不太靠谱,只好自己踩坑实现了

首先去高德开放平台用自己的账号申请一个key,位置如下,申请好后保存好生成的key

我们使用@vuemap/vue-amap,一个高德地图2.0版本的vue3对应封装

官方文档地址:@vuemap/vue-amap

首先进行npm安装:

bash 复制代码
// 安装核心库
npm install @vuemap/vue-amap --save

// 安装loca库
npm install @vuemap/vue-amap-loca --save

// 安装扩展库
npm install @vuemap/vue-amap-extra --save

由于我们使用了nuxt框架,组件库内部使用的插件会使用部分特殊的对象,比如process、window。因此在使用时需要根据Nuxt要求处理加载顺序和对象的默认值处理。

在根目录的utils文件夹下创建mapLoadUtil.ts文件,根据自己项目的规范在其他目录创建也可以

typescript 复制代码
// mapLoadUtil.ts
import { initAMapApiLoader } from '@vuemap/vue-amap'

export function initMapApi() {
  initAMapApiLoader({
    key: '8ebf03a11b7b41282f601df648cd0ecc'
  })
}

在nuxt配置文件nuxt.config.ts中添加或修改css引入

typescript 复制代码
// nuxt.config.ts
export default defineNuxtConfig({
  css: ['@vuemap/vue-amap/dist/style.css'],
})

在需要用到地图的页面或封装的组件中引入:

onBeforeMount中加载JSAPI。同时组件需要放入ClientOnly组件中。

html:

html 复制代码
		<!-- mapComponents.vue -->
        <div class="map-container">
          <ClientOnly>
            <ElAmap></ElAmap>
          </ClientOnly>
        </div>

js:

typescript 复制代码
import { initMapApi } from '@/utils/mapLoadUtil'
import { onBeforeMount } from 'vue'
import { ElAmap } from '@vuemap/vue-amap'

onBeforeMount(() => {
  initMapApi()
})

css:

css 复制代码
.map-container{
  height: 500px;
}

展示效果:

OK完成,剩下的就根据项目需求调整地图参数即可,具体参考高德地图JSAPI 2.0

高德地图 JSAPI 2.0

相关推荐
minge6 小时前
借助 Trae Builder 把 TypeScript 的碎片化学习记录整理成文档
typescript
uuware6 小时前
Lupine.Press + AI 助您分分钟搞定技术项目的文档网站
人工智能·前端框架
骑着小黑马6 小时前
从 Electron 到 Tauri 2:我用 3.5MB 做了个音乐播放器
前端·vue.js·typescript
ZengLiangYi1 天前
并发 401 下的 Token 刷新竞态:一个被低估的 Bug
typescript
袋鱼不重1 天前
Typescript 核心概念
前端·typescript
刮涂层_赢大奖1 天前
我把 AI 编程 Agent 变成了宝可梦,让它们在像素风办公室里跑来跑去
前端·typescript·claude
时光不负努力2 天前
编程常用模式集合
前端·javascript·typescript
时光不负努力2 天前
ts+vue3开发规范
vue.js·typescript
时光不负努力2 天前
typescript常用的dom 元素类型
前端·typescript
时光不负努力2 天前
TS 常用工具类型
前端·javascript·typescript