微信小程序之地图功能

原文出处：http://blog.csdn.net/crazy1235/article/details/55004841

本篇blog主要介绍微信小程序中的地图模块相关功能。

基本使用

地图组件使用起来也很简单。

.wxml

<map id="map" longitude="{{longitude}}" latitude="{{latitude}}" scale="14" controls="{{controls}}" bindcontroltap="controltap" markers="{{markers}}" bindmarkertap="markertap" polyline="{{polyline}}" circles="{{circles}}" bindregionchange="regionchange" show-location style="width: 100%; height: 350px;">
</map>

1
2
1
2

参数列表及说明如下：



除了显示基本地图，还可以在地图上添加markers–标注，polyline–折线，circles–圆形，controls–控件。

markers

data: {
//
markers: [{
iconPath: "../../img/marker_red.png",
id: 0,
latitude: 40.002607,
longitude: 116.487847,
width: 35,
height: 45
}],
... //省略代码
}

1
2
3
4
5
6
7
8
9
10
11
12
1
2
3
4
5
6
7
8
9
10
11
12

在data中定义markers变量来表示覆盖物

然后map控件引入即可：

<map id="map" longitude="{{longitude}}"  markers="{{markers}}" style="width: 100%; height: 350px;" ...//省略代码>
</map>

1
2
1
2

效果如下：

polyline

