概述

本服务用于单起点到多终点，或多起点到单终点的路线距离（非直线距离）计算：

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

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

目前本服务可应用于：

O2O上门服务

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

步行路线距离：1766米

预估到达时间

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

请求URL

该请求为GET请求

https://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

调用示例

// GET请求:
 
https://apis.map.qq.com/ws/distance/v1/?mode=driving&
from=39.983171,116.308479&
to=39.996060,116.353455;39.949227,116.394310&
key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77