距离矩阵
2021年04月12日

接口描述

请求路径:https://mapapi-routes.apigw-gz.didiyunapi.com/api/v1/distancematrix

请求方法:GET Content-Type=application/json

输入参数

参数名称 类型 必选 默认值 描述
origins array<GeoPoint> 起点经纬度,起终点数量乘积最多200
destinations array<GeoPoint> 终点经纬度,起终点数量乘积最多200
strategy int 0 路线规划策略:0(综合模式)、1(时间最短)、2(距离最短)、3(不走高速)、4(少收费)、5(高速优先)、6(红绿灯少)

GeoPoint:

参数名称 类型 必选 默认值 描述
longitude float 经度,建议小数点不超过6位
latitude float 纬度,建议小数点不超过6位

输出结果说明

​ 距离矩阵的输入可以有多个起点或终点,所以输出是一个二维数组。"rows"对应的是起点,每一行按输入顺序对应一个起点;"elements"对应的是终点,每一行按输入顺序对应一个终点。以2个origin,3个destination为例,输出是2行3列的二维数组,

Origin1-Destination1 Origin1-Destination2 Origin1-Destination3
**Origin2-Destination1**
**Origin2-Destination2**
**Origin2-Destination3**

​ 另外,输出结果中内层的"status"代表的是每一对起终点的结果状态;外层的"status"代表的是整体的结果状态

输出参数

参数名称 类型 描述
status int 状态码
info string 状态说明
result Result 请求返回数据

Result:

参数名称 类型 描述
rows array<Row>

Row:

参数名称 类型 描述
elements array<Element>

Element:

参数名称 类型 描述
distance int 路线总距离
duration int 路线总时间
info string 状态说明
status int 状态码

错误码

错误码

示例

请求:

curl -X GET 'https://mapapi-routes.apigw-gz.didiyunapi.com/api/v1/distancematrix' \
  --header 'Authorization: AppCode XXX' \
  --header 'Content-Type: application/json' \
  --data '{
   "origins": [
       {"longitude": 116.27558, "latitude": 40.031364},
       {"longitude": 116.30626, "latitude": 40.05286},
       {"longitude": 116.27263, "latitude": 40.0324}
   ],
   "destinations":[
        {"longitude": 116.33089, "latitude": 39.887142},
       {"longitude": 116.49133, "latitude": 39.96241},
       {"longitude": 116.49339, "latitude": 39.96434}
   ]
}'

输出:

{
    "status":0,
    "info":"OK",
    "result":{
        "rows":[
            {
                "elements":[
                    {
                        "distance":"20625",
                        "duration":"2795",
                        "info":"",
                        "status":"0"
                    },
                    {
                        "distance":"25373",
                        "duration":"3207",
                        "info":"",
                        "status":"0"
                    },
                    {
                        "distance":"25549",
                        "duration":"3239",
                        "info":"",
                        "status":"0"
                    }
                ]
            },
            {
                "elements":[
                    {
                        "distance":"26310",
                        "duration":"2919",
                        "info":"",
                        "status":"0"
                    },
                    {
                        "distance":"22751",
                        "duration":"2976",
                        "info":"",
                        "status":"0"
                    },
                    {
                        "distance":"22927",
                        "duration":"3024",
                        "info":"",
                        "status":"0"
                    }
                ]
            },
            {
                "elements":[
                    {
                        "distance":"19852",
                        "duration":"2636",
                        "info":"",
                        "status":"0"
                    },
                    {
                        "distance":"24601",
                        "duration":"2999",
                        "info":"",
                        "status":"0"
                    },
                    {
                        "distance":"24777",
                        "duration":"3041",
                        "info":"",
                        "status":"0"
                    }
                ]
            }
        ]
    }
}

项搜索结果

    空空如也
    没有找到您要搜索的内容,请直接拨打服务热线400-0590-666