指定线路实时路况
2021年05月12日

接口描述

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

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

输入参数

参数名称 类型 必选 默认值 描述
route array<Route> 路线参数,经纬度小数点后不超过6位,至少输入3个点。

Route:

参数名称 类型 必选 默认值 描述
longitude float 经度,建议小数点不超过6位
latitude float 纬度,建议小数点不超过6位
accuracy float 10 定位精度(单位米)
speed float 10 速度(单位km/h)
direction float 方向(0度代表正北,顺时针一周360度)

输出参数

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

Result:

参数名称 类型 描述
description string 路况综述
evaluation Evaluation 路况评价
steps array<Steps> 路况明细

Evaluation

参数名称 类型 描述
expedite int 畅通所占百分比
congested int 缓行百分比
blocked int 拥堵百分比
unknown int 未知路段所占百分比

Steps

参数名称 类型 描述
id string 路段ID
outline string 路段坐标点串
traffic_status int 交通状况,//0畅通;1缓行;2拥堵;3无路况
length int 路段长度,单位米
road_name string 道路名称
speed int 道路速度,单位千米/秒
car_count int 过去10分钟的轨迹数量

错误码

错误码

示例

请求:

curl -X GET 'https://mapapi-routes.apigw-gz.didiyunapi.com/api/v1/traffic/route' \
--header 'Authorization: AppCode XXX' \
--header 'Content-Type: application/json' \
--data '{
    "route": [
        {
            "longitude": 113.889210,
            "latitude": 22.520334,
            "accuracy": 10,
            "direction": 0
        },
        {
             "longitude": 113.889194,
            "latitude": 22.520354,
            "accuracy": 10,
            "speed": 3 
        },
        {
             "longitude": 113.888960,
            "latitude": 22.520640,
            "direction": 0
        }
    ]
}'

输出:

{
    "status": 0,
    "info": "OK",
    "result": {
        "description": "",
        "evaluation": null,
        "steps": [
            {
                "id": "97446787710000",
                "outline": "113.895560,22.514020;113.895000,22.514550;113.894830,22.514700;113.894720,22.514780;113.894570,22.514930;113.894280,22.515180;113.894110,22.515320;113.892490,22.516780;113.892000,22.517280;113.891590,22.517690;113.891560,22.517720;113.891500,22.517780;113.890560,22.518730;113.889750,22.519670;113.889730,22.519700;113.889350,22.520160;113.889280,22.520250;113.888960,22.520640;113.888190,22.521690;113.887470,22.522750;113.887180,22.523230;113.887030,22.523500",
                "traffic_status": 1,
                "length": 1377,
                "road_name": "S3",
                "speed": 88.6,
                "car_count": 33
            }
        ],
        "expire_time": 40963
    }
}

项搜索结果

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