接口描述

请求路径：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": "Ｓ３",
                "speed": 88.5,
                "car_count": 31
            }
        ],
        "expire_time": 40849
    }
}