接口描述
请求路径: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
}
]
}
}