Unified Transit API

One API for 5 major US transit systems. Real-time predictions, alerts, and vehicle positions in a consistent JSON format.

原始信息汇总

Unified Transit API 数据集概述

数据集基本信息

• 数据集名称: Unified Transit API (Metro API)
• 数据提供商: RapidAPI
• API类型: REST API
• 数据格式: JSON
• 数据更新: 实时数据，具有智能缓存机制（预测数据60秒，事件数据2分钟，站点和线路数据5分钟）

数据覆盖范围

聚合了美国五个主要城市公共交通系统的实时数据：

• WMATA: 华盛顿都会区交通管理局
• BART: 旧金山湾区捷运系统
• MTA: 纽约市大都会运输署（地铁和巴士）
• CTA: 芝加哥交通管理局
• 511 SF Bay: 旧金山交通局（Muni）

核心功能与数据内容

实时预测

• 列车和巴士的到站时间、状态和车厢数量
• 包含路线、目的地、等待时间、状态和行驶方向信息

站点信息

• 完整站点列表，包含坐标、服务线路和地址信息
• 站点详情包括ID、名称、经纬度、服务线路、类型和物理地址

线路目录

• 铁路线和巴士路线，按类型分类
• 线路详情包括ID、名称和类型（铁路/巴士）

服务事件

• 活动事件，包含受影响线路和时间戳
• 对于SF Bay系统，事件数据整合了交通服务警报和实时交通事件（施工、天气、道路封闭）

车辆位置

• 实时列车和巴士位置，包含路线和方向信息
• 位置数据包括纬度、经度、方位角、速度、车厢数量和服务类型

票价计算

• 站点到站点的票价查询
• 包含高峰、非高峰和老年人/残疾人票价等级

API端点概览

1. GET /health - 服务健康状态检查（无需认证）
2. GET /v1/systems - 获取支持的交通系统及其功能列表
3. GET /v1/{system}/predictions/{stationId} - 获取站点实时到达预测
4. GET /v1/{system}/stations - 获取指定交通系统的所有站点列表
5. GET /v1/{system}/stations/{id} - 获取单个站点详情（仅限WMATA和BART）
6. GET /v1/{system}/routes - 获取指定交通系统的所有线路
7. GET /v1/{system}/routes/{id} - 获取单个线路详情（仅限WMATA和BART）
8. GET /v1/{system}/incidents - 获取指定交通系统的活动服务事件（CTA不可用）
9. GET /v1/{system}/positions - 获取指定交通系统的实时车辆位置（BART不可用）
10. GET /v1/{system}/fares - 获取两个站点之间的票价（仅限WMATA和BART）

技术规格

认证方式

• 通过RapidAPI进行认证
• 需要在请求头中包含：X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
• /health端点无需认证

基础URL

https://metro-api.p.rapidapi.com

响应模式

所有端点返回一致的JSON模式，包含标准化的数据结构：

• Station（站点引用）
• StationDetail（完整站点记录）
• Prediction（到达预测）
• Route（线路记录）
• Incident（服务事件）
• Position（车辆位置）
• FareEntry（票价条目）
• SystemInfo（系统信息）

系统支持能力矩阵

系统ID	系统名称	预测	站点	线路	事件	位置	票价
wmata	华盛顿都会区交通管理局	✓	✓	✓	✓	✓	✓
bart	旧金山湾区捷运系统	✓	✓	✓	✓	✗	✓
mta	纽约市大都会运输署	✓	✓	✓	✓	✓	✗
cta	芝加哥交通管理局	✓	✓	✓	✗	✓	✗
sfbay	511 SF Bay (Muni)	✓	✓	✓	✓	✓	✗

数据特征

• 数据标准化: 无论来源系统如何，都使用一致的JSON模式
• 实时获取: 所有数据均为实时获取
• 智能缓存: 优化数据更新频率，平衡实时性和性能
• 统一接口: 无需集成多个专有API，无需数据抓取和格式转换