Journeys API - Muutoshistoria

ITdeveloper: luokat lisätty

2022-11-04T12:35:56Z

luokat lisätty

← Vanhempi versio		Versio 4. marraskuuta 2022 kello 15.35
Rivi 678:		Rivi 678:

	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.		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.
			[[Luokka:Api]]
			[[Luokka:Public Transport APIs]]
			[[Luokka:Tampere APIs]]

ITdeveloper: /* API Entities */

2022-10-31T13:05:18Z

API Entities

← Vanhempi versio		Versio 31. lokakuuta 2022 kello 16.05
Rivi 13:		Rivi 13:

	==API Entities==		==API Entities==
	The API is built on top of NeTEx entity model ~~(http://user47094.vs.easily.co.uk/netex/)~~, from which the entities in this API are derived. Following picture outlines the entities and their relationships.		The API is built on top of NeTEx entity model, from which the entities in this API are derived. Following picture outlines the entities and their relationships.

	[[File:API_Entities_1.1.png\|none]]		[[File:API_Entities_1.1.png\|none]]

ITdeveloper: /* About Tariff Zones */

2022-10-31T13:01:47Z

About Tariff Zones

← Vanhempi versio		Versio 31. lokakuuta 2022 kello 16.01
Rivi 497:		Rivi 497:
	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		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/en/tickets-fares/~~traffic-~~zones.html for more details on tariff zones.		Please see https://www.nysse.fi/en/tickets-and-fares/zones.html for more details on tariff zones.

	==== Municipalities ====		==== Municipalities ====

Juha.lundan: /* Query Parameter Reference */

2018-07-04T19:08:15Z

Query Parameter Reference

← Vanhempi versio		Versio 4. heinäkuuta 2018 kello 22.08
Rivi 127:		Rivi 127:
	<pre>		<pre>
	api/1/lines		api/1/lines
	~~- id : String~~
	- description : String		- description : String

Juha.lundan: /* Stop Points */

2016-06-30T13:53:25Z

Stop Points

← Vanhempi versio		Versio 30. kesäkuuta 2016 kello 16.53
Rivi 480:		Rivi 480:
	"name" : "Keskustori M",		"name" : "Keskustori M",
	"shortName" : "0001",		"shortName" : "0001",
	"tariffZone" : "1",		"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=1 will return list of all STOP POINTS within Tariff Zone 1.		* 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
	* "1" for Tariff Zone 1
	* "2" for Tariff Zone 2
	* "3" for Tariff Zone 3
	* "S" for Tariff Zone S ("Seutuliikenne", ~~regional transport)~~

	Please see http://joukkoliikenne.tampere.fi/fi/~~muutokset~~-~~tampereen-seudun-joukkoliikenteessa-30.6.2014~~/~~tariffijarjestelma-ja~~-~~vyohykejako~~.html ~~(in finnish)~~ for more details on tariff zones.		Please see http://joukkoliikenne.tampere.fi/en/tickets-fares/traffic-zones.html for more details on tariff zones.

	==== Municipalities ====		==== Municipalities ====

Juha.lundan: /* GTFS Zip files */

2016-06-30T13:21:43Z

GTFS Zip files

← Vanhempi versio		Versio 30. kesäkuuta 2016 kello 16.21
Rivi 677:		Rivi 677:

	* 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~~. Also please note that this delivery is considered to be under work and its contents might still change~~.		* 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==		==Support / Community==

Juha.lundan (19. kesäkuuta 2016 kello 11.58)

2016-06-19T11:58:29Z

← Vanhempi versio		Versio 19. kesäkuuta 2016 kello 14.58
Rivi 678:		Rivi 678:
	* 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. Also please note that this delivery is considered to be under work and its contents might still change.		* 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. Also please note that this delivery is considered to be under work and its contents might still change.

			==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.

Juha.lundan: /* Stop Monitoring */

2016-04-24T23:45:15Z

Stop Monitoring

← Vanhempi versio		Versio 25. huhtikuuta 2016 kello 02.45
Rivi 666:		Rivi 666:
	* 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==

Juha.lundan: /* Stop Monitoring */

2016-04-24T23:33:49Z

Stop Monitoring

← Vanhempi versio		Versio 25. huhtikuuta 2016 kello 02.33
Rivi 612:		Rivi 612:
	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

Juha.lundan: /* Vehicle Activity */

2016-04-24T23:33:28Z

Vehicle Activity

← Vanhempi versio		Versio 25. huhtikuuta 2016 kello 02.33
Rivi 608:		Rivi 608:

	http://data.itsfactory.fi/journeys/api/1/vehicle-activity?exclude-fields=monitoredVehicleJourney.onwardCalls,recordedAtTime		http://data.itsfactory.fi/journeys/api/1/vehicle-activity?exclude-fields=monitoredVehicleJourney.onwardCalls,recordedAtTime

			==Stop Monitoring==
			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>
			http://data.itsfactory.fi/journeys/api/1/stop monitoring?stops=0001,0002
			<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
			The call would result in a following response:
			<pre>
			{
			1001: [
			{
			lineRef: "3R",
			directionRef: "2",
			vehicleLocation: {
			longitude: "23.7337863",
			latitude: "61.5007787"
			},
			operatorRef: "TKL",
			bearing: "70",
			delay: "-P0Y0M0DT0H1M18.000S",
			vehicleRef: "TKL_41",
			journeyPatternRef: "3R",
			originShortName: "1028",
			destinationShortName: "0002",
			originAimedDepartureTime: "2016-04-23T02:35:00+03:00",
			call: {
			vehicleAtStop: false,
			expectedArrivalTime: "2016-04-23T02:53:00+03:00",
			expectedDepartureTime: "2016-04-23T02:53:00+03:00",
			aimedArrivalTime: "2016-04-23T02:55:00+03:00",
			aimedDepartureTime: "2016-04-23T02:55:00+03:00",
			departureStatus: "onTime",
			arrivalStatus: "onTime",
			visitNumber: "24",
			vehicleLocationAtStop: {
			longitude: "23.7337863",
			latitude: "61.5007787"
			}
			}
			}
			]
			}
			...
			</pre>

			The response contains a list of elements (grouped by requested stop short names) described above. Following fields are present:

			* lineRef specifies the line where the bus is currently operating.
			* directionRef sepecifies the direction the bus is travelling on the line. 1 = from origin stop to destination stop, 2= from destination stop back to origin stop.
			* originAimedDepartureTime specifies which time the vehicle departed from the origin stop
			* latitude and longitude specifies the map position of the vehicle at the time of the observation
			* originShortName specifies the number of the stop where the vehicle started
			* destinationShortName specifies the number of the stop where the bus is heading to
			* bearing specifies the direction the vehicle is travelling
			* delay specifies the relative time the vehicle is behind or ahead of its planned schedule
			* 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

	==GTFS Zip files==		==GTFS Zip files==