Table des matières

Rechercher sur le site

OJPStopEventRequest 2.0

#AutoTranslate

Description rapide

Le service StopEvent sert à concevoir un écran des départs ou des arrivées. Tous les trajets à partir d’un arrêt et ses bordures d’arrêt attribuées sont inclus. Toutefois, contrairement au routeur, aucun arrêt voisin n’est affiché si aucun résultat n’est disponible au niveau demandé.

Description technique

Explorateur de l’API

Vous pouvez essayer vos propres requêtes – lien direct vers l’explorateur de l’API.

Demande

La demande s’effectue au moyen d’un OJPStopEventRequest, qui contient différents paramètres pour la demande, ci-dessous un exemple de Berne:

<OJP xmlns="http://www.vdv.de/ojp" xmlns:siri="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xsi:schemaLocation="http://www.vdv.de/ojp" version="2.0">
    <OJPRequest>
        <siri:ServiceRequest>
            <siri:ServiceRequestContext>
                <siri:Language>de</siri:Language>
            </siri:ServiceRequestContext>
            <siri:RequestTimestamp>2025-02-11T14:11:26.795Z</siri:RequestTimestamp>
            <siri:RequestorRef>SKIPlus</siri:RequestorRef>
            <OJPStopEventRequest>
                <siri:RequestTimestamp>2025-02-11T14:11:26.795Z</siri:RequestTimestamp>
                <siri:MessageIdentifier>SER_1</siri:MessageIdentifier>
                <Location>
                    <PlaceRef>
                        <siri:StopPointRef>8507000</siri:StopPointRef>
                        <Name>
                            <Text>Bern</Text>
                        </Name>
                    </PlaceRef>
                    <DepArrTime>2025-02-11T14:11:21.539Z</DepArrTime>
                </Location>
                <Params>
                    <NumberOfResults>10</NumberOfResults>
                    <StopEventType>departure</StopEventType>
                    <IncludePreviousCalls>true</IncludePreviousCalls>
                    <IncludeOnwardCalls>true</IncludeOnwardCalls>
                    <UseRealtimeData>full</UseRealtimeData>
                </Params>
            </OJPStopEventRequest>
        </siri:ServiceRequest>
    </OJPRequest>
</OJP>

Les paramètres de la OJPStopEventRequestStructure:

Élément Cardinalité Description Exemple
RequestTimestamp 1:1 Horodatage de la demande. De préférence, heure UTC. 
<siri:RequestTimestamp>2025-02-11T14:11:26.795Z</siri:RequestTimestamp>
MessageIdentifier 0:1 Identifier du message. Peut être sélectionné par l’utilisateur. Peut être utile dans un cas de support. S’il est disponible, il est renvoyé dans la réponse. 
<siri:MessageIdentifier>SER_1</siri:MessageIdentifier>
Location/PlaceRef 0:1 Le mieux est d’utiliser une StopPlaceRef. Le LocationName est ignoré.Attention: Didok et SLOID peuvent apparaître. Plus Informations. 
<PlaceRef>
    <siri:StopPointRef>8507000</siri:StopPointRef>
    <Name>
        <Text>Bern</Text>
    </Name>
</PlaceRef>
Location/DepArrTime 0:1 Heure à utiliser. De préférence, comme heure UTC,«Z» est l’heure UTC (donc indépendante du fuseau horaire). Pour Z, il est impératif d’indiquer également les secondes. Si le format n’est pas correct ou s’il n’y a pas de Z, le système essaie d’interpréter l’heure comme une heure locale. 
<DepArrTime>2025-02-11T14:11:21.539Z</DepArrTime>
Location/TimeAllowance 0:1 Temps supplémentaire nécessaire pour atteindre/sortir cet endroit (p. ex. D. max. 5 minutes à pied, mais 10 minutes à vélo). xs:Duration. 
<Location>
    <PlaceRef>
        <siri:StopPointRef>8507000</siri:StopPointRef>
        <Name>
            <Text>Bern</Text>
        </Name>
     </PlaceRef>
     <TimeAllowance>PT5M</TimeAllowance>
</Location>

 
Location/IndividualTransportOptions 0:* Options permettant d’atteindre ou de quitter une halte ou un lieu.Modes autorisés (actuels): walk, cycle Ultérieurement: taxi, self-drive-car, others-drive-car, motorcycle, truck. Les distances sont exprimées en mètres. La vitesse par rapport à la normale (=100%). AdditionalTime correspond au temps supplémentaire dans ce mode. 
<IndividualTransportOptions>
	<Mode>walk</Mode>
	<MaxDistance>5000</MaxDistance>
	<MaxDuration>PT5M</MaxDuration>
	<MinDistance>0</MinDistance>
	<MinDuration>PT0M</MinDuration>
	<Speed>100</Speed>
	<AdditionalTime>PT10M</AdditionalTime>
