Skip to content

trainline-eu/stations

Repository files navigation

Stations - A Database of European Train Stations

Build Status

Trainline EU sells tickets for numerous train operators across Europe.

This repository contains the information Trainline EU uses to identify stations across the diverse systems of the train operators.

If you want to contribute to this database, please read CONTRIBUTING.md.

Licence

The file stations.csv is distributed under the Open Database License (ODbL) licence, see LICENCE.txt. In short, any modification to this data source must be published.

Data come from the following sources:

All these sources were released under ODbL or compatible licences.

Tests

If you're going to modify the file, don't forget to run the automated tests to ensure consistency of the information provided. This script is used in the build triggered by merge requests.

make install
make test

The Data

The file stations.csv contains all our data representing train stations and cities. The file is UTF-8 encoded text file and Comma Separated Value (CSV) formatted – although a semi-colon ; is used to delimitate fields. Boolean flags are represented with t/f (true/false) values.

Columns

Column Name Notes
id Internal unique identifier.
name Name of the station as it is locally known; see info_* for translations.
slug Guaranteed to be unique across all the suggestable stations; see is_suggestable.
uic The UIC code of the station.
uic8_sncf SNCF sometimes uses an UIC code with 8 digits instead of 7. The last digit is a checksum.
longitude Coordinates as decimal value.
latitude Coordinates as decimal value.
parent_station_id A station can belong to a meta station whose id is this value, i.e. Paris Gare d’Austerlitz belongs to the metastation Paris.
country 2 letters, ISO 3166-1 alpha-2
time_zone Continent/Country ISO codes.
is_city This value is unreliable.
is_main_station This value is unreliable.
is_airport Specify if the station is related to an airport.
is_suggestable Specify if the user can input this station.
country_hint Specify if the country should be displayed to disambiguate the station's name.
sncf_self_service_machine Presence of a SNCF self-service machine at the station.
same_as Some systems allow stations to be split in two, with two id values. If provided, the station identified by the given value should be considered as the actual station.
normalised_code an identifier, which can be used to identify if 2 locations across multiple synchronised sources represent the same location.

Operator Specific

Operator specific columns contain identifiers and values specific to the operator. Columns are prefixed with a name unique to the operator. rt* columns are about ids used in realtime APIs.

Column Name Notes
*_id id of the station as it is known by the carrier.
*_is_enabled Can a ticket be booked to/from the station through that carrier?
sncf_id
sncf_is_enabled
idtgv_id
idtgv_is_enabled
db_id
db_is_enabled
hkx_id
hkx_is_enabled
busbud_id
busbud_is_enabled
flixbus_id
flixbus_is_enabled
leoexpress_id
leoexpress_is_enabled
cff_id
cff_is_enabled
ouigo_id
ouigo_is_enabled
trenitalia_id
trenitalia_is_enabled
trenitalia_rtvt_id
ntv_id
ntv_is_enabled
ntv_rtiv_id
hkx_id
hkx_is_enabled
renfe_id
renfe_is_enabled
atoc_id
atoc_is_enabled
benerail_id
benerail_is_enabled

Internationalisation

Language specific info columns contain translations of the station name. The language used is suffixed as an ISO 639-1:2002 code.

Column Name Notes
info:* Extra information that is useful in the specific language.
info:de
info:en
info:es
info:fr
info:it
info:nb
info:nl
info:cs
info:da
info:hu
info:ja
info:ko
info:pl
info:pt
info:ru
info:sv
info:tr
info:zh

Productivity tools

For internationalisation

To facilitate the internationalisation of city names, we use and maintain a script querying Geonames API to look for city name translations.

The project is hosted on Github and contains its own documentation.