Rail Info API (India)

Read-only API for Indian Railways stations, trains, schedules, and timetables. Static dataset. No real-time running status.

原始信息汇总

Rail Info API (India) 数据集概述

数据集基本信息

• 数据集名称：Rail Info API (India)
• 数据内容：印度铁路的静态数据，包括车站、列车、时刻表和时间表。
• 数据规模：包含8,100多个车站、11,100多列列车以及185,000多个计划停靠点。
• 数据性质：权威静态数据，非实时运行状态数据。
• 数据来源：data.gov.in（依据GODL-India许可）。
• 关联声明：与印度铁路或IRCTC无关。

核心特性

• 数据集版本化响应：每个响应都包含dataset_version_id，支持安全缓存、游标验证和条件请求。
• 生产就绪与审计：只读、确定性的数据集，具备强化的基础设施、完整性检查和版本化ETL。
• 多语言搜索：车站搜索支持英语、印地语（मुंबई）和别名。
• 丰富的列车数据：列车类型、停靠点数量、过夜标志、行程时间、平均速度。
• 变更订阅源：通过/v1/changes端点进行增量同步。
• 低延迟：中位响应时间约30–40毫秒。

数据详情

车站数据字段

• 多语言名称：英语、印地语（हिंदी）和地区语言。
• 地理坐标：7,800多个车站的纬度/经度。
• 别名：替代名称、缩写、音译。
• 车站代码：当前代码和历史代码。

列车数据字段

• 列车类型：Rajdhani、Shatabdi、Express、Passenger等。
• 过夜标志：is_overnight用于多日行程。
• 行程时间：总行程时间（分钟）。
• 平均速度：全程计算的平均速度（公里/小时）。
• 停靠点数量：车站数量。

停靠点（时刻表）数据字段

• 日期偏移：arrival_day_offset / departure_day_offset用于过夜列车。
• 停留时间：在每个车站停留的分钟数。
• 距离：距离起点的累计公里数。
• 停靠点角色：source、intermediate或destination。

主要API端点

元数据端点

• GET /v1/meta
• GET /v1/health
• GET /v1/ready

车站相关端点

• GET /v1/stations/search
• GET /v1/stations/nearby
• GET /v1/stations/{station_id}
• GET /v1/stations/{station_id}/aliases
• GET /v1/stations/{station_id}/timetable
• GET /v1/stations/{station_id}/departures
• GET /v1/stations/{station_id}/arrivals
• POST /v1/stations/resolve

列车相关端点

• GET /v1/trains/search
• GET /v1/trains/between
• GET /v1/trains/{train_id}
• GET /v1/trains/{train_id}/stops

变更订阅端点

• GET /v1/changes

使用场景

• 行程规划应用
• 车站和列车搜索
• 分析仪表板
• 离线优先的移动应用
• 搜索、规划、分析和缓存

版本管理

• API版本：合同稳定性（例如/v1/...）。
• 数据集版本：数据新鲜度（例如ds_20250115_120000_abc123）。
• 数据集更新不会破坏API合同。

响应格式

所有响应均遵循以下结构： json { "dataset_version_id": "ds_20250115_120000_abc123", "data": { ... }, "meta": { "limit": 10, "total": 42, "next_cursor": "eyJ2Ijoi..." } }

错误处理

常见错误代码包括：

• INVALID_INPUT
• STATION_NOT_FOUND
• TRAIN_NOT_FOUND
• RATE_LIMITED
• CURSOR_VERSION_MISMATCH

测试数据示例

• 车站代码：NDLS（新德里）、BCT（孟买中央）、CSMT（孟买CST）、MAS（金奈）、HWH（豪拉）、SBC（班加罗尔）、ADI（艾哈迈达巴德）、PUNE、JP（斋浦尔）、LKO（勒克瑙）。
• 列车编号：12951（孟买Rajdhani）、12952、12301（豪拉Rajdhani）、12309、12621（泰米尔纳德快车）、12627（卡纳塔克快车）。

订阅计划

• BASIC：$0.00 / 月
• PRO：$9.00 / 月
• ULTRA：$39.00 / 月

性能指标

• 流行度：9.2
• 服务等级：100%
• 延迟：239毫秒

搜集汇总

背景与挑战

背景概述

这是一个关于印度铁路的只读API数据集，提供车站、列车、时刻表和时间表等静态信息。该数据集不支持实时运行状态查询。