</IndividualTransportOptions>

 
Params 0:1 les paramètres 
<Params>
	<StopEventType>both</StopEventType>
	<IncludePreviousCalls>true</IncludePreviousCalls>
	<IncludeOnwardCalls>true</IncludeOnwardCalls>
	<IncludeOperatingDays>true</IncludeOperatingDays>
	<UseRealtimeData>full</UseRealtimeData>
</Params>

Paramètre du StopEventDataFilters

Élément Cardinalité Description Exemple
PtModeFilter 0:1 Filtrer par mode. L’élément Exclude indique si les modes doivent être inclus ou exclus.Il est possible d’ajouter 1:* Mode.

Cf. PtModeFilter sous Trip Service

 
<PtModeFilter>
	<Mode>
		<Exclude>true</Exclude>
		<PtMode>bus</PtMode>
		<siri:BusSubmode>localBusService</siri:BusSubmode>
	</Mode>
</PtModeFilter>
LineFilter 0:1 Filtrer par ligne. L’élément Exclude indique si les lignes doivent être incluses ou exclues.Il est possible d’ajouter 1:* Line.

 

 
<LineFilter>
	<Line>
		<siri:LineRef>sbb:91018:A</siri:LineRef>
		<siri:DirectionRef>H</siri:DirectionRef>
	</Line>
	<Exclude>true</Exclude>
</LineFilter>
OperatorFilter 0:1 Filtrer par exploitant. L’élément Exclude indique si les exploitants doivent être inclus ou exclus.Il est possible d’ajouter 1:* OperatorRef. 
<OperatorFilter>
	<Exclude>false</Exclude>
        <siri:OperatorRef>11</siri:OperatorRef>
</OperatorFilter>

 
NumberOfResults 0:1 Nombre de résultats 
<NumberOfResults>10</NumberOfResults>
StopEventType 0:1 Type des StopEvents:

  • arrivée
  • départ
  • les deux
 
<StopEventType>both</StopEventType>
IncludePreviousCalls 0:1 Les arrêts précédents doivent-ils également être indiqués pour les différentes courses? 
<IncludePreviousCalls>true</IncludePreviousCalls>
IncludeOnwardCalls 0:1 Faut-il indiquer les arrêts consécutifs pour les différentes courses? 
<IncludeOnwardCalls>true</IncludeOnwardCalls>
IncludeOperatingDays 0:1 Les informations relatives au jour d’exploitation doivent-elles également être ajoutées pour ce StopEvent? 
<IncludeOperatingDays>true</IncludeOperatingDays>
UseRealtimeData 0:1 Définit la manière dont le temps réel est pris en compte, full = tout; explanatory = également les Liaisons (variante la plus détaillée); none = seulement selon Horaire. 
<UseRealtimeData>explanatory</UseRealtimeData>

Réponse

Le résultat reçu est un OJPStopEventDelivery Message composé du TripResponseContext et des différents TripResults et se présente comme suit:

<OJP xmlns:siri="http://www.siri.org.uk/siri" xmlns="http://www.vdv.de/ojp" version="2.0">
    <OJPResponse>
        <siri:ServiceDelivery>
           <siri:ResponseTimestamp>2025-02-14T18:03:51.3185811+01:00</siri:ResponseTimestamp>
           <siri:ProducerRef>MENTZ</siri:ProducerRef>
           <OJPStopEventDelivery>
               <siri:ResponseTimestamp>2025-02-14T18:03:51.3185821+01:00</siri:ResponseTimestamp>
               <siri:RequestMessageRef>c5c59047-5c59-4ade-b635-9c942a0125ec</siri:RequestMessageRef>
               <siri:DefaultLanguage>de</siri:DefaultLanguage>
               <CalcTime>42</CalcTime>
               <StopEventResponseContext>
                   <Places>
                       <Place>
                           <StopPlace>
                               <StopPlaceRef>8591178</StopPlaceRef>
                               <StopPlaceName>
                                   <Text xml:lang="de">Zürich, Hardturm</Text>
                               </StopPlaceName>
                               <TopographicPlaceRef>23026261:27</TopographicPlaceRef>
                           </StopPlace>
                           <Name>
                               <Text xml:lang="de">Zürich, Hardturm</Text>
                           </Name>
                           <GeoPosition>
                               <siri:Longitude>8.50455</siri:Longitude>
                               <siri:Latitude>47.39415</siri:Latitude>
                           </GeoPosition>
                       </Place>
                       <Place>
                           <StopPoint>
                               <siri:StopPointRef>ch:1:sloid:91178::0</siri:StopPointRef>
                               <StopPointName>
                                   <Text xml:lang="de">Zürich, Hardturm</Text>
                               </StopPointName>
                               <ParentRef>8591178</ParentRef>
                               <TopographicPlaceRef>23026261:27</TopographicPlaceRef>
                           </StopPoint>
                           <Name>
                               <Text xml:lang="de">Zürich, Hardturm</Text>
                           </Name>
                           <GeoPosition>
                               <siri:Longitude>8.50455</siri:Longitude>
                               <siri:Latitude>47.39415</siri:Latitude>
                           </GeoPosition>
                       </Place>
                       <Place>
                           <TopographicPlace>
                               <TopographicPlaceCode>23026261:27</TopographicPlaceCode>
                               <TopographicPlaceName>
                                   <Text xml:lang="de">Zürich</Text>
                               </TopographicPlaceName>
                           </TopographicPlace>
                           <Name>
                               <Text xml:lang="de">Zürich</Text>
                           </Name>
                           <GeoPosition>
                               <siri:Longitude>8.50455</siri:Longitude>
                               <siri:Latitude>47.39415</siri:Latitude>
                           </GeoPosition>
                       </Place>
