当前位置：首页 > 行业动态 > 正文

爱帮公交api

admin
行业动态
2025-05-06
4981

爱帮公交API提供实时公交查询、线路规划及站点到站数据服务，助力智慧

爱帮公交API使用指南

API

爱帮公交API是一款提供实时公交查询服务的接口，支持通过关键词（如公交线路、站点名称）查询公交实时位置、预计到站时间等信息，适用于导航类应用、地图服务、智能公交站牌等场景。

核心功能

功能分类	说明
实时公交查询	根据线路号或站点名称，返回公交车辆当前位置及预计到站时间。
线路站点查询	查询指定公交线路的所有站点信息（包括站点名称、经纬度）。
附近站点查询	基于地理坐标，返回周边一定范围内的公交站点列表。

使用步骤

申请API权限
- 注册爱帮开放平台账号，创建应用并获取 API Key 和 Secret Key。

构建请求

请求方式：HTTPS POST
请求地址：https://api.aibang.com/bus/query
请求头：Content-Type: application/json

请求体示例：

{
  "api_key": "your_api_key",
  "city": "北京",
  "line_id": "101", // 可选，若为空则按站点查询
  "station_name": "天安门东" // 可选，与line_id二选一
}

解析响应

成功响应示例：

{
  "status": 1,
  "data": {
    "line_name": "101路",
    "stations": [
      {
        "name": "天安门东",
        "arrive_time": "5分钟",
        "location": {"lat": 39.908, "lng": 116.407}
      },
      {
        "name": "王府井",
        "arrive_time": "10分钟",
        "location": {"lat": 39.912, "lng": 116.418}
      }
    ]
  }
}

关键参数说明

参数名	类型	必填	说明
`api_key`	String	是	应用唯一标识，用于鉴权。
`city`	String	是	查询城市（如“上海”）。
`line_id`	String	否	公交线路编号（与`station_name`互斥）。
`station_name`	String	否	站点名称（与`line_id`互斥）。
`radius`	Int	否	附近站点查询半径（单位：米，默认500米）。

错误码处理

错误码	说明	解决方案
`10001`	`API Key无效`	检查密钥是否正确或申请新密钥。
`10002`	`城市参数为空`	补充`city`参数。
`10003`	`线路或站点未找到`	核对线路号/站点名称是否准确。
`10004`	`请求频率超限`	降低调用频率或联系客服提升配额。