AI
产品服务
解决方案
文档与支持
定价
更新时间: 2026-03-20 08:10:35
红绿灯动态查询
下载开发文档
接口说明

根据红绿灯的进入道路linkid,查询红绿灯动态数据,每个信号灯最多下发连续四个周期的灯态数据。

API服务地址

http://api.map.baidu.com/api_lamp_service/v1/dynamic_lamp_search?
//GET请求

请求参数
参数名称参数含义示例字段类型必选

links

进入红绿灯路口的 道路linkid

示例:

15295295770,15295212120,15295295120

含义:

多个link之间用 ',' 分隔;

一次请求最多不超过5个link

string

ak

从地图开放平台官网控制台创建获取,只支持服务端类型ak

ak

string

返回参数
返回参数类型备注

status

int32

状态码

0:成功

1:服务内部错误

2:http method 错误

3:参数错误

4:查询红绿灯动态数据失败(访问下游服务失败)

其他通用状态码:https://lbsyun.baidu.com/index.php?title=webapi/appendix

message

string

状态码对应的信息

result

array

数组,没有匹配上数据的时候返回空

linkid

int64

11位linkid

out_linkids

array

红绿灯路口退出link。可能存在多个转向共用一个灯的情况,因此退出路口的linkid可能有多个。

timestamp

uint64

时间戳,即红绿灯动态数据的生成时间。客户端可以使用本地时间对数据做校验和校准。

road_flow_direction

string

行驶流向说明:

11: 直行

12: 左转

13: 右转

21: 直左混行

22: 直右混行

23: 左右混行

24: 直左右混行

31: 掉头

99: 其他

lamp_status_1

int

当前信号灯灯态

11:灭灯

21:红灯

22:黄灯

23:绿灯

24:黄闪

count_down_1

int

当前灯态的倒计时;用于展示当前灯态的倒计时读秒

倒计时存在值为10000的情况,10000表示没有挖掘到这个灯的倒计时数据。

period_1

int

当前灯周期(展示时长)period 表示一个置信区间;period 一般<=count_down。

有一些挖掘到的数据可能count_down不一定准确,但是我们可以确保在 period 范围内灯态是正确的。

当 period 倒计为0 时,如果有下一个灯态的数据,则展示下个灯态;如果没有下个灯态的数据,则灭灯。

lamp_status_2

int

第二个灯的状态,取值范围同lamp_status

count_down_2

int

第二个灯的倒计时

period_2

int

第二个灯的展示时长

lamp_status_3

int

第三个灯的状态

count_down_3

int

第三个灯的倒计时

period_3

int

第三个灯的展示时长

lamp_status_4

int

第四个灯的状态

count_down_4

int

第四个灯的倒计时

period_4

int

第四个灯的展示时长

流程参考图:

上一篇

路线红绿灯查询

下一篇

更新日志

本篇文章对您是否有帮助?