LocationInformationRequest (TRIAS 2020)

(TRIAS LocationInformationRequest)

Fachliche Beschreibung
Technische Aspekte

Fachliche Beschreibung

Location Information Request
Der Location Information Request liefert verschiedene Location als Antwort auf eine Anfrage. Wesentliche Inputdaten sind:

textueller Input
Erlaubte Objekttypen
Geographische Restriktionen/Gewichtung
Weitere Einschränkungen

Die Ausgabe ist eine Liste von Objekten mit Namen, geographischer Position, Attributen und einer Wahrscheinlichkeit.

Wird der LocationInformationRequest ohne LocationName, aber mit GeoPosition, Circle oder Rectangle verwendet, so ist nur der type=“stop“ unterstützt. Zusätzlich GeoPosition mit type=“address“ liefert genau eine Adresse mit Hausnummer.

Technische Aspekte

Der TRIAS-LocationInformationRequest (LIR) funktioniert grundsätzlich gleich wie der LIR des OpenJourneyPlanners (OJP). Abgesehen von den höheren Ebenen sowie den Elementbezeichnungen, welche beim OJP oft mit einem “ojp:” beginnen, ist der TRIAS-LIR sehr ähnlich. Eine ausführliche Beschreibung steht auf der entsprechenden Cookbook-Seite des LIR des OpenJourneyPlanners (OJP) zur Verfügung.

Insbesondere finden sich auf der Cookbook-Seite des LIR des OpenJourneyPlanners (OJP) die Beschreibungen aller Elemente und Parameter. Mit dem API-Explorer für TRIAS können diese ausprobiert und weiter exploriert werden. Ebenso können die unten angeführten Beispiele durchgespielt werden.

API Explorer

Achtung: zuerst Template auswählen (Location Information Request)

Autorisierung und Open Services

Für den Zugriff auf diese API ist ein API-Key notwendig. Es kann über das Developer Portal bezogen werden.
Das Token muss im HTTP Header als “Authorization” mitgeschickt werden.

URL für den Aufruf

API: https://api.opentransportdata.swiss/trias2020

Test-Key: 57c5dbbbf1fe4d000100001842c323fa9ff44fbba0b9b925f0c052d1

Mit dem Authorization Header und Content-Type= “text/XML” oder “application/XML”

Authorization header

Beispiel-Requests

Suche nach Name:

<?xml version="1.0" encoding="UTF-8"?>
<Trias version="1.1" xmlns="http://www.vdv.de/trias" xmlns:siri="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.vdv.de/trias ../trias-xsd-v1.1/Trias.xsd">
	<ServiceRequest>
		<siri:RequestorRef>TRIAS-Test</siri:RequestorRef>
		<siri:MessageIdentifier>9999</siri:MessageIdentifier>
		<RequestPayload>
			<LocationInformationRequest>
				<InitialInput>
					<LocationName>Chäs und Brot</LocationName>
				</InitialInput>
				<Restrictions>
					<Type>stop</Type>
				</Restrictions>
			</LocationInformationRequest>
		</RequestPayload>
	</ServiceRequest>
</Trias>

<?xml version="1.0" encoding="UTF-8"?>

<siri:RequestorRef>TRIAS-Test</siri:RequestorRef>

<siri:MessageIdentifier>9999</siri:MessageIdentifier>

</InitialInput>

</Restrictions>

</LocationInformationRequest>

</RequestPayload>

</ServiceRequest>

</Trias>

Suche mit Koordinaten:

<?xml version="1.0" encoding="UTF-8"?>
<Trias version="1.1" xmlns="http://www.vdv.de/trias" xmlns:siri="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.vdv.de/trias ../trias-xsd-v1.1/Trias.xsd">
    <ServiceRequest>
        <siri:RequestTimestamp>2020-01-28T12:00:00Z</siri:RequestTimestamp>
        <siri:RequestorRef>TRIAS-Test</siri:RequestorRef>
        <siri:MessageIdentifier>9999</siri:MessageIdentifier>
        <RequestPayload>
            <LocationInformationRequest>
                <InitialInput>
                    <GeoPosition>
                        <Longitude>8.5545</Longitude>
                        <Latitude>47.365</Latitude>
                    </GeoPosition>
                </InitialInput>
                <Restrictions>
                    <Type>stop</Type>
                </Restrictions>
            </LocationInformationRequest>
        </RequestPayload>
    </ServiceRequest>
</Trias>

<?xml version="1.0" encoding="UTF-8"?>

<siri:RequestTimestamp>2020-01-28T12:00:00Z</siri:RequestTimestamp>

<siri:RequestorRef>TRIAS-Test</siri:RequestorRef>

<siri:MessageIdentifier>9999</siri:MessageIdentifier>

</GeoPosition>

</InitialInput>

</Restrictions>

</LocationInformationRequest>

</RequestPayload>

</ServiceRequest>

</Trias>

Suche nach Haltestelle(n) innerhalb eines bestimmten Perimeters:

