当前位置：首页 > news >正文

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

news 来源：原创 2025/9/12 10:46:58

如何在 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><BaiduMapPickerv-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 组件，提升用户体验。

小贴士

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