train-ose
v1.0.1
Published
Client for the Greek trainOSE railway API.
Downloads
24
Maintainers
Readme
train-ose
JavaScript client for the Greek 🇬🇷 trainOSE railway API. Inofficial, using trainOSE endpoints. Ask them for permission before using this module in production.
Installation
npm install --save train-ose
Usage
const trainOSE = require('train-ose')
The train-ose
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.all([opt])
| All stations of the TrainOSE network, such as Αθήνα
(Athens) or Θεσσαλονίκη
(Thessaloniki) | ✅ yes
journeys(origin, destination, [opt])
| Journeys between stations | ✅ yes
edges()
| All pairs of adjacent stations and their distance (as in edges of the greek railway network graph) | ❌ no
stations.all([opt])
Get all stations of the TrainOSE network, such as Αθήνα
(Athens) or Θεσσαλονίκη
(Thessaloniki). See this method in the FPTI-JS 0.3.2
spec.
Supported Options
There currently aren't any supported options for this method, but this might change in a future release.
Example
const trainOSE = require('train-ose')
const stationStream = trainOSE.stations.all()
stationStream.on('data', item => {
// item is an FPTF station object
console.log(item)
})
{
type: "station",
id: "ΑΘΗΝ",
name: "Αθήνα",
nameEnglish: "Athens",
location: {
type: "location",
longitude: 23.720840454101562,
latitude: 37.992610931396484,
country: "GR",
timezone: "Europe/Athens"
},
active: true
}
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
Please note that this module fetches a list of stations using the stations.all()
method upon initialization, which takes about 1 second.
Also note that, unless opt.interval
is specified, the module will return journeys that start after when
/departureAfter
, but before the beginning of the following calendar day in Europe/Athens
time zone.
Example
const athens = 'ΑΘΗΝ' // station id
const thessaloniki = { // FPTF station
type: 'station',
id: 'ΘΕΣΣ'
// …
}
trainOSE.journeys(athens, thessaloniki, { when: new Date('2019-06-27T05:00:00+0200'), transfers: 0 }).then(…)
{
type: "journey",
legs: [
{
origin: {
type: "station",
id: "ΑΘΗΝ",
name: "Αθήνα",
nameEnglish: "Athens",
location: {
type: "location",
longitude: 23.720840454101562,
latitude: 37.992610931396484,
country: "GR",
timezone: "Europe/Athens"
},
active: true
},
destination: {
type: "station",
id: "ΘΕΣΣ",
name: "Θεσσαλονίκη",
nameEnglish: "Thessaloniki",
location: {
type: "location",
longitude: 22.929779052734375,
latitude: 40.6444091796875,
country: "GR",
timezone: "Europe/Athens"
},
active: true
},
departure: "2019-06-27T06:22:00.000+03:00",
arrival: "2019-06-27T10:32:00.000+03:00",
mode: "train",
public: true,
operator: {
type: "operator",
id: "trainOSE",
name: "trainOSE",
url: "https://www.trainose.gr"
},
line: {
type: "line",
id: "50",
name: "50",
mode: "train",
operator: {
type: "operator",
id: "trainOSE",
name: "trainOSE",
url: "https://www.trainose.gr"
}
},
price: {
currency: "EUR",
amount: 25.1,
class: "B",
reduced: false,
available: 218
},
tariffs: [
{
currency: "EUR",
amount: 35.1,
class: "A",
reduced: false,
available: 52
},
{
currency: "EUR",
amount: 20.3,
class: "A",
reduced: true,
available: 52
},
{
currency: "EUR",
amount: 25.1,
class: "B",
reduced: false,
available: 218
},
{
currency: "EUR",
amount: 20.3,
class: "B",
reduced: true,
available: 218
}
]
}
],
price: {
amount: 25.1,
currency: "EUR",
class: "B",
reduced: false,
available: 218
},
id: "ΑΘΗΝ_2019-06-27T06:22:00.000+03:00_ΘΕΣΣ_2019-06-27T10:32:00.000+03:00_50"
}
edges()
All pairs of adjacent stations and their distance (as in edges of the greek railway network graph). Returns a Readable
stream in object mode.
Example
const edgeStream = trainOSE.edges()
edgeStream.on('data', item => {
console.log(item)
})
{
"source": "ΑΓΥΑ",
"target": "ΚΑΣΛ",
"distance": 2.1
}
Contributing
If you found a bug, want to propose a feature or feel the urge to complain about your life, feel free to visit the issues page.