interrail

Find european train stations and journeys. Client for the European Interrail / EuRail API. Inofficial, using endpoints by Interrail/EuRail. Ask them for permission before using this module in production.

This module conforms to the FPTI-JS 0.3.2 standard for JavaScript public transportation modules.

Installation

npm install interrail

Usage

const interrail = require('interrail')

The interrail module conforms to the FPTI-JS 0.3.2 standard for JavaScript public transportation modules and exposes the following methods:

Method	Feature description	FPTI-JS 0.3.2
stations.search(query, [opt])	Search stations by query.	✅ yes
journeys(origin, destination, [opt])	Journeys between stations	✅ yes

---

stations.search(query, [opt])

Search stations by query. See this method in the FPTI-JS 0.3.2 spec.

Supported Options

Attribute	Description	FPTI-spec	Value type	Default
results	Max. number of results returned	✅	Number	null

Example

interrail.stations.search('Ljubl', { results: 1 }).then(…)

[
    {
        "type": "station",
        "id": "7942300",
        "name": "LJUBLJANA (Slovenia)",
        "location": {
            "type": "location",
            "longitude": 14.51028,
            "latitude": 46.058057
        },
        "weight": 12185,
        "products": 28
    }
]

---

journeys(origin, destination, [opt])

Find journeys between stations. See this method in the FPTI-JS 0.3.2 spec.

Supported Options

Attribute	Description	FPTI-spec	Value type	Default
when	Journey date, synonym to departureAfter	✅	Date	new Date()
departureAfter	List journeys with a departure (first leg) after this date	✅	Date	new Date()
results	Max. number of results returned	✅	Number	null
interval	Results for how many minutes after when/departureAfter	✅	Number	null
transfers	Max. number of transfers	✅	Number	null
language	Language of the results	❌	ISO 639-1 code	null

Example

const berlin = '8065969' // station id
const ljubljana = { // FPTF station
    type: 'station',
    id: '7942300',
    name: 'Ljubljana'
    // …
}
 
interrail.journeys(berlin, ljubljana, { when: new Date('2018-11-02T05:00:00+0200') }).then(…)

[
    {
        "id": "8065969-2018-11-02t06-37-00…",
        "legs": [
            {
                "arrival": "2018-11-02T06:54:00+01:00",
                "departure": "2018-11-02T06:37:00+01:00",
                "destination": {
                    "id": "8003025",
                    "location": {
                        "latitude": 52.534722,
                        "longitude": 13.196947,
                        "type": "location"
                    },
                    "name": "BERLIN-SPANDAU (Germany)",
                    "type": "station"
                },
                "id": "8065969-2018-11-02t06-37-00-01-00-8003025-2018-11-02t06-54-00-01-00-rb-18604",
                "line": {
                    "id": "rb-18604",
                    "mode": "train",
                    "name": "RB 18604",
                    "public": true,
                    "type": "line"
                },
                "mode": "train",
                "operator": "interrail",
                "origin": {
                    "id": "8065969",
                    "location": {
                        "latitude": 52.525553,
                        "longitude": 13.369441,
                        "type": "location"
                    },
                    "name": "BERLIN HBF (Germany)",
                    "type": "station"
                },
                "public": true
            }
            // …
            {
                "arrival": "2018-11-02T18:32:00+01:00",
                "departure": "2018-11-02T12:17:00+01:00",
                "destination": {
                    "id": "7942300",
                    "location": {
                        "latitude": 46.058057,
                        "longitude": 14.51028,
                        "type": "location"
                    },
                    "name": "LJUBLJANA (Slovenia)",
                    "type": "station"
                },
                "id": "8020347-2018-11-02t12-17-00-01-00-7942300-2018-11-02t18-32-00-01-00-ec-113",
                "line": {
                    "id": "ec-113",
                    "mode": "train",
                    "name": "EC   113",
                    "public": true,
                    "type": "line"
                },
                "mode": "train",
                "operator": "interrail",
                "origin": {
                    "id": "8020347",
                    "location": {
                        "latitude": 48.140274,
                        "longitude": 11.55833,
                        "type": "location"
                    },
                    "name": "MUENCHEN HBF (Germany)",
                    "type": "station"
                },
                "public": true
            }
        ],
        "type": "journey"
    }
    // …
]

Contributing

If you found a bug or want to propose a feature, feel free to visit the issues page.