百度LBS地图的Web端开发实战

╰半夏微凉° 2021-09-10 08:16 352阅读 0赞

百度地图API以开放形式提供给开发者，完全免费，可以直接使用，无需商业授权。  
这次教程我们主要讲解百度地图的地图展示、本地检索、逆/地理编码、覆盖物、城市列表等关键功能。

### 0.效果图展示 ###

![1179389-c5392e477f4fc0de][]

这里写图片描述

![1179389-63251490211137c7][]

这里写图片描述

介绍一下：

1.  点击地理位置的tab展示百度地图，如果店铺设置了地理位置，那么直接定位；否则，通过IP进行默认地址定位（这一点有待改善，我处在洛阳，但根据IP定位到了郑州）。
2.  通过城市列表和本地检索，可以直接定位到想要的地址，找到坐标后，会在地图上有一个红色位置的marker。
3.  右键marker，可以进行ajax请求的位置设置。

ps：如果你的项目不需要这些功能，那么这篇文章你可以跳过了。

### 1.异步加载百度地图 ###

使用百度地图前，需要申请一个[申请密钥（ak）][ak]。

jsp页面上构造地图的tab。

<li class="active">
        <a href="#address" data-toggle="tab" map_url="http://api.map.baidu.com/api?v=2.0&ak=<%=Variables.baidu_map_key%>&callback=initializeMap">地理位置</a>
    </li>
    
    <div class="tab-pane active" id="address">
        <input type="hidden" id="lbs_point" value="${lbs_point}">
        <div id="map-markers" style="width: 100%; height: 470px; overflow: hidden; margin: 0; font-family: '微软雅黑';"></div>
    </div>

解释一下：

1.  map\_url中地图的版本为2.0，ak参数为后台配置的密钥，callback设置地图的异步加载。
2.  lbs\_point为店铺的定位坐标（eg：112.42757,34.630966）。
3.  map-markers为展示地图的div。

js进行异步加载：

$('a[data-toggle="tab"][href="#address"]').on('shown.bs.tab', function(e) {
        var $tab = $(e.target);
    
        var $script = $("#bdmapscript");
    
        if ($script.size() == 0) {
            YUNM.debug("开始加载默认地图");// 封装了 console.log
    
            $script = $('<script id="bdmapscript"></script>').attr("src", $tab.attr("map_url")).appendTo("body");
        }
    
    });
    
    function initializeMap() {
        var map = new BMap.Map('map-markers');
        ...
    }

解释一下：

1.  shown.bs.tab为bootstrap 的tab切换时的事件监听。
2.  通过为script 赋值src可以进行百度地图的api异步加载。
3.  initializeMap方法为地图首次加载后的关键执行方法，具体内容，我们随后一步步解释。

### 2.初始化地理位置 ###

// 页面上传递的店铺定位地址（eg：112.42757,34.630966）
    var lbs_point = $("#lbs_point").val();
    if (lbs_point && lbs_point.indexOf(",") != -1) {
        var points = lbs_point.split(",");
        var point = new BMap.Point(points[0], points[1]);
    
        map.centerAndZoom(point, 15);
        
        addMarker(point);// 之后介绍
    } else {// 没有坐标的情况下使用百度地图的“本地IP定位”服务
        function myFun(result) {
            var point = result.center;
            map.centerAndZoom(point, 15);
            
            addMarker(point);// 之后介绍
        }
        var myCity = new BMap.LocalCity();
        myCity.get(myFun);
    }

解释一下：

1.  lbs\_point为店铺的定位地址，通过Point对象可直接设置地图的中心点。
2.  当店铺首次定位时，根据LocalCity对象，获得由IP定位的中心点。
3.  centerAndZoom方法执行后，地图就可以展示出来了；第一个参数为中心坐标点，第二个参数为地图的缩放级别，目前设置为15；这个方法特别关键，没有该方法地图是不会展示的。

### 3.添加point的覆盖物marker（红色那个水滴，反的） ###

解释一下：

1.  updateLocationMarker为右键菜单事件，具体执行内容在ajaxToUpdateLoaction方法中。之后介绍。
2.  marker为point的标注，是一个覆盖物；设置拖拽后，可通过拖拽，重新定位店铺地址。
3.  markerMenu 为右键菜单。

### 4.添加定位控件 ###