<!-- ... --> 
                       <Place>
                           <StopPoint>
                               <siri:StopPointRef>ch:1:sloid:91178::3</siri:StopPointRef>
                               <StopPointName>
                                   <Text xml:lang="de">Zürich, Hardturm</Text>
                               </StopPointName>
                               <ParentRef>8591178</ParentRef>
                               <TopographicPlaceRef>23026261:27</TopographicPlaceRef>
                           </StopPoint>
                           <Name>
                               <Text xml:lang="de">Zürich, Hardturm</Text>
                           </Name>
                           <GeoPosition>
                               <siri:Longitude>8.50429</siri:Longitude>
                               <siri:Latitude>47.39473</siri:Latitude>
                           </GeoPosition>
                       </Place>
                   </Places>
                   <Situations/>
               </StopEventResponseContext>
               <StopEventResult>
                   <StopEvent>
                       <PreviousCall>
                           <CallAtStop>
                               <siri:StopPointRef>ch:1:sloid:91178::0</siri:StopPointRef>
                               <StopPointName>
                                   <Text xml:lang="de">Zürich, Hardturm</Text>
                               </StopPointName>
                               <ServiceDeparture>
                                   <TimetabledTime>2025-02-17T08:33:00Z</TimetabledTime>
                               </ServiceDeparture>
                               <Order>1</Order>
                           </CallAtStop>
                       </PreviousCall>
<!-- ... --> 
                       <ThisCall>
                           <CallAtStop>
                               <siri:StopPointRef>ch:1:sloid:30813::0</siri:StopPointRef>
                               <StopPointName>
                                   <Text xml:lang="de">Zürich, Kreuzplatz</Text>
                               </StopPointName>
                               <ServiceDeparture>
                                   <TimetabledTime>2025-02-17T09:01:00Z</TimetabledTime>
                               </ServiceDeparture>
                               <Order>19</Order>
                           </CallAtStop>
                       </ThisCall>
                       <OnwardCall>
                           <CallAtStop>
                               <siri:StopPointRef>ch:1:sloid:91119::0</siri:StopPointRef>
                               <StopPointName>
                                   <Text xml:lang="de">Zürich, Englischviertelstrasse</Text>
                               </StopPointName>
                               <ServiceArrival>
                                   <TimetabledTime>2025-02-17T09:02:00Z</TimetabledTime>
                               </ServiceArrival>
                               <ServiceDeparture>
                                   <TimetabledTime>2025-02-17T09:03:00Z</TimetabledTime>
                               </ServiceDeparture>
                               <Order>20</Order>
                            </CallAtStop>
                        </OnwardCall>
