Table des matières

Rechercher sur le site

OJPStopEventRequest 2.0

#AutoTranslate

Description rapide

Le service StopEvent sert à élaborer un indicateur des départs ou des arrivées. Tous les trajets au départ d’un arrêt et les bordures d’arrêt attribuées sont pris en compte. Toutefois, contrairement au routeur, aucun arrêt voisin n’est émis si aucun résultat n’est disponible pour l’.

Description technique

Explorateur de l’API

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

Demande

La demande est transmise 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 OJPStopEventRequestStructure:

Élément Cardinalité Description Exemple
RequestTimestamp 1:1 Timestamp de la requête. De préférence en heure UTC. 
<siri:RequestTimestamp>2025-02-11T14:11:26.795Z</siri:RequestTimestamp>
MessageIdentifier 0:1 Identifier du message. Peut être choisi par l’utilisateur. Peut être utile en cas de support. Celui-ci, s’il est disponible, sera indiqué dans la réponse. 
<siri:MessageIdentifier>SER_1</siri:MessageIdentifier>
Location/PlaceRef 0:1 Le mieux est d’utiliser une StopPlaceRef. Location Name est ignoré.Attention: Didok et SLOID peuvent apparaître. En savoir plus Informations. 
<PlaceRef>
    <siri:StopPointRef>8507000</siri:StopPointRef>
    <Name>
        <Text>Bern</Text>
    </Name>
