Nuxt3 简单集成 GoogleMap

本文介绍: 项目中需要做一个基于 Go o gl eMap 的地图显示，只需要显示一个地图，并在地图上标记一个地理位置即可。因为需求很简单，所以想直接通过 Googl eMap 官方的 JS API 来实现，并不想用一些二次开发的插件。

只是想用 GoogleMap 做一个指定位置的 Ma rker 显示，并不想集成别人二次开发的插件，应该怎么做？

功能 需求

项目中需要做一个基于 GoogleMap 的地图显示，只需要显示一个地图，并在地图上标记一个地理位置即可。
因为需求很简单，所以想直接通过 GoogleMa p 官方的 JS API 来实现，并不想用一些二次开发的插件。

最终效果

在这里插入图片描述

实现 步骤

安装 插件

Google Maps JavaScript API 文档中默认展现的是通过 <script> 标签进行导入的方式，这显然与我们的项目不符。
但其实在这里 Google Maps JavaScript API Dynamic Loading Package 就提供了通过 NPM 安装的实现方式，如下图：
在这里插入图片描述

所以我们只需要执行以下语句来安装插件即可：

yarn add @googlemaps/js-api-loader

因为使用的 Ty p esc rip t ，所以参考 Google Maps Using Typescript 还需要继续执行以下语句：

yarn add @types/google.maps --dev

基于 Nux t3 的关键 配置

通过上述方式安装插件并开发完成后，在 Nux t3 的开发模式下就可以完美显示地图了，但当我们构建项目并通过基于 node 环境的 SSR 模式启动项目后，访问时会抛出下图中的错误信息：

[nuxt] [request error] [unhandled] [500] Named export 'Loader' not found. The requested module '@googlemaps/js-api-loader' is a CommonJS module, which may not support all module.exports as named exports.
CommonJS modules can always be imported via the default export, for example using

在这里插入图片描述

解决方式当然不是图中这个 for example using 提到的，而是需要在 nuxt.config.ts 中添加如下代码：

build: {
  transpile: ['@googlemaps/js-api-loader']
},

渲染地图

初始化地图的方式在这里 Google Maps JavaScript API Dynamic Loading Package 有提到，具体实现如下：

&lt;template&gt;
    <div id="map" class="google-map"/&gt;
</template&gt;

<script setup lang="ts"&gt;
  import { onMounted, ref } from '#imports'
  import { Loader } from '@googlemaps/js-api-loader'

  const location = { lat: -34.397, lng: 150.644 }

  onMounted(() =&gt; {
    initMap()
  })

  const initMap = () =&gt; {
    const loader = new Loader({
      apiKey: 'AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg',
      version: 'weekly'
    })

    loader.load().then(() => {
      // 初始化地图
      const map = new google.maps.Map(document.getElementById('map'), {
        center: location,
        // 缩放级别在街道
        zoom: 15,
		// 禁用默认的工具栏
        disableDefaultUI: true
      })

      // 添加标记
      new google.maps.Marker({
        position: location,
        map
      })
    })
  }
</script>

<style lang="scss">
  .google-map {
    height: 100%;
  }
</style>