Welcome!

Local Journey Planner

These are systems with limited spatial planning ability that serve for regional or country wide trip planning. They have already implemented a web portal that offers routing in the region they are designated for. By making use of the central node web service (and possibly displaying the extended cross-border routing results via their own GUI), the coverage of these services can be extended to the effect that transnational routing can be offered. In order to communicate with other nodes of the distributed system, every local journey planner will have to develop a web service using the common OpenAPI interface, which will have to be able to transfer data in a translated format between local protocols and the ones used by the distributed system.

In case the local systems are overlapping, the system with extended coverage could cover the routing between the exchange points without the necessity to involve the IRS.

POST /ljp/TripRequest Returns the routes between exchange points.

Request body

Example value

minimal
full

<?xml version="1.0" encoding="UTF-8"?>
<siri:OJPRequest xmlns:siri="http://www.siri.org.uk/siri" xmlns:acsb="http://www.ifopt.org.uk/acsb"
	xmlns:ifopt="http://www.ifopt.org.uk/ifopt" xmlns="http://www.vdv.de/ojp"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="
	http://www.siri.org.uk/siri http://linkingdanube.hbit.sztaki.hu/xsd/ld_siri_v2.0.xsd
	http://www.vdv.de/ojp http://linkingdanube.hbit.sztaki.hu/xsd/ld_ojp_v1.0.xsd
	http://www.ifopt.org.uk/ifopt http://linkingdanube.hbit.sztaki.hu/xsd/ld_ifopt_v0.3.xsd
	http://www.ifopt.org.uk/acsb http://linkingdanube.hbit.sztaki.hu/xsd/ld_acsb_v0.3.xsd">
	<siri:ServiceRequest>
		<siri:RequestTimestamp>2123-10-10T09:00:00</siri:RequestTimestamp>
		<siri:AccountId>LinkingDanubeAPI</siri:AccountId>
		<siri:AccountKey>2345fglsfkgertwertw3452354</siri:AccountKey>
		<siri:RequestorRef>REQUESTOR_ID_234234</siri:RequestorRef>
		<siri:MessageIdentifier>MSG_ID_3452345</siri:MessageIdentifier>
		<OJPTripRequest>
			<siri:RequestTimestamp>2123-10-10T09:00:00</siri:RequestTimestamp>
			
			<Origin>
				<PlaceRef>
					
					<StopPlaceRef>hu:01:STOP_POINT_123123</StopPlaceRef>
					<LocationName>
						<Text>Budapest Keleti Palyaudvar</Text>
					</LocationName>
				</PlaceRef>
			</Origin>
			<Destination>
				<PlaceRef>
					
					<StopPlaceRef>at:01:STOP_POINT_123323</StopPlaceRef>
					<LocationName>
						<Text>Vienna Hauptbahnhof</Text>
					</LocationName>
				</PlaceRef>
			</Destination>
		</OJPTripRequest>
	</siri:ServiceRequest>
</siri:OJPRequest>

Response body

Example value

POST /ljp/LocationInformationRequest/InitialInput Returns location information.

Request body

Example value

Response body

Example value

full
error

<?xml version="1.0" encoding="UTF-8"?>
<siri:OJPResponse xmlns:siri="http://www.siri.org.uk/siri" xmlns:acsb="http://www.ifopt.org.uk/acsb"
	xmlns:ifopt="http://www.ifopt.org.uk/ifopt" xmlns="http://www.vdv.de/ojp"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="
	http://www.siri.org.uk/siri http://linkingdanube.hbit.sztaki.hu/xsd/ld_siri_v2.0.xsd
	http://www.vdv.de/ojp http://linkingdanube.hbit.sztaki.hu/xsd/ld_ojp_v1.0.xsd
	http://www.ifopt.org.uk/ifopt http://linkingdanube.hbit.sztaki.hu/xsd/ld_ifopt_v0.3.xsd
	http://www.ifopt.org.uk/acsb http://linkingdanube.hbit.sztaki.hu/xsd/ld_acsb_v0.3.xsd">
	<siri:ServiceDelivery>
		<siri:ResponseTimestamp>2212-01-01T01:01:01</siri:ResponseTimestamp>

<OJPLocationInformationDelivery>
			<siri:ResponseTimestamp>2212-01-01T01:01:01</siri:ResponseTimestamp>
			
			<Location>
				
				<Location>
					<StopPoint>
						
						<siri:StopPointRef>hu:01:STOP_POINT_ID_12341234</siri:StopPointRef>
						
						<StopPointName>
							<Text>Budapest Keleti Palyaudvar Vasutallomas</Text>
						</StopPointName>
						
						<WheelchairAccessible>false</WheelchairAccessible>
						<Lighting>false</Lighting>
						<Covered>false</Covered>
					</StopPoint>
					<LocationName>
						<Text>Budapest Keleti Palyaudvar</Text>
					</LocationName>
					
					<GeoPosition>
						
						<siri:Longitude>1.3231</siri:Longitude>
						<siri:Latitude>34.432423</siri:Latitude>
					</GeoPosition>
				</Location>
				<Complete>true</Complete>
				
			</Location>
			<Location>
				
				<Location>
					<Address>
						
						<AddressCode>hu:01:ADDRESS_ID_123123123</AddressCode>
						
						<AddressName>
							<Text>1111 Budapest, Keleti Ter 123.</Text>
						</AddressName>
						
						<PostCode>1111</PostCode>
						<TopographicPlaceName>Budapest</TopographicPlaceName>
						<TopographicPlaceRef>IGNORED_123</TopographicPlaceRef>
						<Street>Keleti Ter</Street>
						<HouseNumber>123</HouseNumber>
						<CrossRoad>Crossing of A street and B street</CrossRoad>
					</Address>
					<LocationName>
						<Text>1111 Budapest, Keleti Ter 123.</Text>
					</LocationName>
					
					<GeoPosition>
						<siri:Longitude>1.123</siri:Longitude>
						<siri:Latitude>2.321</siri:Latitude>
					</GeoPosition>
				</Location>
				<Complete>true</Complete>
			</Location>
			<Location>
				
				<Location>
					<PointOfInterest>
						
						<PointOfInterestCode>hu:01:POI_ID_1231231234</PointOfInterestCode>
						
						<PointOfInterestName>
							<Text>A very interesting place</Text>
						</PointOfInterestName>
						
						<PointOfInterestCategory>
							<OsmTag>
								<Tag>tourism</Tag>
								<Value>yes</Value>
							</OsmTag>
							<OsmTag>
								<Tag>leisure</Tag>
								<Value>hostel</Value>
							</OsmTag>
						</PointOfInterestCategory>
					</PointOfInterest>
					<LocationName>
						<Text>An interesting place near Budapest Keleti</Text>
					</LocationName>
					
					<GeoPosition>
						<siri:Longitude>1.123</siri:Longitude>
						<siri:Latitude>13.123</siri:Latitude>
					</GeoPosition>
				</Location>
				<Complete>true</Complete>
			</Location>
			
		</OJPLocationInformationDelivery>
	</siri:ServiceDelivery>
</siri:OJPResponse>