var geolocationControl = new BMap.GeolocationControl();
    geolocationControl.addEventListener("locationSuccess", function(e) {
        map.clearOverlays();// 移除所有覆盖物
        addMarker(e.point);// 重新添加定位后的坐标点
    });
    geolocationControl.addEventListener("locationError", function(e) {
        // 定位失败事件
        YUNM.debug(e.message);
    });
    map.addControl(geolocationControl);

### 5.城市列表 ###

var size = new BMap.Size(10, 20);
    map.addControl(new BMap.CityListControl({
        anchor : BMAP_ANCHOR_TOP_LEFT,// 显示在地图的左上角
        offset : size,// 偏移
    }));

这个组件很实用，但需要吐槽的是百度很不厚道，详细可看下图对比。

API提供的城市列表：

![1179389-2727b53dc008de67][]

这里写图片描述

[百度地图官网的城市列表][Link 1](又见莆田)：

![1179389-ed31d40d27587f0f][]

这里写图片描述

用人家的嘴短，不说了。

### 6.自定义本地检索框 ###

// 定义一个控件类，本地检索框
    function SearchControl() {
        // 默认停靠位置和偏移量
        this.defaultAnchor = BMAP_ANCHOR_TOP_LEFT;
        this.defaultOffset = new BMap.Size(10, 50);
    }
    
    // 通过JavaScript的prototype属性继承于BMap.Control
    SearchControl.prototype = new BMap.Control();
    
    // 自定义控件必须实现自己的initialize方法,并且将控件的DOM元素返回
    // 在本方法中创建个div元素作为控件的容器,并将其添加到地图容器中
    SearchControl.prototype.initialize = function(map) {
        // 创建一个DOM元素
        var map_searchbox = $('<div><div class="input-group input-group-sm" id="map_searchbox" style="width: 225px;">'
                + '<input class="form-control" type="text">' + '<span class="input-group-btn">'
                + ' <button type="button" class="btn btn-info btn-flat"><i class="fa fa-search"></i></button>' + '</span>' + '</div></div>');
    
        map_searchbox.find("button").click(function(e) {
            map.clearOverlays(); // 清除地图上所有覆盖物
            function myFun() {
                var pp = local.getResults().getPoi(0).point; // 获取第一个智能搜索的结果
                map.centerAndZoom(pp, 15);
    
                addMarker(pp);
            }
            var local = new BMap.LocalSearch(map, { // 智能搜索
                onSearchComplete : myFun
            });
            local.search(map_searchbox.find("input").val());// 检索输入的关键字
        });
    
        // 添加DOM元素到地图中
        map.getContainer().appendChild(map_searchbox.get(0));
        // 将DOM元素返回
        return map_searchbox.get(0);
    };
    // 创建控件
    var mysearchControl = new SearchControl();
    // 添加到地图当中
    map.addControl(mysearchControl);

注释解释的很清楚了，不再赘述。  
检索一下洛阳的王城公园吧！  
洛阳牡丹甲天下，对，这个季节，是该来凑个热闹！  
王城公园里的牡丹数量不算少。

![1179389-f6377f127e0b1c7a][]

这里写图片描述

### 7.逆地址解析 ###

先来看两幅图:

![1179389-cc40329fb2d7ebd6][]

这里写图片描述

![1179389-63251490211137c7][]

这里写图片描述

左键选中坐标后，右键在marker上点击可显示“设为店铺地址”的右键菜单，之后左键该菜单，弹出确认对话框。  
我们可以看到，“河南省洛阳市西工区中洲中路310号”，这段文字正是对point的逆地址解析。

好了，这篇文章先介绍到这。  
之后打算介绍一下百度地图的LBS云检索，请持续关注。

[1179389-c5392e477f4fc0de]: /images/20210809/b7952dcc7a2d4958906b71ac7ca27cac.png
[1179389-63251490211137c7]: /images/20210809/786a89cb1d3b48de838a37829d86bc95.png
[ak]: https://link.jianshu.com?t=http://lbsyun.baidu.com/apiconsole/key?application=key
[1179389-2727b53dc008de67]: /images/20210809/3379db780e2e4cf2853951b319fbb8e3.png
[Link 1]: https://link.jianshu.com?t=http://map.baidu.com/
[1179389-ed31d40d27587f0f]: /images/20210809/c27edc5a55444a918d6df48ed04d1919.png
[1179389-f6377f127e0b1c7a]: /images/20210809/ff3bb9afdbdf442c890d279ac8e93c2e.png
[1179389-cc40329fb2d7ebd6]: /images/20210809/a547989032974eba862071fe4511e202.png