approved, byrokraatit, ylläpitäjät
0
muokkausta
Ero sivun ”Journeys API” versioiden välillä
Journeys API (näytä wikiteksti)
Versio 30. kesäkuuta 2016 kello 16.53
, 30. kesäkuuta 2016 kello 16.53→Stop Points
| (4 välissä olevaa versiota samalta käyttäjältä ei näytetä) | |||
| Rivi 480: | Rivi 480: | ||
"name" : "Keskustori M", | "name" : "Keskustori M", | ||
"shortName" : "0001", | "shortName" : "0001", | ||
"tariffZone" : " | "tariffZone" : "A", | ||
"municipality" : { | "municipality" : { | ||
"url" : "http://data.itsfactory.fi/journeys/api/1/municipalities/837", | "url" : "http://data.itsfactory.fi/journeys/api/1/municipalities/837", | ||
| Rivi 493: | Rivi 493: | ||
* http://data.itsfactory.fi/journeys/api/1/stop-points?location=61.69978,23.89121 will return STOP POINTS that reside at given coordinates | * http://data.itsfactory.fi/journeys/api/1/stop-points?location=61.69978,23.89121 will return STOP POINTS that reside at given coordinates | ||
* http://data.itsfactory.fi/journeys/api/1/stop-points?location=61.49978,23.69121:61.79978,23.99121 will return STOP POINTS that start within given coordinate box. Format: (upper left corner of the box):(lower right corner of the box) | * http://data.itsfactory.fi/journeys/api/1/stop-points?location=61.49978,23.69121:61.79978,23.99121 will return STOP POINTS that start within given coordinate box. Format: (upper left corner of the box):(lower right corner of the box) | ||
* http://data.itsfactory.fi/journeys/api/1/stop-points?tariffZone= | * http://data.itsfactory.fi/journeys/api/1/stop-points?tariffZone=A will return list of all STOP POINTS within Tariff Zone A | ||
===== About Tariff Zones ===== | ===== About Tariff Zones ===== | ||
Journeys API returns tariff zones as tariff zone ids defined by City of Tampere. Valid tariff zone ids are: | Journeys API returns tariff zones as tariff zone ids defined by City of Tampere. Valid tariff zone ids are: A,B,C,D,E,F and G | ||
Please see http://joukkoliikenne.tampere.fi/ | Please see http://joukkoliikenne.tampere.fi/en/tickets-fares/traffic-zones.html for more details on tariff zones. | ||
==== Municipalities ==== | ==== Municipalities ==== | ||
| Rivi 612: | Rivi 608: | ||
Journeys API allows clients to access real-time location of vehicles moving through the street network from stop point perspective. To do this, client would make a HTTP GET request to url | Journeys API allows clients to access real-time location of vehicles moving through the street network from stop point perspective. To do this, client would make a HTTP GET request to url | ||
<br><br> | <br><br> | ||
http://data.itsfactory.fi/journeys/api/1/stop monitoring?stops=0001,0002 | http://data.itsfactory.fi/journeys/api/1/stop-monitoring?stops=0001,0002 | ||
<br><br> | <br><br> | ||
where stops argument contains a list of stop short names for which to fetch the data. NOTE: you can specify at maximum 100 stop short names into single request | where stops argument contains a list of stop short names for which to fetch the data. NOTE: you can specify at maximum 100 stop short names into single request | ||
| Rivi 666: | Rivi 662: | ||
* vehicleRef uniquely identifies the monitored vehicle | * vehicleRef uniquely identifies the monitored vehicle | ||
* call element tells when the journey is expected to reach the requested stop, as well as its departure estimation | * call element tells when the journey is expected to reach the requested stop, as well as its departure estimation | ||
The response data changes once in a minute, so clients are not recommended to poll the interface very often. | |||
==GTFS Zip files== | ==GTFS Zip files== | ||
| Rivi 675: | Rivi 673: | ||
* gtfs_tampere.zip is a file which adheres strictly to GTFS format. This file however does not include all information available via Journeys API GTFS Zip files. Use this file when you need to be fully compatible with GTFS | * gtfs_tampere.zip is a file which adheres strictly to GTFS format. This file however does not include all information available via Journeys API GTFS Zip files. Use this file when you need to be fully compatible with GTFS | ||
* extended_gtfs_tampere.zip is a file which extends standard GTFS Zip file with information about tariff zones and municipalities. Use this file when you need the extra info and when you do not need to be fully compatible with GTFS. Please note however, that extended GTFS Zip file is not in conflict with GTFS specification, but extends it. So in most cases you should be able to use it. | * extended_gtfs_tampere.zip is a file which extends standard GTFS Zip file with information about tariff zones and municipalities. Use this file when you need the extra info and when you do not need to be fully compatible with GTFS. Please note however, that extended GTFS Zip file is not in conflict with GTFS specification, but extends it. So in most cases you should be able to use it. | ||
==Support / Community== | |||
You can contact us via email: dev-support@itsfactory.fi | |||
You can also visit Journeys API Facebook page at https://www.facebook.com/journeysapi, where we update news and other noteworthy issues and you can ask questions as well. | |||