接口描述

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

请求方法：POST

输入参数

参数名称	必选	默认值	描述
points	是	无	lng,lat，最多200个点
radius	否	500	搜索半径，0-5000米
strategy	否	0	策略，0(实时路线彩虹);1(历史路线蚯蚓);2(预测路线蚯蚓)
road_levels	否	无	道路等级，高速路:0x0，都市高速路:0x1，国道:0x2，省道:0x3，县道:0x4，乡镇村道:0x6，其它道路:0x8，九级路:0x9，轮渡:0xa，行人道路 :0xb。支持多个值。
road_funcclasses	否	无	道路功能等级，取值范围1~5，对应等级1到等级5。支持多个值。

1:表示城市之间的连接道路，包括穿过城市的道路。这种道路是全封闭的，并且能够提供最大车速和最大车流量。一般情况下相对于路网该等级的道路非常少，并且该等级的路网可以不连通(但在全球范围内必须连通)。 2:表示等级1道路之间的连接道路，行驶在该等级之上的车辆能够以较短的时间通过某个城市，或到达其他城市。 3:表示高等级道路的连道路，能够提供较大的机动性，但不如等级2道路提供的机动性高。 4:该等级的道路能够容纳较多车辆、并且能够以适中的速度运行。是高等级道路之间的连接道路。 5:该等级的道路在车辆数和速度上都小于其他等级的道路，并且包含了人行道。与高等级的道路形成最细的路网，主要用于短距离的引导。 其中低等级的道路可以自己形成封闭的路网(但必须与上层高等级的道路有挂接)，也可以与所挂接的上层高等级道路构建封闭的路网(低等级的道路可以不够成路网)，引导设备可以通过等级从1-5的层次逐步计算并引导车辆到达目的地。|

输出参数

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

Result：

参数名称	类型	描述
expire_time	int	当前批次数据过期时间
segments	array<Segments>	分段蚯蚓

Segments

参数名称	类型	描述
link_id	int	LinkId
segment_len	int	当段link长度，单位米
traffic_status	int	交通状态类型，0未知，1畅通，2缓行，3拥堵，4非常拥堵
speed	int	速度，km/h * 10
car_count	int	路况计算使用的，小车通行个数

错误码

错误码

示例

请求：

  curl --location --request POST 'https://mapapi-routes.apigw-gz.didiyunapi.com/api/v1/traffic/nearestroads' \
--header 'Content-Type: application/json' \
--header 'Authorization: AppCode XXX'\
--data '{
    "points": ["116.454286,39.941051"]
}'

输出：

{
    "status":0,
    "info":"OK",
    "result":{
        "expire_time":20227,
        "segments":[
            {
                "link_id":6865630,
                "segment_len":61,
                "traffic_status":1,
                "speed":300,
                "car_count":1
            },
            {
                "link_id":6714460,
                "segment_len":61,
                "traffic_status":1,
                "speed":342,
                "car_count":80
            },
            {
                "link_id":6699620,
                "segment_len":61,
                "traffic_status":1,
                "speed":413,
                "car_count":66
            },
            {
                "link_id":6678090,
                "segment_len":8,
                "traffic_status":1,
                "speed":357,
                "car_count":23
            },
            {
                "link_id":6678091,
                "segment_len":8,
                "traffic_status":1,
                "speed":357,
                "car_count":23
            },
            {
                "link_id":300502670,
                "segment_len":33,
                "traffic_status":1,
                "speed":311,
                "car_count":82
            },
            {
                "link_id":6678080,
                "segment_len":85,
                "traffic_status":1,
                "speed":300,
                "car_count":1
            },
            {
                "link_id":398624910,
                "segment_len":49,
                "traffic_status":1,
                "speed":363,
                "car_count":66
            }
        ]
    }
}