Vue项目引用百度地图并实现搜索定位等功能

Tip：本篇文章为案例分析，技术点较多，所以篇幅较长，认真阅览的你一定会学到很多知识。

前言：百度地图开放平台 给开发者们提供了丰富的地图功能与服务，使我们的项目中可以轻松地实现地图定位、地址搜索、路线导航等功能。本文给大家介绍如何在vue项目中引用百度地图，并设计实现简单的地图定位、地址搜索功能。

一、效果图及功能点

先来看一下效果图

效果图看不够？ 点此 试试在线操作！（初次进入加载较慢，请耐心等待）

功能点：

  1. 挂载百度地图
  2. 封装逆地址解析函数（根据坐标点获取详细地址）
  3. 设置图像标注并绑定拖拽标注结束后事件
  4. 添加（右上角）平移缩放控件
  5. 添加（左下角）定位控件
  6. 浏览器定位（定位当前地点）
  7. 绑定点击地图任意点事件
  8. 结合element-ui实现输入提示选取地址并定位功能

二、前期准备

在正式开发之前，我们先做好以下准备：

  • 在你的vue项目中引入element-ui （引入方法 戳这）
    说明：本案例是结合element-ui进行开发，主要是为方便实现上面第8点功能，大家若是引入其他UI框架也可以，功能实现方法参照本案例自行修改即可。
  • 申请百度地图AK
    前往 百度地图开放平台控制台 ，登录百度账号，创建应用即得。

三、引入百度地图

下面介绍如何在vue项目中引入百度地图
方法一
第1步：在 index.html 中引入下面代码，注意将你的AK代入

<script type="text/javascript" src="http://api.map.baidu.com/api?v=3.0&ak=您的密钥"></script>

第2步：在 webpack.base.conf.js 添加externals.BMap配置，与entry平级，内容如下，

entry: {
  app: ['babel-polyfill', './src/main.js']
},
externals: {
  BMap: 'BMap'
}

第3步：在组件中引入BMap

import BMap from 'BMap'

方法二
我们知道，vue-cli 3.0+ 的版本已经取消了webpack.conf这些文件了，所以上面的方法就不适用了。而且，方法一在index.html中全局引入百度api，有点耗性能。更多时候我们只希望在单个组件里按需引入即可，所以下面介绍的是以封装的方法引入。
第1步：在你的项目js资源文件夹下新建loadBMap.js文件，内容如下：

/**
 * 动态加载百度地图api函数
 * @param {String} ak  百度地图AK，必传
 */
export default function loadBMap(ak) {
  return new Promise(function(resolve, reject) {
    if (typeof window.BMap !== 'undefined') {
      resolve(window.BMap)
      return true
    }
    window.onBMapCallback = function() {
      resolve(window.BMap)
    }
    let script = document.createElement('script')
    script.type = 'text/javascript'
    script.src =
      'http://api.map.baidu.com/api?v=3.0&ak=' + ak + '&callback=onBMapCallback'
    script.onerror = reject
    document.head.appendChild(script)
  })
}

第2步：在组件中引入loadBMap函数

import loadBMap from '@/<js资源文件夹>/loadBMap.js'

第3步：在mounted中调用 loadBMap()

//这里运用async/await 进行异步处理，保证BMap加载进来后才执行后面的操作
async mounted() {
  await loadBMap('您的密钥') //加载引入BMap
  ...
}

这样就在当前组件中引入百度地图 BMap 了，可以开始开发了。

四、功能解析

下面开始对上述所列 8 点功能进行详细的代码解析。
说明：本文用的是方法一引入百度地图，源码 用的是方法二
1、挂载百度地图
首先需要给地图分配一个容器，并设置宽高

<div id="map-container" style="width:100%;height:500px;"></div>

根据需求，定义data参数

data() {
  return {
    form: {
      address: '', //详细地址
      addrPoint: { //详细地址经纬度
        lng: 0,
        lat: 0
      }
    },
    map: '', //地图实例
    mk: '' //Marker实例
  }
}

初始化地图

methods: {
  initMap() {
    var that = this;
    this.map = new BMap.Map("map-container", {enableMapClick:false})  //新建地图实例，enableMapClick:false ：禁用地图默认点击弹框
    var point = new BMap.Point(113.30765,23.12005);
    this.map.centerAndZoom(point,19)
  }
},
mounted() {
  this.initMap()
}

