概述

本服务用于单起点到多终点,或多起点到单终点的路线距离(非直线距离)计算:

*. 支持两种距离计算方式:步行和驾车。

*. 起点到终点最大限制直线距离10公里。

目前本服务可应用于:

O2O上门服务

可保证服务人员合理分配订单,加快上门速度,提升效率及客户体验。

步行路线距离:1766米

预估到达时间

根据规划路线距离和路况信息,预估到达时间。

请求URL

该请求为GET请求

http://apis.map.qq.com/ws/distance/v1/?parameters

请求参数(GET请求)

参数 必填 说明 示例
mode 计算方式:driving(驾车)、walking(步行)
默认:driving
 mode=driving
from 起点坐标,格式:lat,lng;lat,lng...
(经度与纬度用英文逗号分隔,坐标间用英文分号分隔)
from=39.071510,117.190091
to 终点坐标,格式:lat,lng;lat,lng...
(经度与纬度用英文逗号分隔,坐标间用英文分号分隔)
注意:本服务支持单起点到多终点,或多起点到单终点,from和to参数仅可有一个为多坐标
to=39.071510,117.190091;40.007632,
116.389160;39.840177,116.463318
output 返回格式:支持JSON/JSONP,默认JSON output=json
callback JSONP方式回调函数 callback=function1
key 开发密钥(Key) key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

响应结果

名称 类型 说明 示例
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

调用示例