基于Vue3实现百度地图位置选择器组件
11人参与 • 2025-04-24 • Javascript
前言
在开发前端应用时，地图选择器是一个非常常见的需求。尤其是在一些需要用户选择地址的场景，如电商平台、旅游网站、酒店预定等，百度地图组件能提供准确的地理位置服务。在本文中，我们将一步步展示如何使用 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("选择地址"); // 弹窗标题
通过这种方式，我们实现了一个简单而直观的地址选择功能。
效果展示
1.位置选择
用户可以在弹窗中看到百度地图，点击任意位置，地图上的标记会随之更新，显示选中的纬度和经度。
2.提交结果
点击“确定”后，用户选择的经纬度数据会被提交，并可以用于后续的业务逻辑。
总结
通过这篇博客，我们学习了如何在 vue 3 中使用百度地图 api 实现一个位置选择器组件。该组件不仅支持位置选择功能，还能够展示用户选择的详细地址信息。通过 vue 3 和 element plus 的结合，我们能够快速开发出高质量的 ui 组件，提升用户体验。
小贴士
api 密钥保护：在生产环境中，记得将百度地图的 api 密钥保存在安全的地方，避免暴露在前端代码中。
优化加载速度：考虑到地图加载时间较长，可以对地图组件进行懒加载，提升用户体验。
到此这篇关于基于vue3实现百度地图位置选择器组件的文章就介绍到这了,更多相关vue3百度地图位置选择器内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！
赞 (0)
打赏
微信扫一扫
微信扫一扫
您想发表意见！！点此发布评论
发表评论