到此，就可以在你的页面上看到地图啦！
2、封装逆地址解析函数
参考百度地图 逆地址解析 示例demo，封装一个逆地址解析函数，供下面的功能调用。

/**
 * 逆地址解析函数（根据坐标点获取详细地址）
 * @param {Object} point   百度地图坐标点，必传
 */
getAddrByPoint(point){
  var that = this;
  var geco = new BMap.Geocoder();
  geco.getLocation(point, function(res){
    console.log(res)  //内容见下图
    that.mk.setPosition(point) //重新设置标注的地理坐标
    that.map.panTo(point)  //将地图的中心点更改为给定的点
    that.form.address = res.address;  //记录该点的详细地址信息
    that.form.addrPoint = point;  //记录当前坐标点
  })
}


3、设置图像标注并绑定拖拽标注结束后事件
图像标注Marker是百度地图覆盖物类中的其中一种，它用来标识当前坐标点的位置，也就是我们在地图上所看到的小红点（当然这个点也可以自定义图标样式，这里我们不说，有兴趣的可以参考百度地图覆盖物示例 - 设置点的新图标）。
设置图像标注很简单，只需要下面两行代码

initMap() {
  ...
  this.mk = new BMap.Marker(point,{enableDragging:true}) //创建一个图像标注实例，enableDragging：是否启用拖拽，默认为false
  this.map.addOverlay(this.mk) //将覆盖物添加到地图中
}

这样你就可以在地图上看到小红点啦，接下来我们给这个点绑定拖拽事件。
拖拽事件有三类，dragstart（开始拖拽时触发）、dragging（拖拽过程中触发）和dragend（拖拽结束时触发），实际项目中我们更注重的是拖拽标注结束后的位置信息，因此我们在这给标注绑定拖拽结束后事件：

initMap() {
  ...
  this.mk.addEventListener('dragend', function(e){
    that.getAddrByPoint(e.point) //拖拽结束后调用逆地址解析函数，e.point为拖拽后的地理坐标
  })
}

注意：这里我们将代码写在上面定义的 initMap 函数中，地图初始化时一同执行即可
4、添加（右上角）平移缩放控件
百度地图提供了很多的 控件类，方便我们查看和操作地图。本案例只解析平移缩放控件NavigationControl 和 地图定位控件GeolocationControl，其他控件可 参考示例 自行学习。
下面我们先引入平移缩放控件并将其位置置于右上角：

initMap() {
  ...
  var navigationControl = new BMap.NavigationControl({ //创建一个特定样式的地图平移缩放控件
    anchor: BMAP_ANCHOR_TOP_RIGHT, //靠右上角位置
    type: BMAP_NAVIGATION_CONTROL_SMALL //SMALL控件类型
  })
  this.map.addControl(navigationControl ) //将控件添加到地图
}

附：
anchor参数解析
BMAP_ANCHOR_TOP_LEFT | 控件将定位到地图的左上角
BMAP_ANCHOR_TOP_RIGHT | 控件将定位到地图的右上角
BMAP_ANCHOR_BOTTOM_LEFT | 控件将定位到地图的左下角
BMAP_ANCHOR_BOTTOM_RIGHT | 控件将定位到地图的右下角
type参数解析
BMAP_NAVIGATION_CONTROL_LARGE | 标准的平移缩放控件（包括平移、缩放按钮和滑块）
BMAP_NAVIGATION_CONTROL_SMALL | 仅包含平移和缩放按钮
BMAP_NAVIGATION_CONTROL_PAN | 仅包含平移按钮
BMAP_NAVIGATION_CONTROL_ZOOM | 仅包含缩放按钮
5、添加（左下角）定位控件
下面我们引入地图定位控件并将其位置置于左下角：

initMap() {
  ...
  var geolocationControl = new BMap.GeolocationControl({anchor: BMAP_ANCHOR_BOTTOM_LEFT}) //创建一个地图定位控件
  geolocationControl.addEventListener("locationSuccess", function(e){ //绑定定位成功后事件
    that.getAddrByPoint(e.point) //定位成功后调用逆地址解析函数
  });
  geolocationControl.addEventListener("locationError",function(e){ //绑定定位失败后事件
    alert(e.message);
  });
  this.map.addControl(geolocationControl) //将控件添加到地图
}

