百度地图API开发的快速使用和添加大量坐标点的几种方法
百度地图API的基本使用，包括基本的操作，点的添加，控件的添加，地图logo的隐藏。文章主要聚焦在使用百度地图进行开发时，添加大量点的几种解决方案，包括使用点聚合，使用官方提供的海量点，还有使用mapv进行大量点的操作。不同的方案各自有优缺点。在使用时也可能会遇到一些坑点，文章也有提到。
快速上手
注意：本篇文章代码是基于 百度地图 JavaScript API v3.0 的条件下编写，GL版本可能稍有变化。
地图嘛，很重要的一部分就是坐标经纬度了：
经度： 英文 longitude 缩写 lng；纬度：英文 latitude 缩写 lat
基本使用
在使用百度地图的API之前，首先要有一个先密钥（ak）才能开始使用。没有的话可以免费申请。
1.引入js(该ak是mapv中示例的ak,需要测试的朋友可以使用)
<script src="//api.map.baidu.com/api?v=3.0&ak=1XjLLEhZhQNUzd93EjU5nOGQ"></script>
或者使用npm
$ npm install vue-baidu-map
import BaiduMap from \'vue-baidu-map\'
Vue.use(BaiduMap, {
ak: \'你申请的key\'
})
2.初始化地图
<template>
<div class="map-box" style="height:100%">
<!-- 准备容器 -->
<div class="baidu-map" id="baiduMap"></div>
</div>
</template>
<script>
export default {
data() {
return {
// base64自定义坐标图形
bluePoint:
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAmCAYAAAClI5npAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAaJSURBVFhHrVdbTFRXFN1nHszo8CiIw0sBkRZR8IEPqFgq1aZYaRNt0h9N9KPpR1NrP2jaSKo1mtrETz/8ME0f/OhP04oQ2qatVEWtgtTCiCAgzsDwUJFhHJi5c+d07+uc6Z3LMDzsSnbOmX3OPWvtfc7dZy6D2WMuc3mwnRGzWVQ7R/zW+gWpljyqmGgCtETs/PnzptLS0uUWiyXLYDCko8/ybAhckiT1j42NdZ4+fdpx9OhRGX1aQRGFRBIwhfjAgQOG48ePr0XiCp1Ol4Q+I5oBTUcTEAHOuR9bnyzL9/r7+y/s37/f0djYSKTCBMKEaAWof1OfHTlyxFhdXb2f6Q3rXT5m/OEuz6jthpyOR2B1eWEhzuFJZnhaaAXn3lXQuTUTHi7Ug9/vly5XVVWdO3XqFAmbVsR0Aigy1tzcbC0sLHzXIxvX1tj40m9uwxr7OCRxYNrnFBgZlzekQt97a6H9jWwYYQHpUlNT04/l5eXjOKwWEVGA6FOr6+vry8rIyHhnIqBb8clFWFffDSs8EjM/mxIdiWbu3v0i2D7fDK1GkBpRRD2KcONQAC1MhF7pPgMRK3by5Enztm3bduBBW/3Rr7Cx9h4UTMosRpk1C0z6Wcydx7DYLYG8fZneEBcX9+D+/fvDNpstFLmAOEQhcrJdu3alI3net22QXd8D+b4AowM3J5CIH7sgv8kBaQkJCWVbtmyh7AkOgtIKAQKsoqJCn5ycvOypxFK/vg2rvXOIXIsRD8Rf6IElwAyrKisrU9ElyENQC1DUFRcXG00m00s/dUOa0w3xU3I2B8ic6W4MQlrPGCy0Wq0bcnNzlcMdNAXCEUJKSooxJiZmSfMQS56QYd7RC/SNQZLzKZjMZnMeFitBLjiZ9gzo9AjGWNLgOLf45bnvvRZUK/AwGnDZVJ/Pp86AIkK9BQomJycVITIH3fOkXyCANYNj4cCuPhAIKKRqaDPA3G43YFmVzAbw67CnjD4HjDou6xlwLNHeoIAwEVMyMDAwEMA6OpQdDy4jltSge95YtADGE83gw/3vw3tk2joQgsPhkL1er/2VpTBkMYI36J43chPh4dI4mHS5XHeHhoaC3v8gBJAyRR2WTT9WLdvmNLl/xSIYxuzNextMei6VpIEz2Sw5z549eyvoDoM2A3xkZCRgt9sfGVngcdVGaI3RgxQcmzOsC8G1Ow8c3omJXrzYnqIrFKjAlC1A8J07dzpxK66XZnDnh+vhLwPecsGxWcOk49IH6+BWlkXqra2t/a2mpoa2c0o26TISp1Ld6mJjY0c3bdqU/uoyE+scBVPXY7BOdw1roWM8sHcl3Koq5m0Ou/3PY8eOdfT29tKBFv+UQpkQtyEtrF6cXbp0yZ+amjqwZnXh0nyrkV3ph+RHkyw2OB4V5VnQ+eVWdktyP7l94sSJ33H/Peimq1hcxyITXC1A3dLWsIaGBm9BQcFw2caC1R4f8JYhSJ3pZlwSxx+dLIerWRY+XlPz/dnDhw8/RDdFHklAGLHaSBgZkRnwrdgZb818bV8dlF13wjKqbuifAjr1n26Cy++v5T19Pffq8/LyLqKbDrFIvxBALSGUATXE4kIMeDyewYrtW9NWppigEe93/G+4gPxqUNXE2tH98UbWLrmGm0pKSn7BqiqIxd4Twtopr6HGFNXnzp0bx9foSpHV/6D6ZbgWF8Mn0B8GfOXGDhZBWwKM3zlz5swfg4ODFLk6ajLRD0GbgYipxcrIsDa48M+KZX1m7As+DtLVfsjE6cp8KlbVm+HKm9lyx82bN34+dOiQAysfRU+EInqRdkJIRDQBoS2gFl8j3tXV5Xj7rcrMonST4ZoTEvrdLJEGK5eDrboE/hkeHGjat2/fzc7OToqeCNVGCIueEGkLRKs2isKPX0Ye/NhoiI0JeA5ugNuLF3BXXhJ3flUGLXqQn9TV1d1sbW31BecLYvU6BNEqiJhyhIiejESSUbaUFrNRmpK+ZMd3Nn1+kRVGi6zc3tFhq8VviGYcJ1IhQJv+MPJoUJMTMX2KmdDo9Mfm5OQk4HfD63g2vsA35LP29vZi9Meh0bci/fulufSMEE1rRYT2DKgx3UN8dHSUt7W1DSYmJtpaWlr+3rNnjx2FiKhFxKIvLCKmVYYQY6IVkWhNLC6I1MQEdX8KaIFoEOOiVadT+6wgUhOq+xExkwCCljCaAG0blZwwGwEC6rnTPacmnJGcMF8BM2FW5P8HSNRchGkA8C8q47x5NndS7gAAAABJRU5ErkJggvfhCGswx9rrFnP1jE1YDrlwePFofvSFACYc+EVrqiTU376zZXd0rmv2gXFqbfb9wBxrxBBLDrlNPof7EwIY3TypbV9FqN26u62zj0gf2ucW4uNR4DPH2hmLIZYccmNxN+DjxD3g5gkQYOwkzTIN+n29a+1969nyXU9RDJ851oghlhzPj5xujqmvYsAUxvXYvucyI8SYe+D+E0pbXZ3+SvpruwjX4/dJt67Y63cv1W3bPQUQ4CJiccC1Y98zeIAHu3kXEHC3t1t87ay/XH4VY1+Yz7ufNWK8cJPHuSMmOuBg5wSye3zvhNvqynEtHVvWZ/alDN63L+DRcKCd3X7ddt85hk+ZuHPHTAE+RWF8F+HGcaytrqjTLd6zytKRPXB2i517UTc24oWbuwczBQCmo0UBfs1/HKRpOlEsFo82C3MFAC8UfcY474gF3Y/z87BQQCwOCefv4c00L8LoZx5FzMNCASAWjP4sRBHRX4R7CgCzCjfTYqGDFgfzexMwjzyazzmivwgH6oAjhlLA7xHOuLl2MEj/AQToURVmBwjWAAAAAElFTkSuQmCC"
}
},
methods: {
init() {
const map = new BMap.Map(\'baiduMap\', {
// 地图是否可点击
enableMapClick: false,
// 坐标类型 3为gcj02坐标，5为bd0ll坐标，默认为5
// 如确认坐标正确，但是点出不来，或者位置错误。则确认下类型
coordsType: 5
})
// 一个点对象，包含坐标及名称
const center = {
name: \'温州市人民政府\',
lng: \'120.705832\',
lat: \'28.00032\'
}
// 初始化地理坐标 存放地理坐标的对象
const point = new BMap.Point(center.lng, center.lat)
// 初始化地图 将点设置为地图的中心点 设置初始缩放等级
map.centerAndZoom(point, 12)
// 其它地图配置
map.enableScrollWheelZoom(true) // 开启鼠标滚轮缩放
map.enableDragging() // 拖拽
}
},
mounted() {
this.init()
}
}
</script>
如此就能看到一个百度地图了，但是除了地图啥都没有。
添加点（标记）
在百度地图中添加的点又叫覆盖物，它可以添加很多的覆盖物:
添加覆盖物使用addOverlay()方法，下面写一个添加单个点的方法：
makePoint(map, data) {
// Point(lng: Number, lat: Number) 经度在前
const MAPPoniter = new BMap.Point(data.lng, data.lat)
// 创建图像标注实例 默认样式是个红点 可进行设置
// 这里设置为data中的一base64蓝色点图片
const blueIcon = new BMap.Icon(this.bluePoint, new BMap.Size(32, 38))
const MAPMarker = new BMap.Marker(MAPPoniter, { icon: blueIcon })
// 设置标签 内容 偏移量
const label = new BMap.Label(data.name, {
offset: new BMap.Size(-27, 32)
})
// 标签样式
label.setStyle({
border: \'none\',
background: \'#ACACAC\',
fontSize: 20,
fontWeight: \'bold\',
color: \'red\'
})
// 设置标签
MAPMarker.setLabel(label)
// 设置 hover 时显示的点的名称
MAPMarker.setTitle(data.name)
// 点击事件监听
MAPMarker.addEventListener(\'click\', function (e) {
console.log(e)
})
// 在地图中添加覆盖物
map.addOverlay(MAPMarker)
}
一般设置setLabel和setTitle二选一吧，要直接显示出信息的时候就用setLabel。
在init()中调用该方法：
init(){
...
this.makePoint(map, center)
}
添加控件
百度地图中还可添加一些辅助的控件，比如比例尺，缩放控件等。
init(){
// ......省略之前代码
// 添加缩放控件
const navigation = new BMap.NavigationControl({
anchor: BMAP_ANCHOR_BOTTOM_RIGHT,
type: BMAP_NAVIGATION_CONTROL_SMALL
})
map.addControl(navigation)
}
注：因为eslint可能会提示BMAP_ANCHOR_BOTTOM_RIGHT需要使用字符串，但这些大写的常量配置不应使用字符串，否则会不生效。
清除地图左下角的图标
使用css即可让图标消失，但注意样式不要放在scoped中：
<style lang="less" scoped>
.baidu-map {
width: 100%;
height: 100%;
}
</style>
<style>
.anchorBL a {
display: none;
}
.anchorBL img {
display: none;
}
.anchorBL span {
display: none !important;
}
</style>
处理大量点的方法
添加几个点，几十个点用上面的方法就完了。但是若是有上千上万个点也这么处理吗？虽然我们可以直接一个for循环，但是，这样做了的话就是添加点是时候浏览器会卡住一段时间。所以添加大量点的时候可以使用如下方法，各自有优缺点依情况选用吧。
这里先定义下点的格式：
[
{
"name": "温州张和堂医药连锁有限公司兴元店",
"lng": "120.763505",
"lat": "27.96839093"
},
{
"name": "温州万康大药房有限公司",
"lng": "120.7530476",
"lat": "27.97953802"
}
]
点聚合
点聚合的效果就是，将密集的多个点聚合在一起显示一个大点并标注数量，点击可以放大，详细见后面效果图。
在index.html中引入，百度地图相关的工具库：
<script src="//api.map.baidu.com/library/TextIconOverlay/1.2/src/TextIconOverlay_min.js"></script>
<script src="//api.map.baidu.com/library/MarkerClusterer/1.2/src/MarkerClusterer_min.js"></script>
点聚合的方法实现：
makePolyPoints(map, data) {
const MAPMarkers = []
map.clearOverlays()
data.forEach(point => {
const MAPMarker = new BMap.Marker(new BMap.Point(point.lng, point.lat))
MAPMarker.setTitle(point.name)
MAPMarkers.push(MAPMarker)
// 可以在点对象上添加属性，点击的监听能获取该属性
MAPMarker.zbbm = \'xxxxx\'
MAPMarker.addEventListener(\'click\', function (e) {
console.log(\'坐标编码:\', e.target.zbbm)
})
})
if (map.markerClusterer) {
map.markerClusterer.clearMarkers()
}
// 使用点聚合
map.markerClusterer = new BMapLib.MarkerClusterer(map, {
markers: MAPMarkers
})
}
在init()调用即可使用，如需要要使用labe和自定义图标icon，与添加单个点的类似。
海量点
海量点就是不把点聚合起来，而是全部显示出来。但使用这种方法的缺点是不能自定义点的图标，只能使用官方提供的预设图形作为点的图标。
使用海量点需要引入：
<script src="//api.map.baidu.com/library/TextIconOverlay/1.2/src/TextIconOverlay_min.js"></script>
<script src="//api.map.baidu.com/library/MarkerClusterer/1.2/src/MarkerClusterer_min.js"></script>
海量点方法实现：
makeCollectionPoints(map, data) {
map.clearOverlays()
// 判断是否支持使用 canvas (海量点)
if (document.createElement(\'canvas\').getContext) {
// 坐标点数据数组
var points = []
for (var point of data) {
points.push(new BMap.Point(point.lng, point.lat))
}
// 海量点的配置属性
// 配置图标：大小 形状 颜色
const options = {
size: BMAP_POINT_SIZE_NORMAL,
shape: BMAP_POINT_SHAPE_STAR,
color: \'yellow\'
}
// 初始化海量点
const pointCollection = new BMap.PointCollection(points, options)
pointCollection.addEventListener(\'click\', function (e) {
console.log(e)
})
map.addOverlay(pointCollection)
} else {
alert(\'浏览器不支持，请使用chrome、safari、IE8+以上浏览器\')
}
}
ShapeType预设图形：
| 常量 | 描述 |
|---|---|
| BMAP_POINT_SHAPE_CIRCLE | 圆形，为默认形状 |
| BMAP_POINT_SHAPE_STAR | 星形 |
| BMAP_POINT_SHAPE_SQUARE | 方形 |
| BMAP_POINT_SHAPE_RHOMBUS | 星形 |
| BMAP_POINT_SHAPE_STAR | 菱形 |
| BMAP_POINT_SHAPE_WATERDROP | 水滴状，该类型无size和color属性 |
| 其它具体参数配置参考：百度地图 javascript 3.0 api | |
使用mapv
mapv是百度地图官方推出的地理信息可视化开源库，借助其也能进行大量坐标点的添加操作。
它是使用canvas在地图上添加了一层，能保证速度和自定义点图标，首先导入mapv的库$npm install mapv，或者：
<script src="//mapv.baidu.com/build/mapv.min.js"></script>
点的数据格式
[
{
geometry: {
type: \'Point\',
coordinates: [123, 23]
},
fillStyle: \'red\',
size: 30
},
{
geometry: {
type: \'Point\',
coordinates: [121, 33]
},
fillStyle: \'rgba(255, 255, 50, 0.5)\',
size: 90
}
]
配置项说明
{
zIndex: 1, // 层级
size: 5, // 大小值
fillStyle: \'rgba(200, 200, 50, 1)\', // 填充颜色
strokeStyle: \'rgba(0, 0, 255, 1)\', // 描边颜色
lineWidth: 4, // 描边宽度
globalAlpha: 1, // 透明度
globalCompositeOperation: \'lighter\', // 颜色叠加方式
shadowColor: \'rgba(255, 255, 255, 1)\', // 投影颜色
shadowBlur: 35, // 投影模糊级数
shadowOffsetX: 0,
shadowOffsetY: 0,
lineCap: \'butt\',
lineJoin: \'miter\',
miterLimit: 10
}
mapv添加大量点的方法：
makeMapvPoints(map, data) {
if (document.createElement(\'canvas\').getContext) {
// 使用自定义坐标点图形
var img = new Image()
img.src = this.bluePoint
// 创建mapv配置项
const iconOpt = {
draw: \'icon\',
width: 32,
height: 38,
methods: {
click: item => {
if (item) console.log(item)
}
}
}
// 在图片加载后再创建图层才能自定义图标
img.onload = function () {
// 点坐标的数组
const dataSet = []
// 构建dataset格式数据
data.forEach(point => {
const geometry = {}
geometry.type = \'Point\'
geometry.coordinates = [point.lng, point.lat]
dataSet.push({
geometry,
icon: img,
tag: { name: point.name }
})
})
const mapSet = new mapv.DataSet(dataSet)
// dataSet.set(data) // 修改数据
// 叠加图层
const mapvLayer = new mapv.baiduMapLayer(map, mapSet, iconOpt)
// 显示图层
mapvLayer.show()
// mapvLayer.hide() // 隐藏图层
}
} else {
alert(\'浏览器不支持，请使用chrome、safari、IE8+以上浏览器\')
}
}
注意：
- 在使用自定义图标
icon时,必须设置width和height或者size。否则坐标点的点击事件无法触发。 - 在使用点击事件回调时，要判断回调的参数是否为
null。因为该事件总能触发（在有无坐标点击都能触发），无坐标点点击返回null，有则非空。
补充
地理坐标查询 – 拾取坐标系统
版权声明：本文为flytree原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。