如何在 Vue 3 中实现百度地图位置选择器组件

---

如何在 Vue 3 中实现百度地图位置选择器组件

前言

在开发前端应用时，地图选择器是一个非常常见的需求。尤其是在一些需要用户选择地址的场景，如电商平台、旅游网站、酒店预定等，百度地图组件能提供准确的地理位置服务。在本文中，我们将一步步展示如何使用 Vue 3 和 Element Plus 来实现一个百度地图位置选择器组件。这个组件允许用户通过地图选择位置，并展示详细的地址信息。

准备工作

在开始实现之前，我们需要确保已经安装了以下依赖：

• Vue 3：Vue.js 是我们前端应用的基础框架。
• Element Plus：一个基于 Vue 3 的组件库，提供了许多高质量的 UI 组件。
• 百度地图 API：百度地图 API 提供了丰富的地图功能接口，供我们在网页中嵌入地图，并获取地理位置信息。

安装依赖

如果你还没有安装这些依赖，可以通过以下命令安装：

npm install vue@next element-plus

同时，为了能在 Vue 项目中使用百度地图，我们需要引入百度地图的 API。在 index.html 中，添加以下代码：

<script type="text/javascript" src="https://api.map.baidu.com/api?v=3.0&ak=YOUR_API_KEY"></script>

记得将 YOUR_API_KEY 替换成你自己的百度地图 API 密钥。

实现步骤

1. 创建百度地图组件

我们先从创建百度地图组件开始，这个组件将允许用户在地图上选择位置。

1.1 创建 BaiduMapPicker.vue 组件

首先，我们创建一个 BaiduMapPicker.vue 组件，用于加载地图和处理用户选择的位置。

<template>
  <div id="map" style="height: 100%;"></div>
</template>

<script setup lang="ts">
import { onMounted, ref, watch } from 'vue';

const location = ref({
  latitude: 26.61246398970894,
  longitude: 106.59077252491133,
});

// 初始化百度地图
onMounted(() => {
  const map = new BMapGL.Map("map");
  const point = new BMapGL.Point(location.value.longitude, location.value.latitude);
  map.centerAndZoom(point, 15);
  map.addOverlay(new BMapGL.Marker(point));

  map.addEventListener('click', (e: any) => {
    location.value.latitude = e.latlng.lat;
    location.value.longitude = e.latlng.lng;
    map.clearOverlays();
    map.addOverlay(new BMapGL.Marker(e.latlng));
  });
});
</script>

<style scoped>
#map {
  width: 100%;
  height: 100%;
}
</style>

1.2 说明

• 地图初始化 ：我们通过百度地图的 BMapGL.Map 类来创建一个地图实例，传入 longitude 和 latitude 初始化地图的中心位置，并设置缩放级别。
• 点击事件：监听地图上的点击事件，用户每点击一次地图，地图会更新位置并重新标记。

2. 创建主页面，使用地图组件

接下来，我们将在主页面中使用刚刚创建的 BaiduMapPicker 组件。我们会在弹窗中展示地图，并允许用户选择位置。

2.1 创建主页面

<template>
  <Dialog v-model="dialogVisible" :title="dialogTitle" width="1000px">
    <div class="container">
      <h2>选择位置</h2>
      <BaiduMapPicker
        v-model="location"
        @update:location="handleLocationUpdate"
      />
      <div class="location-info">
        <h3>选中的位置信息：</h3>
        <p>纬度：{{ location.latitude }}</p>
        <p>经度：{{ location.longitude }}</p>
      </div>
    </div>
    <template #footer>
      <el-button @click="submitForm" type="primary">确定</el-button>
      <el-button @click="cancel" type="default">取消</el-button>
    </template>
  </Dialog>
</template>

<script setup lang="ts">
import { ref } from 'vue';
import { ElButton, ElDialog } from 'element-plus';
import BaiduMapPicker from '@/components/BaiduMapPicker.vue';

const dialogVisible = ref(false);
const dialogTitle = ref("选择地址");
const location = ref({ latitude: 26.61246398970894, longitude: 106.59077252491133 });

const handleLocationUpdate = (newLocation: { latitude: number, longitude: number }) => {
  location.value = newLocation;
};

const submitForm = () => {
  dialogVisible.value = false;
  console.log("提交的位置：", location.value);
};

const cancel = () => {
  dialogVisible.value = false;
};
</script>

<style scoped>
.container {
  padding: 20px;
}

.location-info {
  margin-top: 20px;
  background-color: #f5f7fa;
  padding: 15px;
  border-radius: 5px;
}

h2 {
  margin-bottom: 15px;
  font-size: 1.5em;
}

h3 {
  margin-bottom: 10px;
}

p {
  font-size: 1em;
  margin: 5px 0;
}
</style>

2.2 说明

• Dialog 弹窗 ：我们使用了 Element Plus 的 Dialog 组件来展示百度地图和位置信息。当用户点击"确定"时，我们可以通过 submitForm 方法提交选中的位置。
• 位置更新 ：当用户点击地图时，handleLocationUpdate 会被触发，更新 location 数据并显示在页面上。

3. 弹窗控制与位置展示

我们使用了 Element Plus 的 Dialog 组件来控制弹窗的显示与隐藏，确保用户体验良好。

const dialogVisible = ref(false); // 控制弹窗的显示
const dialogTitle = ref("选择地址"); // 弹窗标题

通过这种方式，我们实现了一个简单而直观的地址选择功能。

效果展示

3.1 位置选择

用户可以在弹窗中看到百度地图，点击任意位置，地图上的标记会随之更新，显示选中的纬度和经度。

3.2 提交结果

点击"确定"后，用户选择的经纬度数据会被提交，并可以用于后续的业务逻辑。

---

总结

通过这篇博客，我们学习了如何在 Vue 3 中使用百度地图 API 实现一个位置选择器组件。该组件不仅支持位置选择功能，还能够展示用户选择的详细地址信息。通过 Vue 3 和 Element Plus 的结合，我们能够快速开发出高质量的 UI 组件，提升用户体验。

小贴士

1. API 密钥保护：在生产环境中，记得将百度地图的 API 密钥保存在安全的地方，避免暴露在前端代码中。
2. 优化加载速度：考虑到地图加载时间较长，可以对地图组件进行懒加载，提升用户体验。

---