距离测量
GET/v3/distance- 服务示例
https://restapi.amap.com/v3/distance?origins=116.481028,39.989643|114.481028,39.989643|115.481028,39.989643&destination=114.465302,40.004717&output=xml&key=<用户的key>
| 参数 | 值 | 备注 | 必选 |
|---|---|---|---|
| origins | 出发点支持100个坐标对（公交仅支持20个），坐标对见用“| ”分隔；经度和纬度用","分隔 | 是 | |
| destination | 目的地规则： lon，lat（经度，纬度）， “,”分割如117.500244, 40.417801 经纬度小数点不超过6位 | 是 | |
| type | 此参数需要输入路径计算的方式和方法 | 否 |
返回结果参数说明
距离测量的响应结果的格式由请求参数output指定
请求参数
Query 参数
origins
number
必需
出发点 支持100个坐标对，坐标对见用“| ”分隔；经度和纬度用","分隔
示例值:
116.481028,39.989643|114.481028,39.989643|115.481028,39.989643
destination
number
必需
目的地 规则： lon，lat（经度，纬度）， “,”分割 如117.500244, 40.417801 经纬度小数点不超过6位
示例值:
114.465302,40.004717
type
string
可选
路径计算的方式和方法 0：直线距离 1：驾车导航距离（仅支持国内坐标）。 必须指出，当为1时会考虑路况，故在不同时间请求返回结果可能不同。 此策略和驾车路径规划接口的 strategy=0策略基本一致，策略为“ 速度优先，此路线不一定距离最短 ” 由于算法差异，无法保证距离测量结果与路径规划结果完全一致。若需要实现高德地图客户端效果，可以考虑使用驾车路径规划接口 3：步行规划距离（仅支持5km之间的距离）
示例值:
1
sig
string
可选
output
string
可选
返回数据格式类型 可选值：JSON，XML
示例值:
JSON
callback
string
可选
回调函数 callback值是用户定义的函数名称，此参数只在output=JSON时有效
parameters
string
可选
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
status
string
可选
返回结果状态值，值为0或1，0表示请求失败；1表示请求成功
info
string
可选
返回状态说明，status为0时，info返回错误原因；否则返回“OK”。详情参阅info状态表
code
string
可选
仅在出错的时候显示此字段。 在驾车模式下： 1，指定地点之间没有可以行车的道路 2，起点/终点 距离所有道路均距离过远（例如在海洋/矿业） 3，起点/终点不在中国境内
count
string
可选
results
array [object {4}]
距离信息列表
origin_id
string
可选
起点坐标，起点坐标序列号（从１开始）
dest_id
string
可选
终点坐标，终点坐标序列号（从１开始）
distance
string
可选
路径距离，单位：米
duration
string
可选
预计行驶时间，单位：秒
示例成功示例
{
"status": "1",
"info": "OK",
"infocode": "10000",
"count": "3",
"results": [
{
"origin_id": "1",
"dest_id": "1",
"distance": "260216",
"duration": "12540"
},
{
"origin_id": "2",
"dest_id": "1",
"distance": "91798",
"duration": "6600"
},
{
"origin_id": "3",
"dest_id": "1",
"distance": "194334",
"duration": "11040"
}
]
}
【高德地图】API开发者 微信交流群
扫码加入交流群最后修改时间： 2 年前