距离测量

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指定

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://restapi.amap.com/v3/distance?origins=116.481028,39.989643|114.481028,39.989643|115.481028,39.989643&destination=114.465302,40.004717&Key='

响应示例

{
  "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"
    }
  ]
}

请求参数

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之间的距离）

示例值:

sig

string

可选

数字签名获取和使用方法

output

string

可选

返回数据格式类型可选值：JSON，XML

示例值:

JSON

callback

string

可选

回调函数 callback值是用户定义的函数名称，此参数只在output=JSON时有效

parameters

string

可选

Key

string

必需

用户在高德地图官网申请Web服务API类型Key

默认值:

返回响应

🟢200成功

application/json

Body

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

可选

预计行驶时间，单位：秒

修改于 2022-12-13 07:33:54

未来路径规划

概述