MTR Schedule API

This is a Node.js application that provides an API to retrieve MTR (Mass Transit Railway) train schedules for a specific line and station in Hong Kong. The API fetches real-time data from the Hong Kong Open Data platform.

Demo

Open your web browser and navigate to the following URL:

https://mtr.idata.host/EAL/HUH

Replace EAL with the code of the desired MTR line (e.g., AEL for Airport Express) and HUH with the code of the desired MTR station (e.g., HUH for Hung Hom). The API will return a JSON response containing the train schedule for the specified line and station.

iOS Shortcut Integration

Download iOS Shortcut Example
Open the Shortcuts app and import the downloaded shortcut.
Configure the shortcut by providing the desired line and station codes.
Run the shortcut to retrieve the train schedule.

Prerequisites

Node.js (version 12 or above)
NPM (Node Package Manager)

Installation

Clone the repository or download the code files.
Open a terminal and navigate to the project directory.
Install the dependencies by running the following command:
```
npm install
```

Usage

Start the server by running the following command:
```
npm start
```
The server will start running on http://localhost:3200.
Access the API using the following endpoint:
```
GET /api/v1/:line/:station
```
- Replace :line with the code of the desired MTR line (e.g., AEL for Airport Express).
- Replace :station with the code of the desired MTR station (e.g., HOK for Hong Kong).

The API will return a JSON response containing the train schedule for the specified line and station.

API Response

{
  "line": "East Rail Line",
  "station": "Hung Hom",
  "schedule": {
    "UP": [
      "Lok Ma Chau (15:57) in 1 mins",
      "Lo Wu (16:02) in 6 mins",
      "Lo Wu (16:06) in 10 mins",
      "Lok Ma Chau (16:10) in 14 mins"
    ],
    "DOWN": [
      "Admiralty (15:58) in 2 mins",
      "Admiralty (16:01) in 5 mins",
      "Admiralty (16:05) in 9 mins",
      "Admiralty (16:09) in 13 mins"
    ]
  }
}