基于Vue3实现百度地图位置选择器组件

 更新时间:2025年04月22日 11:47:24   作者:William Dawson  
在开发前端应用时,地图选择器是一个非常常见的需求,本文将一步步展示如何使用 Vue 3 和 Element Plus 来实现一个百度地图位置选择器组件,有需要的可以参考一下

前言

在开发前端应用时,地图选择器是一个非常常见的需求。尤其是在一些需要用户选择地址的场景,如电商平台、旅游网站、酒店预定等,百度地图组件能提供准确的地理位置服务。在本文中,我们将一步步展示如何使用 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百度地图位置选择器内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue表单验证自定义验证规则详解

    vue表单验证自定义验证规则详解

    这篇文章主要为大家详细介绍了vue表单验证自定义验证规则,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-03-03
  • vue数据初始化initState的实例详解

    vue数据初始化initState的实例详解

    Vue 实例在建立的时候会运行一系列的初始化操作,而在这些初始化操作里面,和数据绑定关联最大的是 initState。这篇文章主要介绍了vue数据初始化--initState,需要的朋友可以参考下
    2019-04-04
  • Vue中引用assets中图片的实现方式

    Vue中引用assets中图片的实现方式

    这篇文章主要介绍了Vue中引用assets中图片的实现方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-10-10
  • vue导出excel多层表头的实现方案详解

    vue导出excel多层表头的实现方案详解

    这篇文章主要为大家详细介绍了vue导出excel多层表头的实现方案,文中的示例代码简洁易懂,具有一定的借鉴价值,有需要的小伙伴可以跟随小编一起学习一下
    2025-04-04
  • vue3 name 属性的使用技巧详解

    vue3 name 属性的使用技巧详解

    这篇文章主要为大家介绍了vue3 name 属性的使用技巧详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-09-09
  • Vuex2.0+Vue2.0构建备忘录应用实践

    Vuex2.0+Vue2.0构建备忘录应用实践

    这篇文章主要为大家详细介绍了Vuex2.0+Vue2.0构建备忘录应用实践,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-11-11
  • vue 简单自动补全的输入框的示例

    vue 简单自动补全的输入框的示例

    这篇文章主要介绍了vue 简单自动补全的输入框的示例,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-03-03
  • Vue作用域插槽slot-scope实例代码

    Vue作用域插槽slot-scope实例代码

    这篇文章主要介绍了Vue作用域插槽slot-scope实例代码,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-09-09
  • 一步步教你用Vue.js创建一个组件(附代码示例)

    一步步教你用Vue.js创建一个组件(附代码示例)

    组件(Component)是Vue.js最强大的功能之一,组件可以扩展HTML元素,封装可重用的代码,下面这篇文章主要给大家介绍了关于如何一步步用Vue.js创建一个组件的相关资料,需要的朋友可以参考下
    2022-12-12
  • vue开发页面自适应屏幕尺寸的实例代码

    vue开发页面自适应屏幕尺寸的实例代码

    使用vue开发的页面都是通过px设置它的尺寸,如果换了一个不同尺寸的屏幕就会出现页面排版错乱,显示不完整等情况,下面通过插件将px装换为rem单位适应不同尺寸的屏幕,需要的朋友可以参考下
    2022-12-12

最新评论