WebService API

产品通知
批量距离计算（一对多）服务将在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
            }
        ]
    }
}

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

已解决

未解决