<!-- ... --> 
                        <OnwardCall>
                            <CallAtStop>
                                <siri:StopPointRef>ch:1:sloid:91233::1</siri:StopPointRef>
                                <StopPointName>
                                    <Text xml:lang="de">Zürich, Klusplatz</Text>
                                </StopPointName>
                                <PlannedQuay>
                                    <Text xml:lang="de">B</Text>
                                </PlannedQuay>
                                <ServiceArrival>
                                    <TimetabledTime>2025-02-17T09:06:00Z</TimetabledTime>
                                </ServiceArrival>
                            </CallAtStop>
                        </OnwardCall>
                        <Service>
                            <Mode>
                                <PtMode>tram</PtMode>
                                <siri:TramSubmode>cityTram</siri:TramSubmode>
                                <Name>
                                    <Text xml:lang="de">Tram</Text>
                                </Name>
                                <ShortName>
                                    <Text xml:lang="de">T</Text>
                                </ShortName>
                            </Mode>
                            <ConventionalModeOfOperation>scheduled</ConventionalModeOfOperation>
                            <TrainNumber>4619</TrainNumber>
                            <siri:LineRef>ojp:91008:H</siri:LineRef>
                            <siri:OperatorRef>3849</siri:OperatorRef>
                            <PublicCode>Tram</PublicCode>
                            <PublishedServiceName>
                                <Text xml:lang="de">8</Text>
                            </PublishedServiceName>
                            <ProductCategory>
                                <Name>
                                    <Text xml:lang="de">Tram</Text>
                                </Name>
                                <ShortName>
                                    <Text xml:lang="de">T</Text>
                                </ShortName>
                                <ProductCategoryRef>2</ProductCategoryRef>
                            </ProductCategory>
                            <siri:DirectionRef>H</siri:DirectionRef>
                            <JourneyRef>ch:1:sjyid:100648:plan:3183eb5d-c26c-4ef4-972d-c92c4416363a</JourneyRef>
                            <OperatingDayRef>2025-02-17</OperatingDayRef>
                            <Cancelled>false</Cancelled>
                            <Unplanned>false</Unplanned>
                            <Deviation>false</Deviation>
                            <Attribute>
                                <UserText>
                                    <Text xml:lang="de">Niederflureinstieg</Text>
                                </UserText>
                                <Code>A__NF</Code>
                            </Attribute>
                            <OriginStopPointRef>ch:1:sloid:91178::0</OriginStopPointRef>
                            <DestinationStopPointRef>ch:1:sloid:91233::1</DestinationStopPointRef>
                            <OriginText>
                                <Text xml:lang="de">Zürich, Hardturm</Text>
                            </OriginText>
                            <DestinationText>
                                <Text xml:lang="de">Zürich, Klusplatz</Text>
                            </DestinationText>
                        </Service>
                        <OperatingDays>
                            <From>2025-02-02</From>
                            <To>2025-12-12</To>
                            <Pattern>01111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100011110011111000111000111110011111001111100111110011110001111100101110011111001111100111110010111001111000011110011111001111100111110011111001111100111110011111001111100111110011111</Pattern>
                        </OperatingDays>
                    </StopEvent>
                </StopEventResult>
<!-- ... --> 
            </OJPStopEventDelivery>
        </siri:ServiceDelivery>
    </OJPResponse>
</OJP>
+

La réponse se trouve dans une OJPStopEventDelivery dont la structure est la suivante:

Élément Cardinalité Description Exemple
siri:ResponseTimestamp 1:1 Timestamp de la réponse 
<siri:ResponseTimestamp>2020-04-03T14:47:59Z</siri:ResponseTimestamp>
siri:RequesteMessageRef 0:1 Le message demandé est référencé ici 
<siri:RequestMessageRef>756</siri:RequestMessageRef>
siri:DeliveryStatus 0:1 Le statut de la réponse, true, signifie que la demande a été traitée. 
<siri:Status>true</siri:Status>
CalcTime 0:1 Le temps de calcul en millisecondes 
<CalcTime>139</CalcTime>
StopEventResponseContext 0:1 Les informations de référence telles que les arrêts utilisés sont retournées ici.Cf. tableau séparé
StopEventResult 0:* Résultats effectifs. Voir exemple ci-dessus. 
<StopEventResult>
    <StopEvent>
        <PreviousCall>
            <CallAtStop>
                <siri:StopPointRef>ch:1:sloid:91178::0</siri:StopPointRef>
                <StopPointName>
                    <Text xml:lang="de">Zürich, Hardturm</Text>
                </StopPointName>
                <ServiceDeparture>
                    <TimetabledTime>2025-02-17T08:33:00Z</TimetabledTime>
                </ServiceDeparture>
                <Order>1</Order>
            </CallAtStop>
        </PreviousCall>
<!-- ... -->
        <ThisCall>
<!-- ... -->
        </ThisCall>
<!-- ... -->
        <OnwardCall>
<!-- ... -->
        </OnwardCall>
StopEventResult/Id 1:1 L’ID du résultat 
<ResultId>ID-5194D714-33A5-48B0-8895-BDCBAB540958</ResultId>
StopEventResult/StopEvent 1:1 Les différentes coursesCf. tableau séparé

RéactionContextStucture

Structure avec des contextes de réponse liés aux voyages qui contiennent des ensembles de lieux et de situations sous la forme des éléments suivants:

  • Opérateurs
  • Lieux
  • Situation