</PlaceRef>
Location/DepArrTime 0:1 L’heure à utiliser. Le mieux, comme heure UTC, est l’heure UTC (c’est-à-dire indépendante de tout fuseau horaire). Pour Z, il faut impérativement indiquer les secondes. Si le format n’est pas correct ou en l’absence 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 de cet endroit (p. ex. O. 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>

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

Paramètres du StopEventDataFilters

Élément Cardinalité Description Exemple
ModeFilter 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. Seul le «PtMode» est pris en charge, pas le «PersonalMode». <ModeFilter>
    <Exclude>true</Exclude>
    <PtMode>bus</PtMode>
</ModeFilter>
LineFilter 0:1 Filtrer par ligne. L’élément Exclude indique si les lignes doivent être incluses ou exclues.Il est possible d’ajouter une ligne 1:*.

 

 
<LineFilter>
	<Line>
		<siri:LineRef>sbb:91018:A</siri:LineRef>
		<siri:DirectionRef>H</siri:DirectionRef>
	</Line>
	<Exclude>true</Exclude>
</LineFilter>
OperatorFilter 0:1 Filtre 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 Types des StopEvents:

  • arrivée

  • départ

  • les deux


 
<StopEventType>both</StopEventType>
IncludePreviousCalls 0:1 Faut-il indiquer pour chaque trajet également la halte précédente? 
<IncludePreviousCalls>true</IncludePreviousCalls>
IncludeOnwardCalls 0:1 Faut-il indiquer pour chaque trajet également la halte suivante? 
<IncludeOnwardCalls>true</IncludeOnwardCalls>
IncludeOperatingDays 0:1 Faut-il également ajouter des informations sur le jour d’exploitation pour ce StopEvent? 
<IncludeOperatingDays>true</IncludeOperatingDays>
UseRealtimeData 0:1 Détermine comment le Realtime est pris en compte, full = tout; explanatory = y compris les événements tardifs et supprimés Connexions (variante la plus détaillée); none = uniquement selon Horaire. 
<UseRealtimeData>explanatory</UseRealtimeData>

Réponse

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

<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 qui est structurée comme suit:

É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 qui a été 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 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 renvoyées ici.Voir tableau séparé
StopEventResult 0:* Les 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 ID du résultat 
<ResultId>ID-5194D714-33A5-48B0-8895-BDCBAB540958</ResultId>
StopEventResult/StopEvent 1:1 Courses individuellesCf. tableau séparé

Structurecontexteréponse

Structure avec des contextes de réponse liés aux voyages qui contiennent des recueils de lieux et de situations comme éléments suivants:

  • Opérateur
  • Lieux
  • Contexte
Élément Cardinalité Description Exemple
Operators 0:1 Structure pour les objets Operator. Seuls les objets Operator référencés dans la réponse doivent être affichés. n.c.
Places 0:1 Seuls les objets de placement référencés dans la réponse doivent être intégrés 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 pour les 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>

StopÉvénementStructure

Le StopEvent se compose des éléments suivants:

  • PreviousCall(s): Si les paramètres ont été sélectionnés
  • ThisCall: L’arrêt actuellement sélectionné
  • OnwardCall(s): Futurs arrêts sur le trajet
  • Service: Informations sur le trajet
Élément Cardinalité Description Exemple
PreviousCall 0:* Les PreviousCall sont les arrêts situés avant celui qui a été demandé.Toutes les informations sont dans un CallAtStop. Voir la section correspondante 
<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 il est question dans la requête.Toutes les informations se trouvent dans un CallAtStop. Voir la section correspondante 
<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 haltes qui se trouvent après la halte en cours demandée dans la requête.Toutes les informations se trouvent 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 correspond aux informations relatives à 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 les jours où cette relation a été recherchée 
<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 Pour plus d’informations sur la manière d’interpréter le motif, cliquez ici: Calendrier des lignes 
<Pattern>01111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100011110011111000111000111110011111001111100111110011110001111100101110011111001111100111110010111001111000011110011111001111100111110011111001111100111110011111001111100111110011111</Pattern>

CallAtStopStructure

 

Élément Cardinalité Description Exemple
siri:StopPointRef 1:1 Numéro de l’arrêt. Pour l’instant, il s’agit encore d’un numéro DiDok. Il peut aussi s’agir d’un NeTEx-Id ou d’un SLOID.Attention: Didok et sloid peuvent 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 Succession 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.c.
UnplannedStop 0:1 Arrêt qui n’était pas prévu selon la planification. Booléen.Non implémenté, planifié pour une version future. n.c.
NotServicedStop 0:1 Il n’y a pas d’arrêt contrairement à ce qui est prévu (suppression). 
<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 du trajet. 
<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 Mode de circulationLa liste des modes se trouve sous 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 Référence de l’exploitant.Attention: variable. 
<siri:OperatorRef>11</siri:OperatorRef>
Attribute 0:* Les attributs se rapportent généralement aux courses. P. ex. bus à plancher surbaissé, bar, réservation requise.Mandataory est «true» lorsque 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 doit encore évoluer. 
<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’un trajet supplémentaire qui ne figure pas dans l’horaire régulier. Booléen. 
<Unplanned>true</Unplanned>
Cancelled 0:1 Suppression d’un trajet. Booléen. 
<Cancelled>true</Cancelled>
Deviation 0:1 Indique si le trajet ne sera pas effectué selon l’horaire.Prévu pour une version future n.c.
BookingArrangements 0:1 Cet attribut n’est pas pris en charge. n.c.
ParticipantRef 1:1 Sert à communiquer des perturbations ou d’autres situations exceptionnelles.Prévu pour une version future n.c.
siri:SituationNumber 1:1 Sert à communiquer des perturbations ou d’autres situations exceptionnelles.Prévu pour une version future n.c.

Informations complémentaires

Temps réel

Concepts importants:

  • Jours d’exploitation: Jours pendant lesquels un train circule. Cela peut durer au final plus de 24 h. Notation toutefois JJ-MM-AAAA comme OperatingDays p. ex. au niveau Service/Mode.
  • Heure UTC.: Correspond à l’heure UTC et est indiquée ainsi 2025-02-02T11:24:00Z, à défaut également ISO 8601 Indication de l’heure avec décalage de fuseau horaire 2025-02-02T09:24:00+0200. Il n’y a pas de changement à l’heure d’été à l’heure UTC. L’émission de fractions de seconde est courante, notamment pour l’horodatage.
  • Hystérèse: dans le domaine de l’information à la clientèle, seules les modifications qui dépassent un certain volume sont transmises. Cela se fait par hystérésis. En d’autres termes, les retards ne font pas l’objet d’un vote, mais ne sont communiqués qu’à partir d’une certaine modification. Les écarts sont communiqués dans un délai de 1/10 min.

Le temps réel ou Realtime n’est émis que pour le jour d’exploitation en cours. L’écart est indiqué à chaque fois par rapport à la StopPointRef, qui correspond également à l’élément disponible dans l’horaire, tandis qu’une StopPlaceRef référence un point dans une gare. En Suisse, des ID identiques sont utilisés pour la StopPointRef et la StopPlaceRef.

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

<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 le «TimetabledTime» et l’«EstimatedTime» correspond à l’écart de l’heure réelle par rapport à l’horaire, qui est également affiché p. ex. s’il s’agit d’une arrivée plus tôt. Il est donc judicieux d’implémenter une logique d’affichage des écarts, de sorte que seuls les écarts pertinents pour le client, comme un retard, soient indiqués.

Trains-autos tunnels

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

Profilés de grande capacité (au BLS) reconnaissables à l’attribut du poste de direction:

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