rtgnx/scotrail-api

Scotrail API镜像

镜像概述

本镜像封装了ScotRail（苏格兰铁路）的API服务，提供实时列车状态、车站信息查询等功能，适用于需要集成苏格兰铁路数据的应用开发或数据分析场景。

核心功能

• 实时列车看板：通过车站代码获取该站实时列车出发/到达信息（含预期状态、运营商等）
• 服务详情：通过服务ID获取列车经停站及各站状态
• 车站详情：通过车站代码获取车站坐标、名称等基础信息
• 车站搜索：通过关键词搜索相关车站列表
• 最近车站：根据经纬度获取距离最近的车站及距离
• 所有车站：获取所有支持查询的车站列表

使用场景

• 开发铁路信息查询类应用
• 分析苏格兰铁路运营数据
• 集成到旅行规划工具中

配置与部署说明

构建与运行（基于Makefile）

bash
# 运行单元测试
go test
# 构建Docker镜像
make build
# 构建并启动容器
make run
# 更新镜像并重启容器
make update

Docker直接部署示例

构建镜像

bash
docker build -t rtgnx/scotrail-api .

启动容器

bash
docker run -d -p 8080:8080 rtgnx/scotrail-api

API接口说明

实时列车看板

Endpoint: GET /live/:station_code
示例请求:

bash
curl -X GET http://localhost:8080/live/GLC

服务详情

Endpoint: GET /service/:service_id
示例请求:

bash
curl -X GET http://localhost:8080/service/lq3VvvsPFW1qAqJQ5qeb9Q%3D%3D

车站详情

Endpoint: GET /station/:station_code
示例请求:

bash
curl -X GET http://localhost:8080/station/EXG

车站搜索

Endpoint: GET /search/:name
示例请求:

bash
curl -X GET http://localhost:8080/search/Glasgow

最近车站

Endpoint: GET /nearest/:lat:/:lon:
示例请求:

bash
curl -X GET http://localhost:8080/nearest/55.860150/-4.259308

所有车站

Endpoint: GET /stations
示例请求:

bash
curl -X GET http://localhost:8080/stations