微信小程序JavaScript SDK | 腾讯位置服务

calculateDistance(options:Object)

计算一个点到多点的步行、驾车距离。

注：坐标系采用gcj02坐标系

options属性说明

属性	类型	必填	说明
mode	String	否	可选值：'driving'（驾车）、'walking'（步行），默认：'walking' 新增直线距离计算，'straight'（直线）直线距离计算适用于 jssdkv1.1 jssdkv1.2
from	String\|Object	否	位置坐标， ①String格式：lat<纬度>,lng<经度>（例：from: '39.984060,116.307520'） ②Object格式： { latitude: 纬度, longitude: 经度 } （例：from: { latitude: 39.984060, longitude: 116.307520 }）默认是当前位置
to	String\|Object	是	终点坐标， ①String格式：lat,lng;lat,lng... （经度与纬度用英文逗号分隔，坐标间用英文分号分隔）（例：to: '39.984060,116.307520;39.984060,116.507520'） ②Object格式1： [{ latitude: 纬度, longitude: 经度 }, ...] (例：to:[{ latitude:39.984060, longitude:116.307520 },...]) ③Object格式2：此格式主要对应search返回的数据结构格式，方便开发这批量转换 [{ location: { lat: 纬度, lng: 经度 } }, ...] (例：to:[{ location:{ lat:39.984060, lng:116.307520 } },...])
sig	String	否	签名校验开启WebServiceAPI签名校验的必传参数，只需要传入生成的SK字符串即可，不需要进行MD5加密操作该参数仅适用于 jssdkv1.2

调用结果

通过属性success, fail, complete的回调参数来接收调用结果

success的回调参数可以有2个，第1个参数接收调用结果，第2个参数控制返回处理后的数据（非必须参数）,示例：success:function(res,data)
该属性适用于 jssdkv1.1 jssdkv1.2

名称				类型	说明	示例
status				number	状态码，0为正常, 310请求参数信息有误， 311key格式错误, 306请求有护持信息请检查字符串, 110请求来源未被授权	{ "status": 0, "message": "Query is OK", "result":{ "elements":[ { "from":{ "lat":39.071510 "lng":117.190091 } "to":{ "lat":39.840177, "lng":116.463318 } "distance":2000 "duration":2000 } ] } }
message				string	状态说明，即对状态码status进行说明，如： status为0,message为"query ok",为正常, status为310,message为"请求参数信息有误", status为311,message为"key格式错误", status为306,message为"请求有护持信息请检查字符串", status为110,message为"请求来源未被授权"
result				object	计算结果
	elements			array	结果数组
		from		object	起点坐标
			lat	number	纬度
			lng	number	经度
		to		object	终点坐标
			lat	number	纬度
			lng	number	经度
		distance		number	起点到终点的距离，单位：米，如果radius半径过小或者无法搜索到，则返回-1
		duration		number	表示从起点到终点的结合路况的时间，秒为单位注：步行方式不计算耗时，该值始终为0

示例

WXML 模板文件中添加组件： Javascript 关键代码片段：

// 引入SDK核心类
                        var QQMapWX = require('xxx/qqmap-wx.js');

// 实例化API核心类
                        var qqmapsdk = new QQMapWX({
                            key: '开发密钥（key）' // 必填
                        });

//在Page({})中使用下列代码
                        //事件触发，调用接口
                        formSubmit(e){
                            var _this = this;
                            //调用距离计算接口
                            qqmapsdk.calculateDistance({
                                //mode: 'driving',//可选值：'driving'（驾车）、'walking'（步行），不填默认：'walking',可不填
                                //from参数不填默认当前地址
                                //获取表单提交的经纬度并设置from和to参数（示例为string格式）
                                from: e.detail.value.start || '', //若起点有数据则采用起点坐标，若为空默认当前地址
                                to: e.detail.value.dest, //终点坐标
                                success: function(res) {//成功后的回调
                                  console.log(res);
                                  var res = res.result;
                                  var dis = [];
                                  for (var i = 0; i < res.elements.length; i++) {
                                    dis.push(res.elements[i].distance); //将返回数据存入dis数组，
                                  }
                                  _this.setData({ //设置并更新distance数据
                                    distance: dis
                                  });
                                },
                                fail: function(error) {
                                  console.error(error);
                                },
                                complete: function(res) {
                                  console.log(res);
                                }
                            });
                        }

接口调用说明

calculateDistance(options:Object)方法调用接口服务如下：

/ws/distance/v1 距离计算:步行
/ws/distance/v1 距离计算:驾车

超过日调用量和并发数的开发者，可通过以下途径解决：
     1. 对于多频次的相同请求，可通过缓存结果，并定时访问更新的方式，减少对在线服务调用的依赖；
     2. 企业开发者的配额高于个人开发者，申请企业认证后，需要在控制台->配额申请中免费申请你需要的配额。
        我们将对您的申请进行评估并进行审批（3个工作日内），审批通过后将会获得您申请的配额。
     3. 对于切实需要大配额来满足应用需求的，请在控制台->配额管理中提交购买配额申请，我们的商务会与您取得联系。