Élément Cardinalité Description Exemple
Operators 0:1 Structure des objets Operator. Seuls les objets Operator référencés dans la réponse doivent être affichés. n. a.
Places 0:1 Seuls les objets de placement référencés dans la réponse doivent être repris dans la structure. 
<Places>
    <Place>
        <StopPlace>
            <StopPlaceRef>8507000</StopPlaceRef>
            <StopPlaceName>
                <Text xml:lang="de">Bern</Text>
            </StopPlaceName>
            <TopographicPlaceRef>23006351:1</TopographicPlaceRef>
        </StopPlace>
        <Name>
            <Text xml:lang="de">Bern</Text>
        </Name>
        <GeoPosition>
            <siri:Longitude>7.43772</siri:Longitude>
            <siri:Latitude>46.94929</siri:Latitude>
        </GeoPosition>
    </Place>
<!-- ... -->
</Places>
Situations 0:1 Structure des objets de situation SIRI SX. Seules les situations auxquelles il est fait référence dans la réponse doivent être affichées. 
<Situations>
    <PtSituation>
        <siri:CreationTime>2024-10-24T08:46:00Z</siri:CreationTime>
        <siri:ParticipantRef>ski-ddip-out-sx_prod</siri:ParticipantRef>
        <siri:SituationNumber>ch:1:sstid:100001:57f8d406-b6f7-420d-9a03-46eb48a4de24-1</siri:SituationNumber>
        <siri:Version>7</siri:Version>
        <siri:Source>
            <siri:SourceType>directReport</siri:SourceType>
        </siri:Source>
        <siri:ValidityPeriod>
            <siri:StartTime>2025-02-02T21:30:00Z</siri:StartTime>
            <siri:EndTime>2025-12-08T04:55:00Z</siri:EndTime>
        </siri:ValidityPeriod>
        <siri:AlertCause>unknown</siri:AlertCause>
        <siri:Priority>3</siri:Priority>
        <siri:ScopeType>stopPoint</siri:ScopeType>
        <siri:Language>de</siri:Language>
        <siri:PublishingActions>
        <siri:PublishingAction>
            <siri:PublishAtScope>
                <siri:ScopeType>stopPoint</siri:ScopeType>
                <siri:Affects/>
            </siri:PublishAtScope>
            <siri:PassengerInformationAction>
                <siri:ActionRef/>
                <siri:RecordedAtTime>2024-10-24T08:46:00Z</siri:RecordedAtTime>
                <siri:Perspective>stopPoint</siri:Perspective>
                <siri:TextualContent>
                    <siri:SummaryContent>
                        <siri:SummaryText xml:lang="de">Der Bahnverkehr zwischen Bern und Olten ist eingeschränkt.</siri:SummaryText>
                    </siri:SummaryContent>
                    <siri:ReasonContent>
                        <siri:ReasonText xml:lang="de">Der Grund dafür sind Bauarbeiten.</siri:ReasonText>
                    </siri:ReasonContent>
                    <siri:DurationContent>
                        <siri:DurationText xml:lang="de">Die Einschränkung dauert von 02.02.2025, 22:30 bis 03.02.2025, 05:55. Die Einschränkung dauert von 04.05.2025, 22:30 bis 05.05.2025, 05:55. Die Einschränkung dauert von 15.06.2025 bis 20.06.2025, jeweils von 22:30 bis 05:55. Die Einschränkung dauert von 22.06.2025 bis 27.06.2025, jeweils von 22:30 bis 05:55. Die Einschränkung dauert von 27.07.2025, 22:30 bis 28.07.2025, 05:55. Die Einschränkung dauert von 21.09.2025 bis 26.09.2025, jeweils von 22:30 bis 05:55. Die Einschränkung dauert von 28.09.2025 bis 03.10.2025, jeweils von 22:30 bis 05:55. Die Einschränkung dauert von 07.12.2025, 22:30 bis 08.12.2025, 05:55.</siri:DurationText>
                    </siri:DurationContent>
                </siri:TextualContent>
            </siri:PassengerInformationAction>
        </siri:PublishingAction>
    </siri:PublishingActions>
</PtSituation>

Structure des StopEvent

Le StopEvent se compose des éléments suivants:

  • Previous call(s): Si les paramètres ont été sélectionnés
  • ThisCall: L’arrêt actuellement sélectionné
  • Onward Call(s): Futurs arrêts pendant le trajet
  • Service: Informations sur le trajet
