Nutzung der API Schnittstelle (TRIAS) mit API Token...

Submitted by ketscher1070 on 30.10.2020

Hallo,

anbei eine kleine Einleitung wie auf die TRIAS-Schnittstelle des VRN zugegriffen werden kann.

Mit dem Zugangspunkt

     https://www.vrn.de/service/entwickler/trias-test/

kann auf das Testsystem des VRN zugegriffen werden. Mit dem Zugriffspunkt

     https://www.vrn.de/service/entwickler/trias-live/

auf das live-system mit dem dahinterliegenden Server-Cluster...

 

Diese Beispielanfrage liefert Ihnen die eindeutige globalID für Schwetzingen, Schloß zurück.

<?xml version="1.0" encoding="utf-8" ?>
<Trias xmlns="http://www.vdv.de/trias" xmlns:siri="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.2">
<ServiceRequest>
<siri:RequestTimestamp>2019-11-271T15:17:28</siri:RequestTimestamp>
<siri:RequestorRef>gateway-api</siri:RequestorRef>
<RequestPayload>
<LocationInformationRequest>
<InitialInput>
<LocationName>schwetzingen, schloss</LocationName>
</InitialInput>
<Restrictions>
<Type>stop</Type>
</Restrictions>
</LocationInformationRequest>
</RequestPayload>
</ServiceRequest>
</Trias>

Diese Anfrage liefert Ihnen eine Fahrtempfehlung zwischen Schwetzingen, Bahnhof und Heidelberg, Bismarckplatz zurück.

<?xml version="1.0" encoding="utf-8" ?>
<Trias version="1.2" 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_1.2/Trias.xsd">
       <ServiceRequest>
             <siri:RequestTimestamp>2019-11-27T10:00:00Z</siri:RequestTimestamp>
             <siri:RequestorRef>gateway-api</siri:RequestorRef>
             <RequestPayload>
                    <TripRequest>
                           <Origin>
                                  <LocationRef>
                                        <StopPointRef>de:08226:3505</StopPointRef>
                                        <LocationName>
                                               <Text>Schwetzingen Bahnhof</Text>
                                               <Language>de</Language>
                                        </LocationName>
                                  </LocationRef>
                                  <DepArrTime>2019-11-27T10:00:00</DepArrTime>
                                  <IndividualTransportOptions>
                                        <Mode>walk</Mode>
                                        <MaxDistance>1000</MaxDistance>
                                        <MaxDuration>20</MaxDuration>
                                  </IndividualTransportOptions>
                                  <IndividualTransportOptions>
                                        <Mode>cycle</Mode>
                                        <MaxDistance>4000</MaxDistance>
                                        <MaxDuration>120</MaxDuration>
                                  </IndividualTransportOptions>
                                  <IndividualTransportOptions>
                                        <Mode>self-drive-car</Mode>
                                        <MaxDistance>10000</MaxDistance>
                                        <MaxDuration>100</MaxDuration>
                                  </IndividualTransportOptions>
                           </Origin>
                           <Destination>
                                  <LocationRef>
                                        <StopPointRef>de:08221:1146</StopPointRef>
                                        <LocationName>
                                               <Text>Heidelberg Bismarkplatz</Text>
                                               <Language>de</Language>                                
                                        </LocationName>
                                  </LocationRef>
                                  <IndividualTransportOptions>
                                        <Mode>walk</Mode>
                                        <MaxDistance>1000</MaxDistance>
                                        <MaxDuration>20</MaxDuration>
                                  </IndividualTransportOptions>
                                  <IndividualTransportOptions>
                                        <Mode>cycle</Mode>
                                        <MaxDistance>4000</MaxDistance>
                                        <MaxDuration>120</MaxDuration>
                                  </IndividualTransportOptions>
                                 <IndividualTransportOptions>
                                        <Mode>self-drive-car</Mode>
                                        <MaxDistance>10000</MaxDistance>
                                        <MaxDuration>100</MaxDuration>
                                  </IndividualTransportOptions>
                           </Destination>
                           <Params>
                                  <IncludeTurnDescription>true</IncludeTurnDescription>
                                  <IncludeTrackSections>true</IncludeTrackSections>
                                  <IncludeLegProjection>true</IncludeLegProjection>
                                  <IncludeIntermediateStops>true</IncludeIntermediateStops>
                                  <IncludeFares>true</IncludeFares>
                           </Params>
                    </TripRequest>
              </RequestPayload>
       </ServiceRequest>
</Trias>

Diese Anfrage liefert Ihnen eine Fahrtempfehlung zwischen Mannheim, Schloss und Schwetzingen, Schloss durch Eingabe von Koordinaten zurück.

<?xml version="1.0" encoding="UTF-8"?>
<Trias version="1.2" 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>2021-08-26T16:00:00Z</siri:RequestTimestamp>
        <siri:RequestorRef>Igateway-api</siri:RequestorRef>
        <siri:MessageIdentifier>4711</siri:MessageIdentifier>
        <RequestPayload>
            <TripRequest>
                <Origin>
                    <LocationRef>
                        <GeoPosition>
                            <Longitude>8.46344</Longitude>
                            <Latitude>49.48478</Latitude>
                        </GeoPosition>
                        <LocationName>
                            <Text>Test-1</Text>
                        </LocationName>
                    </LocationRef>
                </Origin>
                <Destination>
                    <LocationRef>
                        <GeoPosition>
                            <Longitude>8.57275</Longitude>
                            <Latitude>49.38436</Latitude>
                        </GeoPosition>
                        <LocationName>
                            <Text>Test-2</Text>
                        </LocationName>
                    </LocationRef>
                </Destination>
                <Params>
                    <NumberOfResults>10</NumberOfResults>
                    <IncludeIntermediateStops>true</IncludeIntermediateStops>
                </Params>
            </TripRequest>
        </RequestPayload>
    </ServiceRequest>
</Trias>

Achtung, ganz wichtig!!!

Bitte bei Ihren Anfragen an die API

     content-type text/xml
     Authorization API-KEY-DER-IHNEN-ZUGEWIESEN-WURDE-VERWENDEN

setzen.

Request an die API muss als POST erfolgen.

Viel Spaß beim nutzen der API des VRN, Grüße Markus Müller