<?xml version="1.0" encoding="UTF-8"?>
<Trias version="1.1" xmlns="http://www.vdv.de/trias" xmlns:siri="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.vdv.de/trias ../trias-xsd-v1.1/Trias.xsd">
    <ServiceRequest>
        <siri:RequestTimestamp>2020-04-24T12:00:00Z</siri:RequestTimestamp>
        <siri:RequestorRef>TRIAS-Test</siri:RequestorRef>
        <siri:MessageIdentifier>9999</siri:MessageIdentifier>
        <RequestPayload>
            <LocationInformationRequest>
                <InitialInput>
                    <GeoRestriction>
                        <Circle>
                            <Center>
                                <Longitude>8.5545</Longitude>
                                <Latitude>47.365</Latitude>
                            </Center>
                            <Radius>500</Radius>
                        </Circle>
                    </GeoRestriction>
                </InitialInput>
                <Restrictions>
                    <Type>stop</Type>
                 </Restrictions>
            </LocationInformationRequest>
        </RequestPayload>
    </ServiceRequest>
</Trias>

<?xml version="1.0" encoding="UTF-8"?>

<siri:RequestTimestamp>2020-04-24T12:00:00Z</siri:RequestTimestamp>

<siri:RequestorRef>TRIAS-Test</siri:RequestorRef>

<siri:MessageIdentifier>9999</siri:MessageIdentifier>

</Center>

</Circle>

</GeoRestriction>

</InitialInput>

</Restrictions>

</LocationInformationRequest>

</RequestPayload>

</ServiceRequest>

</Trias>

Response

<?xml version="1.0" encoding="UTF-8"?>
<trias:Trias xmlns:siri="http://www.siri.org.uk/siri" xmlns:trias="http://www.vdv.de/trias" xmlns:acsb="http://www.ifopt.org.uk/acsb" xmlns:ifopt="http://www.ifopt.org.uk/ifopt" xmlns:datex2="http://datex2.eu/schema/1_0/1_0" version="1.1">
    <trias:ServiceDelivery>
        <siri:ResponseTimestamp>2020-09-10T07:25:17Z</siri:ResponseTimestamp>
        <siri:ProducerRef>EFAController10.4.6.43-OJP-EFA01-P</siri:ProducerRef>
        <siri:Status>true</siri:Status>
        <trias:Language>de</trias:Language>
        <trias:CalcTime>39</trias:CalcTime>
        <trias:DeliveryPayload>
            <trias:LocationInformationResponse>
                <trias:Location>
                    <trias:Location>
                        <trias:StopPoint>
                            <trias:StopPointRef>8571439</trias:StopPointRef>
                            <trias:StopPointName>
                                <trias:Text>Oberbottigen, Chäs und Brot</trias:Text>
                                <trias:Language>de</trias:Language>
                            </trias:StopPointName>
                            <trias:LocalityRef>23006351:1</trias:LocalityRef>
                        </trias:StopPoint>
                        <trias:LocationName>
                            <trias:Text>Bern</trias:Text>
                            <trias:Language>de</trias:Language>
                        </trias:LocationName>
                        <trias:GeoPosition>
                            <trias:Longitude>7.35537</trias:Longitude>
                            <trias:Latitude>46.93565</trias:Latitude>
                        </trias:GeoPosition>
                    </trias:Location>
                    <trias:Complete>true</trias:Complete>
                    <trias:Probability>0.958999991</trias:Probability>
                </trias:Location>
            </trias:LocationInformationResponse>
        </trias:DeliveryPayload>
    </trias:ServiceDelivery>
</trias:Trias>

<?xml version="1.0" encoding="UTF-8"?>

<trias:Trias xmlns:siri="http://www.siri.org.uk/siri" xmlns:trias="http://www.vdv.de/trias" xmlns:acsb="http://www.ifopt.org.uk/acsb" xmlns:ifopt="http://www.ifopt.org.uk/ifopt" xmlns:datex2="http://datex2.eu/schema/1_0/1_0" version="1.1">

<trias:ServiceDelivery>

<siri:ResponseTimestamp>2020-09-10T07:25:17Z</siri:ResponseTimestamp>

<siri:ProducerRef>EFAController10.4.6.43-OJP-EFA01-P</siri:ProducerRef>

<siri:Status>true</siri:Status>

<trias:Language>de</trias:Language>

<trias:CalcTime>39</trias:CalcTime>

<trias:DeliveryPayload>

<trias:LocationInformationResponse>

<trias:Location>

<trias:StopPoint>

<trias:StopPointRef>8571439</trias:StopPointRef>

<trias:StopPointName>

<trias:Text>Oberbottigen, Chäs und Brot</trias:Text>

<trias:Language>de</trias:Language>

</trias:StopPointName>

<trias:LocalityRef>23006351:1</trias:LocalityRef>

</trias:StopPoint>

<trias:LocationName>

<trias:Text>Bern</trias:Text>

<trias:Language>de</trias:Language>

</trias:LocationName>

<trias:GeoPosition>

<trias:Longitude>7.35537</trias:Longitude>

<trias:Latitude>46.93565</trias:Latitude>

</trias:GeoPosition>

</trias:Location>

<trias:Complete>true</trias:Complete>

<trias:Probability>0.958999991</trias:Probability>

</trias:Location>

</trias:LocationInformationResponse>

</trias:DeliveryPayload>

</trias:ServiceDelivery>

</trias:Trias>

Weitere Erläuterungen finden sich auf der Cookbook-Seite des LIR des OpenJourneyPlanners (OJP).