Élément Cardinalité Description Exemple
PreviousCall 0:* Les PreviousCalls sont les arrêts précédant celui qui a été demandé. Toutes les informations se trouvent dans un CallAtStop. Voir le chapitre correspondant 
<PreviousCall>
    <CallAtStop>
        <siri:StopPointRef>8591142</siri:StopPointRef>
        <StopPointName>
            <Text>Zürich, Friedhof Enzenbühl</Text>
        </StopPointName>
        <ServiceArrival>
            <TimetabledTime>2020-04-03T15:32:00Z</TimetabledTime>
        </ServiceArrival>
        <ServiceDeparture>
            <TimetabledTime>2020-04-03T15:32:00Z</TimetabledTime>
        </ServiceDeparture>
        <Order>2</Order>
    </CallAtStop>
</PreviousCall>
ThisCall 1:1 Il s’agit de l’arrêt dont traite la requête.Toutes les informations figurent dans un CallAtStop. Voir le chapitre correspondant 
<ThisCall>
    <CallAtStop>
        <siri:StopPointRef>8530813</siri:StopPointRef>
        <StopPointName>
            <Text>Zürich Kreuzplatz</Text>
        </StopPointName>
        <ServiceArrival>
            <TimetabledTime>2020-04-03T15:40:00Z</TimetabledTime>
        </ServiceArrival>
        <ServiceDeparture>
            <TimetabledTime>2020-04-03T15:40:00Z</TimetabledTime>
        </ServiceDeparture>
        <Order>9</Order>
    </CallAtStop>
</ThisCall>
OnwardCall 0:* Les OnwardCalls sont les arrêts situés après l’arrêt actuel demandé dans la Request.Toutes les informations figurent dans un CallAtStop. Voir la section correspondante 
<OnwardCall>
    <CallAtStop>
        <siri:StopPointRef>8591049</siri:StopPointRef>
        <StopPointName>
            <Text>Zürich, Auzelg</Text>
        </StopPointName>
        <ServiceArrival>
            <TimetabledTime>2020-04-03T16:16:00Z</TimetabledTime>
        </ServiceArrival>
        <Order>34</Order>
    </CallAtStop>
</OnwardCall>
Service 1:1 Le service est l’information à proprement parler sur l’ensemble du trajet. 
<Service>
    <OperatingDayRef>2020-04-03</OperatingDayRef>
    <JourneyRef>ch:1:sjyid:100001:627-001</JourneyRef>
    <siri:LineRef>sbb:91011:A</siri:LineRef>
    <siri:DirectionRef>R</siri:DirectionRef>
    <Mode>
        <PtMode>tram</PtMode>
        <siri:TramSubmode>cityTram</siri:TramSubmode>
        <Name>
            <Text xml:lang="de">Tram</Text>
        </Name>
    </Mode>
    <PublishedLineName>
        <Text>11</Text>
    </PublishedLineName>
    <OperatorRef>sbb:3849</OperatorRef>
    <OriginStopPointRef>8591315</OriginStopPointRef>
    <OriginText>
        <Text xml:lang="de">Zürich, Rehalp</Text>
    </OriginText>
    <DestinationStopPointRef>8591049</DestinationStopPointRef>
    <DestinationText>
        <Text xml:lang="de">Zürich, Auzelg</Text>
    </DestinationText>
</Service>
OperatingDays 0:1 La validité de la course indiquée et le modèle de jours de recherche de cette relation 
<OperatingDays>
    <From>2025-02-02</From>
    <To>2025-12-12</To>
    <Pattern>01111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100011110011111000111000111110011111001111100111110011110001111100101110011111001111100111110010111001111000011110011111001111100111110011111001111100111110011111001111100111110011111</Pattern>
</OperatingDays>
OperatingDays/From 1:1 Description 
<From>2025-02-02</From>
OperatingDays/To 1:1 Description 
<To>2025-12-12</To>
OperatingDays/Pattern 1:1 De plus amples informations sur la manière d’interpréter le modèle sont disponibles ici: Calendrier des lignes 
<Pattern>01111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100011110011111000111000111110011111001111100111110011110001111100101110011111001111100111110010111001111000011110011111001111100111110011111001111100111110011111001111100111110011111</Pattern>

CallAtStop.Structure

 

Élément Cardinalité Description Exemple
siri:StopPointRef 1:1 Numéro d’arrêt. Pour l’instant, il s’agit encore d’un numéro DiDok. Il peut également s’agir d’un NeTEx-Id ou d’un SLOID.Attention: Didok et sloid peuvent tous deux apparaître. En savoir plus Informations. 
<siri:StopPointRef>8530813</siri:StopPointRef>
StopPointName 1:1 Nom de la halte 
<StopPointName>
    <Text>Zürich Kreuzplatz</Text>
