红绿灯API

红绿灯API提供了获取交通信号灯状态和路口信息的服务，对于需要实时交通信号数据的应用非常有用。

获取路口信息 API

接口描述

获取特定城市的路口信息列表，包括路口ID、名称和位置等。

请求方式

URL	请求方式
https://lbs.xiaojukeji.com/api/v2/crossinfo	POST、GET

请求

查询参数（GET）

参数名	必选	类型	描述	示例值
key	是	string	鉴权用的 API Key	YOUR_API_KEY
citycode	是	string	城市代码，见城市代码表	1

请求体参数（POST）

当使用POST方法时，请求体应为 CrossInfoRequest 模型的JSON格式。

请求示例

curl -X GET "https://lbs.xiaojukeji.com/api/v2/crossinfo?key=YOUR_API_KEY"

响应

成功响应为 CrossInfoResponse 模型的JSON格式。

响应示例

{
  "status": 10000,
  "msg": "OK",
  "trace_id": "ac197dab67ecfc86cae83742d7dd86b0",
  "results": [
    {
      "crossId": 9000119041941,
      "crossName": "顺黄路,孙河组团六号路交界",
      "longitude": 11652326,
      "latitude": 4005840,
      "cityCode": 1,
      "systemTimeStamp": 1743584391
    },
    {
      "crossId": 9000119042039,
      "crossName": "北清路,八街交界",
      "longitude": 11645078,
      "latitude": 4004600,
      "cityCode": 1,
      "systemTimeStamp": 1743584391
    }
  ]
}

获取路口信号灯状态 API

接口描述

获取特定路口的信号灯相位状态信息，包括红绿灯的持续时间和当前状态。

请求方式

• HTTP 方法: GET / POST
• 请求URL: /api/v2/trafficlight

请求参数

查询参数（GET）

参数名	必选	类型	描述	示例值
key	是	string	鉴权用的 API Key	YOUR_API_KEY
citycode	是	string	城市代码，见城市代码表	1
crossid	是	string	路口ID	9000119041941

请求示例

curl -X GET "https://lbs.xiaojukeji.com/api/v2/trafficlight?key=YOUR_API_KEY&crossid=9000119041941"

响应

成功响应为包含信号灯相位状态的JSON格式。

响应示例

{
  "status": 10000,
  "msg": "OK",
  "trace_id": "ac197dab67ecfc86cae83742d7dd86b0",
  "results": {
    "phases": [
      {
        "batchTime": 1743577200,
        "confidence": 100,
        "cycle": 86,
        "direction": 5,
        "greenDuration": 51,
        "redDuration": 31,
        "yellowDuration": 4,
        "lampStatus": 11,
        "version": "2.0",
        "offset": 84,
        "phaseStartTime": 1022,
        "phaseEndTime": 1032,
        "dir_points": [
          {
            "latitude": 3994079,
            "longitude": 11609452
          }
        ],
        "lamp_points": [
          {
            "latitude": 3994078,
            "longitude": 11609453
          }
        ]
      }
    ]
  }
}