就近路线路况
2021年05月12日

接口描述

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

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

输入参数

参数名称 类型 必选 默认值 描述
points array<Points> 路线坐标点串,最多支持20个点

Points:

参数名称 类型 必选 默认值 描述
longitude float 经度,建议小数点不超过6位
latitude float 纬度,建议小数点不超过6位
radius int 10 搜索半径,0-1000米
road_levels array 道路等级,支持多个值,[1,2,3,...] ,暂不支持此字段
road_funcclasses array 道路功能等级,支持多个值,[1,2,3,...],暂不支持此字段

输出参数

参数名称 类型 描述
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/nearestroads' \
--header 'Content-Type: application/json' \
--header 'Authorization: AppCode XXX' \
--data '{
    "points": [
        {"longitude" : 113.889210, "latitude": 22.520334},
        {"longitude" : 113.889194, "latitude": 22.520354},
        {"longitude" : 113.888960, "latitude": 22.520640},
        {"longitude" : 113.888190, "latitude": 22.521690},
        {"longitude" : 113.887470, "latitude": 22.522750}
    ]
}'

输出:

{
    "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.5,
                "car_count": 31
            }
        ],
        "expire_time": 40849
    }
}

项搜索结果

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