距离矩阵
2020年02月05日

接口描述

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

请求方法:GET

输入参数

参数名称 必选 默认值 描述
origins 起点经纬度:lng,lat|lng,lat|…。起终点数量乘积最多200
destinations 终点经纬度:lng,lat|lng,lat|…。起终点数量乘积最多200
strategy 0 路线规划策略:0(综合模式)、1(时间最短)、2(距离最短)、3(不走高速)、4(少收费)、5(高速优先)、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?origins=116.27558,40.031364|116.30626,40.05286|116.27263,40.0324&destinations=116.33089,39.887142|116.49133,39.96241|116.49339,39.96434'

输出:

{
    "status":0,
    "info":"OK",
    "result":{
        "rows":[
            {
                "elements":[
                    {
                        "distance":61,
                        "duration":44,
                        "Info":0,
                        "Status":"OK"
                    },
                    {
                        "distance":153,
                        "duration":141,
                        "Info":0,
                        "Status":"OK"
                    },
                    {
                        "distance":53,
                        "duration":59,
                        "Info":0,
                        "Status":"OK"
                    }
                ]
            },
            {
                "elements":[
                    {
                        "distance":171,
                        "duration":15,
                        "Info":0,
                        "Status":"OK"
                    },
                    {
                        "distance":197,
                        "duration":142,
                        "Info":0,
                        "Status":"OK"
                    },
                    {
                        "distance":21,
                        "duration":146,
                        "Info":0,
                        "Status":"OK"
                    }
                ]
            },
            {
                "elements":[
                    {
                        "distance":283,
                        "duration":22,
                        "Info":0,
                        "Status":"OK"
                    },
                    {
                        "distance":89,
                        "duration":139,
                        "Info":0,
                        "Status":"OK"
                    },
                    {
                        "distance":252,
                        "duration":165,
                        "Info":0,
                        "Status":"OK"
                    }
                ]
            }
        ]
    }
}

项搜索结果

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