calculateDistance(options:Object)

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

options属性说明

属性 类型 必填 说明
mode String 可选值:'driving'(驾车)、'walking'(步行),默认:'walking'
from String|Object 起点坐标,String格式:lat<纬度>,lng<经度>
Object格式:
{
  latitude: 纬度,
  longitude: 经度
}
默认是当前位置
to String|Object 终点坐标,String格式:lat,lng;lat,lng... (经度与纬度用英文逗号分隔,坐标间用英文分号分隔)
Object格式1:
[{
  latitude: 纬度,
  longitude: 经度
}, ...]
Object格式2:
此格式主要对应search返回的数据结构格式,方便开发这批量转换
[{
  location: {
    lat: 纬度,
    lng: 经度
  }
}, ...]

调用结果

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

名称 类型 说明 示例
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的描述
result object 计算结果
elements array 结果数组
from object 起点坐标
lat number 纬度
lng number 经度
to object 终点坐标
lat number 纬度
lng number 经度
distance number 起点到终点的距离,单位:米,
如果radius半径过小或者无法搜索到,则返回-1
duration number 表示从起点到终点的结合路况的时间,秒为单位
注:步行方式不计算耗时,该值始终为0

示例