产品通知
批量距离计算(一对多)服务将在2020-05-30停止新用户接入,已接入用户不受影响。
新用户请使用更强大的 距离矩阵(多对多)服务
1. 支持一对多,既1个起点到200个终点的路面距离计算
2. 支持25个起点到25个终点矩阵式计算(一次计算625对两点间路面距离)
3. 没有距离限制

概述

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

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

        *. 起点到终点最大限制直线距离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请求来源未被授权
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

//响应示例:
{
    "status": 0,
    "message": "query ok",
    "result": {
        "elements": [
            {
                "from": {
                    "lat": 39.983171,
                    "lng": 116.308479
                },
                "to": {
                    "lat": 39.996059,
                    "lng": 116.353454
                },
                "distance": 5354.7,
                "duration": 1678
            },
            {
                "from": {
                    "lat": 39.983171,
                    "lng": 116.308479
                },
                "to": {
                    "lat": 39.949226,
                    "lng": 116.394309
                },
                "distance": 10495.8,
                "duration": 2635
            }
        ]
    }
}

这篇文章对您解决问题是否有帮助?

已解决
未解决