</StopPointName>
PlannedQuay 0:1 Quai prévu 
<PlannedQuay>
    <Text xml:lang="de">1</Text>
</PlannedQuay>
EstimatedQuay 0:1 Quai actuel, le cas échéant 
<EstimatedQuay>
    <Text xml:lang="de">1</Text>
</EstimatedQuay
ServiceArrival 0:1 Le premier arrêt n’a pas d’Arrival. 
<ServiceArrival>
    <TimetabledTime>2020-04-03T15:40:00Z</TimetabledTime>
    <EstimatedTime>2020-04-03T15:40:00Z</EstimatedTime>
</ServiceArrival>
ServiceDeparture 0:1 Le dernier arrêt n’a pas de «Departure». 
<ServiceDeparture>
    <TimetabledTime>2020-04-03T15:40:00Z</TimetabledTime>
    <EstimatedTime>2020-04-03T15:40:00Z</EstimatedTime>
</ServiceDeparture>
Order 1:1 Ordre des arrêts 
<Order>9</Order>

 
RequestStop 0:1 Arrêt sur demande. Booléen.Non implémenté, prévu pour une version future. n. a.
UnplannedStop 0:1 Arrêt non prévu selon la planification. Booléen.Non implémenté, prévu dans une version future. n. a.
NotServicedStop 0:1 Contrairement à ce qui a été prévu, aucun arrêt n’est prévu (suppressions). 
<NotServicedStop>true</NotServicedStop>
NoBoardingAtStop 0:1 L’embarquement n’est pas possible à cet arrêt. 
<NoBoardingAtStop>true</NoBoardingAtStop>
NoAlightingAtStop 0:1 Il n’est pas possible de descendre à cet arrêt. 
<NoAlightingAtStop>true</NoAlightingAtStop>

Les ContinousServiceStructure

Élément Cardinalité Description Exemple
OperatingDayRef 1:1 Jour d’exploitation concerné 
<OperatingDayRef>2020-04-03</OperatingDayRef>
JourneyRef 1:1 ID de la course. 
<JourneyRef>ch:1:sjyid:100001:627-001</JourneyRef>
siri:LineRef 1:1 ID de la ligne: 
<siri:LineRef>ojp:91021:H</siri:LineRef>
siri:DirectionRef 0:1 ID de la direction. 
<siri:DirectionRef>R</siri:DirectionRef>
Mode 1:1 Le mode de transport.La liste des modes est disponible sur LocationInformationRequest 
<Mode>
    <PtMode>tram</PtMode>
    <siri:TramSubmode>cityTram</siri:TramSubmode>
    <Name>
        <Text xml:lang="de">Tram</Text>
    </Name>
</Mode>
PublishedLineName 1:1 Nom publié de la liste 
<PublishedLineName>
    <Text>11</Text>
</PublishedLineNam
OperatorRef 0:1 La référence à l’exploitant.Attention: va encore changer. 
<siri:OperatorRef>11</siri:OperatorRef>
Attribute 0:* Les attributs sont des propriétés, généralement dans les courses. P. ex. bus à plancher surbaissé, bar, réservation nécessaire.Mandataory est true si l’attribut doit impérativement être affiché à l’utilisateur. 
<Attribute>
    <Text>
        <Text xml:lang="de">Linie 31: Niederflureinstieg</Text>
    <Text>
    <Code>30</Code>
    <Mandatory>false</Mandatory>
</Attribute>
OrginStopPointRef 0:1 Numéro DiDok du point de départ.Attention: L’ID va encore changer. 
<OriginStopPointRef>8591315</OriginStopPointRef>
OriginText 0:1 Nom de la halte de départ. 
<OriginText>
    <Text xml:lang="de">Zürich, Rehalp</Text>
</OriginText>
DestinationStopPointRef 0:1 Numéro DiDok de la halte de destination.Attention: L’ID va encore changer. 
<DestinationStopPointRef>8591049</DestinationStopPointRef>
DestinationText 0:1 Nom de la halte de destination. 
<DestinationText>
    <Text xml:lang="de">Zürich, Auzelg</Text>
</DestinationText>
Unplanned 0:1 Indique s’il s’agit d’une course supplémentaire qui ne figure pas dans l’horaire régulier. Booléen. 
<Unplanned>true</Unplanned>
Cancelled 0:1 Suppression d’un convoi. Booléen. 
<Cancelled>true</Cancelled>
Deviation 0:1 Indique si la course n’est pas effectuée conformément à l’horaire.Planifié dans une version future n. a.
BookingArrangements 0:1 Cet attribut n’est pas pris en charge. n. a.
ParticipantRef 1:1 Permet de communiquer des dérangements ou d’autres situations exceptionnelles.Prévu dans une version ultérieure n. a.
siri:SituationNumber 1:1 Permet de communiquer des dérangements ou d’autres situations exceptionnelles.Prévu dans une version ultérieure n. a.