6、浏览器定位
参考百度地图 浏览器定位 示例demo，进入页面，我们将坐标定位到当前所在地坐标。

/**
 * 浏览器定位函数
 */
geolocation() {
  var that = this;
  var geolocation = new BMap.Geolocation();
  geolocation.getCurrentPosition(function(res){
    if(this.getStatus() == BMAP_STATUS_SUCCESS){
      that.getAddrByPoint(res.point) //当成功时，调用逆地址解析函数
    } else {
      alert('failed'+this.getStatus()); //失败时，弹出失败状态码
    }
  },{enableHighAccuracy: true}) //enableHighAccuracy：是否要求浏览器获取最佳效果，默认为false
}

同样在initMap中调用即可

initMap() {
  ...
  this.geolocation()
}

7、绑定点击地图任意点事件
在地图上选取地址。点击地图上任意点，都将获取该点的地址信息。

initMap() {
  ...
  this.map.addEventListener('click', function(e){ //给地图绑定点击事件
    that.getAddrByPoint(e.point) //点击后调用逆地址解析函数
  })
}

8、结合element-ui实现输入提示选取地址并定位功能
最后是本案例的主要功能，输入框输入关键字搜索地址，调用百度地图LocalSearch服务进行检索。
首先，我们需要写入一个输入框。这里利用的是element-ui的 <el-autocomplete>组件，该组件提供了fetch-suggestions属性和select事件【参考文档】，方便我们把检索结果遍历显示出来并进行选择操作。

<el-autocomplete
  style="width:100%;"
  popper-class="autoAddressClass"
  v-model="form.address"
  :fetch-suggestions="querySearchAsync"
  :trigger-on-focus="false"
  placeholder="详细地址"
  @select="handleSelect"
  clearable>
  <template slot-scope="{ item }">
    <i class="el-icon-search fl mgr10"></i>
    <div style="overflow:hidden;">
      <div class="title">{{ item.title }}</div>
      <span class="address ellipsis">{{ item.address }}</span>
    </div>
  </template>
</el-autocomplete>

接下来需提供两个方法：

querySearchAsync(str,cb){
  var options = {
    onSearchComplete: function(res){ //检索完成后的回调函数
      var s = [];
      if (local.getStatus() == BMAP_STATUS_SUCCESS){
        for (var i = 0; i < res.getCurrentNumPois(); i ++){
          s.push(res.getPoi(i));
        }
        cb(s) //获取到数据时，通过回调函数cb返回到<el-autocomplete>组件中进行显示
      } else{
        cb(s)
      }
    }
  }
  var local = new BMap.LocalSearch(this.map, options) //创建LocalSearch构造函数
  local.search(str) //调用search方法，根据检索词str发起检索
}
  • handleSelect：点击选中建议项时触发的方法
handleSelect(item) {
  this.form.address = item.address + item.title; //记录详细地址，含建筑物名
  this.form.addrPoint = item.point; //记录当前选中地址坐标
  this.map.clearOverlays() //清除地图上所有覆盖物
  this.mk = new BMap.Marker(item.point) //根据所选坐标重新创建Marker
  this.map.addOverlay(this.mk) //将覆盖物重新添加到地图中
  this.map.panTo(item.point) //将地图的中心点更改为选定坐标点
}

最后再稍微处理一下autocomplete组件的下拉款样式

.autoAddressClass{
  li {
    i.el-icon-search {margin-top:11px;}
    .mgr10 {margin-right: 10px;}
    .title {
      text-overflow: ellipsis;
      overflow: hidden;
    }
    .address {
      line-height: 1;
      font-size: 12px;
      color: #b4b4b4;
      margin-bottom: 5px;
    }
  }
}

至此，我们就完成了上面所有的功能点。

附：
项目源码git地址：vue-admin-web
项目线上地址：vue-admin-web/BMap

希望本篇案列可以帮助大家了解百度地图的使用。
觉得这篇文章有用的话就点个赞吧~~么么哒(づ￣ 3￣)づ

原文地址：https://www.cnblogs.com/Marco-hui/p/12155995.html

时间： 2024-10-30 04:08:04

