接口描述

请求路径：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": "Ｓ３",
                "speed": 88.6,
                "car_count": 33
            }
        ],
        "expire_time": 40963
    }
}