Informations complémentaires

Temps réel

Concepts importants:

  • Jours d’exploitation: Jours pendant lesquels un train circule. Peut finalement durer plus de 24 h. Notation JJ-MM-AAAA comme OperatingDays, p. ex. en Service/Mode.
  • Heure UTC: Correspond à l’heure UTC et est indiqué ainsi 2025-02-02T11:24:00Z, sinon aussi ISO 8601 Indication de l’heure avec décalage horaire 2025-02-02T09:24:00+0200. L’heure d’été ne change pas à l’heure UTC. L’émission d’une fraction de seconde est courante, en particulier pour l’horodatage.
  • Hystérésis: Dans le domaine de l’information à la clientèle, seules les modifications dépassant une certaine ampleur sont transmises par hystérésis. Cela signifie que les retards ne sont pas sondés, mais transmis à partir d’une modification précise. Les écarts sont communiqués en 1/10 minute.

Les données en temps réel ou en temps réel sont émises uniquement pour le jour d’exploitation en cours. L’écart est indiqué par rapport à la StopPointRef, qui correspond également à l’élément présent dans l’horaire, tandis qu’une StopPlaceRef référence un point dans une gare. En Suisse, les identifiants utilisés sont les mêmes pour StopPointRef et StopPlaceRef.

Voici un exemple avec l’utilisation en temps réel d’un «CallAtStop». Le même concept peut être appliqué à tous les endroits de l’OJP où des écarts par rapport à l’horaire sont affichés:

<CallAtStop>
    <siri:StopPointRef>ch:1:sloid:91128::0</siri:StopPointRef>
    <StopPointName>
        <Text xml:lang="de">Zürich, Fernsehstudio</Text>
    </StopPointName>
    <ServiceArrival>
        <TimetabledTime>2025-02-17T13:06:18Z</TimetabledTime>
        <EstimatedTime>2025-02-17T13:05:54Z</EstimatedTime>
    </ServiceArrival>
    <ServiceDeparture>
        <TimetabledTime>2025-02-17T13:06:30Z</TimetabledTime>
        <EstimatedTime>2025-02-17T13:06:00Z</EstimatedTime>
    </ServiceDeparture>
    <Order>2</Order>
</CallAtStop>

L’écart entre «TimetabledTime» et «EstimatedTime» correspond à l’écart entre l’horaire en temps réel et l’horaire, qui est également indiqué lorsqu’il s’agit p. ex. d’une arrivée anticipée. Il est donc judicieux d’implémenter une logique d’affichage des écarts afin que seuls les écarts déterminants pour le client, comme un retard, soient affichés.

Trains-autos Tunnel

<OJP xmlns="http://www.vdv.de/ojp" xmlns:siri="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xsi:schemaLocation="http://www.vdv.de/ojp" version="2.0">
    <OJPRequest>
        <siri:ServiceRequest>
            <siri:ServiceRequestContext>
                <siri:Language>de</siri:Language>
            </siri:ServiceRequestContext>
            <siri:RequestTimestamp>2025-02-17T08:03:02.813Z</siri:RequestTimestamp>
            <siri:RequestorRef>SKIPlus_ATZ</siri:RequestorRef>
            <OJPStopEventRequest>
                <siri:RequestTimestamp>2025-02-17T08:03:02.813Z</siri:RequestTimestamp>
                <Location>
                    <PlaceRef>
                        <siri:StopPointRef>8511171</siri:StopPointRef>
                        <Name>
                            <Text>Kandersteg Autoverlad</Text>
                        </Name>
                    </PlaceRef>
                </Location>
                <Params>
                    <IncludeAllRestrictedLines>true</IncludeAllRestrictedLines>
                    <NumberOfResults>10</NumberOfResults>
                    <StopEventType>departure</StopEventType>
                    <IncludePreviousCalls>true</IncludePreviousCalls>
                    <IncludeOnwardCalls>true</IncludeOnwardCalls>
                    <UseRealtimeData>full</UseRealtimeData>
                </Params>
            </OJPStopEventRequest>
        </siri:ServiceRequest>
    </OJPRequest>
</OJP>

Profils élargis (chez BLS) sont reconnaissables à l’attribut GF:

<Attribute>
    <Text>
        <Text xml:lang="de">Grossraumprofil</Text>
    </Text>
    <Code>A__GF</Code>
</Attribute>