Vue项目引用百度地图并实现搜索定位等功能的相关文章

Vue2.0与 [百度地图] 结合使用———vue+webpack+axios+百度地图实现组件之间的通信

Vue2.0与 [百度地图] 结合使用: 1.vue init webpack-simple vue-baidu-map 2.下载axios cnpm install axios; 3.在main.js中引入axios,并使用 import axios from 'axios' /* 把axios对象挂到Vue实例上面,其他组件在使用axios的时候直接 this.$http就可以了 */ Vue.prototype.$http = axios; 4.引入百度地图的js秘钥--->最好在inde

百度地图实现普通地图、定位、周边搜索功能

注意:此Demo是用Android Studio实现的 //--------------一下是普通地图的实现----------------------------------- 1:打开百度地图APi进去,如果没有注册过的需要注册,注册过的登录进入 2:点击开发--Android地图SDk--点击获取密钥--点击创建应用--然后你就创建一个新的项目3:打开你项目下的res--values--string.xml把项目名:比如BaiDuMap复制到应用名称中去4:应用类型选择:Android S

JSP界面引用百度地图获取坐标

需求: 需要在JSP界面上引用百度地图,文本框中输入地址之后,自动拿到在百度地图上的经纬度 解决步骤: 1.引入百度地图api: head中进行引用<script type="text/javascript" src="http://api.map.baidu.com/api?v=1.3"></script> 1.3以上版本需要key,有点麻烦 2.html body内部定义容器来放置地图: <div id="containe

ionic cordova 引用百度地图以及利用手机GPS定位

首先引入百度地图 在html文件里面加入 <head> <script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=你的密钥"></script> //申请一个百度密钥,建议申请浏览器版的比较方便测试 </head> <body> <button id = "getPosition"&g

百度地图调用和搜索

这个是搜索地理位置,有个以输入框,单击搜索,可以直接搜到你想去的位置.相当于地图搜索. 1 <html xmlns="http://www.w3.org/1999/xhtml"> 2 <head> 3 <meta http-equiv="Content-Type" content="text/html; charset=gb2312" /> 4 <title></title> 5 6 &

如何利用【百度地图API】进行定位？非GPS定位

原文:如何利用[百度地图API]进行定位?非GPS定位 如果你可以上网,如果你有火狐浏览器,那么恭喜你.你能很容易使用以下代码进行定位! ------------------------------------------------------------------------------- 百度地图API是一套由JavaScript语言编写的应用程序接口,它能够帮助您在网站中构建功能丰富.交互性强的地图应用程序. 其中,有Geolocation这个类,可以帮助你进行定位. 它的原理是,利用

Arcgis andoid开发之应用百度地图接口实现精准定位与显示

怀着激动.兴奋的心情,在这个漫天柳絮的季节写下了这片博文,为什么呢,因为困扰我很久的一个技术性的问题得到了解决,发次博文,供大家参观.学习,同时,也以慰藉我长期困扰的心情,好了,废话不再,言归正传,看看这到底是个什么东西? 首先,简单地介绍一下功能:1.离线地图的加载:2.GPS的定位与显示.文字比较模糊,看看实际的效果图: 功能其实很简单,下面解释一下实现思路: 1.布局 <?xml version="1.0" encoding="utf-8"?> &

HTML5调用百度地图API进行地理定位实例

自从HTML5的标准确定以后,越来越多的网站使用HTML5来进行开发.虽然对HTML5支持的浏览器不是很多,但是依然抵挡不了大伙对HTML5开发的热情.今天为大家带来的是使用HTML5调用百度地图API进行地理定位实例.请看下面代码: <!DOCTYPE html> <html> <title>HTML5调用百度地图API进行地理定位实例</title> <head> <meta http-equiv="Content-Type&

Vue中使用百度地图——根据输入框输入的内容，获取详细地址

知识点:在Vue.js项目中调用百度地图API,实现input框,输入地址,在百度地图上定位到准确地址,获得到经纬度 参考博客:  百度地图的引用,初步了解参考博客:http://blog.csdn.net/docallen/article/details/70877925 详细功能修改参考博客: https://www.cnblogs.com/NearTheSea/p/6808093.html 效果图:在input输入框中,输入要查询的地址,搜索出相关的名字 选中详细地址,地图定位到详细地址