OpendataCH/Transport
Stars: 231
Forks: 49
Pull Requests: 79
Issues: 136
Watchers: 28
Last Updated: 2023-06-09 09:51:18
Swiss public transport API
License: MIT License
Languages: PHP, HTML, CSS, Dockerfile, Twig
The backend of the Transport API changed on 31 July 2017. Read more on opendata.ch.
Transport API
The Transport API allows interested developers to build their own applications using public timetable data, whether they're on the web, the desktop or mobile devices.
Feel free to fork this project implement your own ideas or send pull requests.
Installation
You can install the Transport API on your own server, however we recommend the usage of transport.opendata.ch.
$ git clone git://github.com/OpendataCH/Transport.git transport
$ cd transport
$ composer install
Also make sure, the directory transport/var/ is writable.
If you cloned the repository inside your document root, the API is now accessible at http://localhost/transport/web/api.php/v1/. However we recommend setting the document root to transport/web/ and using the provided .htaccess to route API requests to api.php.
Or you can start it with the PHP's built-in webserver (not recommended for a production setup, but the easy way to get started locally)
php -S localhost:8000
And then access it with http://localhost:8000/web/api.php
Configuration
To define your own configuration for the API copy the file config.php.sample to config.php and override the variables you want to change.
Statistics
You can get some basic statistics for the API by configuring a Redis server in your configuration ($redis) and have a look at http://localhost/transport/web/stats.php.
Development
XSD for the XML Fahrplan API is available here: hafasXMLInterface.xsd
Troubleshooting
Missing package php-xml
If you're running Ubuntu and composer install produces the error message
Your requirements could not be resolved to an installable set of packages.
you can try to install the package php-xml using the command
sudo apt install php-xml
OPEN ISSUES
See all- Stationboard combines stations without giving any info about it by @colinfrei
- Remove ressource "stationboard" by @gagarine
- Limit is buggy by @dbrgn
- Swiss train Ticket vs. Pass cost calculator by @Canswiss
- Train cancellations by @fabian
- /journeys resource by @fabian
- Country Identification in locations resource by @dmpour23
- Forward and backward connection count instead of limit by @dragoon
- Access data from ZVV using their HAFAS endpoint by @Feuermurmel
- Connections: Limit by region? by @staticdreams
- Add current time to stationboard response by @chdh
- Add train formation information by @fabian
- Option to change "walk speed" by @phiwut
- Rail traffic information (Störungen) by @phiwut
- Arrivals in stationboard by @ghost
- opentransportdata.swiss remake? by @phiwut
- Train search by @PCRefresh
- Add "Maybe Null" information to API object description in http://www.transport.opendata.ch/docs.html by @hansroland
- Release first version by @maidmaid
- Decouple the lib from the app by @maidmaid
- Service information not available by @fabian
- Category code not available by @fabian
- Journey number sometimes includes category by @fabian
- Realtime availability not reported correctly by @fabian
- Capacity information not available by @fabian
- Only Swiss coverage available by @fabian
- Improve documentation for transportation methods by @Floriferous
- Time in connections call doesn't take into account initial walk by @samkass
- Bus numbering is not consistent by @hb9tst
- passList stations name are null by @lbalogh
- First entry in /locations query resultset by @alexqmn
- Some trains missing from API by @CedricReichenbach
- Italian stations disappeared by @PCRefresh
- Locally hosted journey planner by @ltog
- Delay not reported anymore by @matitalatina
- Cancelled connections and platform changes by @ShiroYacha
- Possibility of knowing the trip/journey ID or querying the trip object by @ShiroYacha
- Station synonyms not mapped correctly, causing incorrect walk sections by @CedricReichenbach
- "type" ignored in locations query by @robachmann
- Is there any way to know the price per train section? by @kimokhun
- Parameter "bike" ignored by @fabian
- Stationboard for station "Altdorf UR, Spital" always shows Platform null by @kleestb
- Bus-connection in Biel always shows whole round-trip and ignores end-station by @adrha
- stationboard app for a KaiOs device by @strukturart
- Showcase needs a refresh by @loleg
- Walk time is 'null' in response, but is shown as a valid value on search.ch by @swiss-knight
- Trigger Hafas to put out the arrivial Data? by @nousername1
- Barrier / crossing location, opening and closing by @etoulas
- Last connection shown with isArrivalTime=1 is unstable across different values of limit parameter by @mbeer
- Missing train name by @Spillo17