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 关键代码片段:

接口调用说明

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

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

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