data: {
//
polyline: [{
points: [{
longitude: '116.481451',
latitude: '40.006822'
}, {
longitude: '116.487847',
latitude: '40.002607'
}, {
longitude: '116.496507',
latitude: '40.006103'
}],
color: "#FF0000DD",
width: 3,
dottedLine: true
}],
... //省略代码
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

<map id="map" longitude="{{longitude}}" latitude="{{latitude}}" polyline="{{polyline}}" style="width: 100%; height: 350px;">

1
1

circles

data: {
//
circles: [{
latitude: '40.007153',
longitude: '116.491081',
color: '#FF0000DD',
fillColor: '#7cb5ec88',
radius: 400,
strokeWidth: 2
}],
... //省略代码
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
1
2
3
4
5
6
7
8
9
10
11
12
13
14

<map id="map" longitude="{{longitude}}" latitude="{{latitude}}" circles="{{circles}}" style="width: 100%; height: 350px;">

1
1

效果如下：

controls

controls: [{
id: 1,
iconPath: '../../img/marker_yellow.png',
position: {
left: 0,
top: 300 - 50,
width: 50,
height: 50
},
clickable: true
}]

1
2
3
4
5
6
7
8
9
10
11
1
2
3
4
5
6
7
8
9
10
11

<map id="map" controls="{{controls}}" bindcontroltap="controltap" style="width: 100%; height: 350px;">

1
1

control点击事件如下：

controltap: function (e) {
console.log(e.controlId);
},

1
2
3
1
2
3

其实可以通过在map上添加一个按钮，来实现诸如：定位、状态返回等操作。 

（直接通过布局文件在map上添加view是显示不出来的）

绑定事件

BUG

关于经纬度，官方文档上都写的是Number类型。但是通过IDE调试的时候，写成字符串也是可以的。但是在IOS真机上运行时，markers却显示不出来，也不报错。

后来自己对照属性的类型，发现后台传来的经纬度是字符串类型的。而字符串类型的经纬度在IOS真机上经测试就是显示不出来。

所以将字符串转成Number类型即可。

百度地图API

百度地图团队的速度还是不错的！在小程序正式公测的第三天（2017.1.11）就发布了小程序版百度地图API

百度地图微信小程序JavaScript API

然而一期的功能并不多：

POI检索服务

POI检索热刺联想服务

逆地址解析服务

天气查询

关于这四个功能，大家自行去调用API就是了！

我要吐槽的是，为什么只有逆地址解析服务，没有地址编码服务呢？！

好吧，你不提供，我加上好吧！！

把参考 web服务API里关于地址编码的API ，在小程序里面封装一下即可！

其实上面看到的四个API也是从他们原有的web服务API中抽出来的 ！

核心代码如下：

let startGeocoding = function (e) {
wx.request({
url: 'https://api.map.baidu.com/geocoder/v2/',
data: geocodingparam,
header: {
"content-type": "application/json"
},
method: 'GET',
success(data) {
let res = data["data"];
if (res["status"] === 0) {
let result = res["result"];
// outputRes 包含两个对象，
// originalData为百度接口返回的原始数据
// wxMarkerData为小程序规范的marker格式
let outputRes = {};
outputRes["originalData"] = res;
outputRes["wxMarkerData"] = [];
outputRes["wxMarkerData"][0] = {
id: 0,
latitude: result["location"]['lat'],
longitude: result["location"]['lng'],
address: geocodingparam["address"],
iconPath: otherparam["iconPath"],
iconTapPath: otherparam["iconTapPath"],
desc: '',
business: '',
alpha: otherparam["alpha"],
width: otherparam["width"],
height: otherparam["height"]
}
otherparam.success(outputRes);
} else {
otherparam.fail({
errMsg: res["message"],
statusCode: res["status"]
});
}
},
fail(data) {
otherparam.fail(data);
}
});
};

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

使用方法：

// 地理编码

startGeocoding: function () {
Bmap.geocoding({
fail: fail,
success: success,
address: '北京大学',
iconPath: '../../img/marker_red.png',
iconTapPath: '../../img/marker_red.png'
})
},

1
2
3
4
5
6
7
8
9
10
11
1
2
3
4
5
6
7
8
9
10
11



然后我还对 静态图 这个API进行了小程序化！！！

/**
* 静态图
*
* @author ys
*
* @param {Object} param 检索配置
* http://lbsyun.baidu.com/index.php?title=static */
getStaticImage(param) {
var that = this;
param = param || {};
let staticimageparam = {
ak: that.ak2,
width: param["width"] || 400,
height: param["height"] || 300,
center: param["center"] || '北京', // 地址或者经纬度
scale: param["scale"] || 1, // 是否为高清图 返回图片大小会根据此标志调整。取值范围为1或2。 1表示返回的图片大小为size= width *height; 2表示返回图片为(width*2)*(height *2)，且zoom加1  注：如果zoom为最大级别，则返回图片为（width*2）*（height*2），zoom不变。
zoom: param["zoom"] || 11, //高清图范围[3, 18]；0低清图范围[3,19]
copyright: param["copyright"] || 1, // 0表示log+文字描述样式，1表示纯文字描述样式
markers: param["markers"] || null, // 标注，可通过经纬度或地址/地名描述；多个标注之间用竖线分隔
};
return "http://api.map.baidu.com/staticimage/v2?" + "ak=" + staticimageparam["ak"] + "&width=" + staticimageparam["width"] + "&height=" + staticimageparam["height"] + "¢er=" + staticimageparam["center"] + "&zoom=" + staticimageparam["zoom"] + "&scale=" + staticimageparam["scale"] + "©right=" + staticimageparam["copyright"];
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

关于静态图，在web端调用的时候需要单独申请key，所以这里要在传入一个key！

在BMapWX构造函数中，传入ak2作为静态图的key

constructor(param) {
this.ak = param["ak"];
this.ak2 = param["ak2"];
}

1
2
3
4
1
2
3
4

var Bmap = new bmap.BMapWX({
ak: 'xxxxxxxxxxx',
ak2: 'xxxxxxxxxxx'
});

1
2
3
4
1
2
3
4

使用方法也很简单：

//获取静态图
getStaticImage: function () {
var url = Bmap.getStaticImage({
scale: 2
});
console.log(url);
that.setData({
staticImageUrl: url
})
}

1
2
3
4
5
6
7
8
9
10
1
2
3
4
5
6
7
8
9
10

高德地图API

相比百度地图团队，高德地图团队更及时！ 小程序公测第二天就发布了 小程序高德地图API

微信小程序SDK > 概述

目前提供的功能有：

获取POI数据

获取地址描述数据

获取实时天气数据

获取输入提示词

路径规划

绘制静态图

在官网上，直接提供了路径规划的功能代码，和布局代码(.wxml & .wxss)

可见，高德还是比较靠谱的！

腾讯地图API

微信小程序JavaScript SDK

地点搜索

关键词输入提示

逆地址解析

地址解析

距离计算

获取城市列表

获取城市区县

注意

使用需要注意以下几点：

map 组件是由客户端创建的原生组件，它的层级是最高的。

请勿在 scroll-view 中使用 map 组件。

css 动画对 map 组件无效。

百度地图小程序SDK扩展下载地址：

https://github.com/crazy1235/WXlittleApplication