Indice della materia

Ricerca nella pagina

OJPStopEventRequest 2.0

#AutoTranslate

Descrizione breve

Il servizio StopEvent viene utilizzato per realizzare un monitor partenze o arrivi. Sono incluse tutte le corse a partire da una fermata e dai bordi fermata assegnati. A differenza del router, tuttavia, se per la fermata richiesta non sono disponibili risultati non vengono fornite fermate vicine.

Descrizione tecnica

API Explorer

Puoi provare le tue richieste – link diretto all’API Explorer.

Richiesta

La richiesta viene effettuata con un OJPStopEventRequest, che contiene diversi parametri per la richiesta; di seguito è riportato l’esempio di Berna:

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

Di seguito vengono indicati i parametri della OJPStopEventRequestStructure:

Elemento Cardinalità Descrizione Esempio
RequestTimestamp 1:1 Timestamp della richiesta. Preferito in Zulu Time. 
<siri:RequestTimestamp>2025-02-11T14:11:26.795Z</siri:RequestTimestamp>
MessageIdentifier 0:1 L’identificativo del messaggio. Può essere selezionato dall’utente. Può essere utile in caso di assistenza. Se disponibile, viene restituito nella risposta. 
<siri:MessageIdentifier>SER_1</siri:MessageIdentifier>
Location/PlaceRef 0:1 Il modo migliore per utilizzare uno StopPlaceRef. Il nome della location viene ignorato.Attenzione: Possono essere utilizzati sia DiDok che SLOID. Di più Informazioni. 
<PlaceRef>
    <siri:StopPointRef>8507000</siri:StopPointRef>
    <Name>
        <Text>Bern</Text>
    </Name>
</PlaceRef>
Location/DepArrTime 0:1 Il tempo da utilizzare. Meglio come tempo zulu«Z» è l’orario zulu (quindi indipendente dal fuso orario). Per la cifra Z è indispensabile indicare anche i secondi. Se il formato non è corretto o se la cifra Z non è disponibile, il sistema cerca di interpretare l’orario come orario locale. 
<DepArrTime>2025-02-11T14:11:21.539Z</DepArrTime>
Location/TimeAllowance 0:1 Tempo supplementare necessario per raggiungere e uscire dal luogo in questione (ad es. E. massimo 5 minuti a piedi, ma 10 minuti in bicicletta). xs: Durata. 
<Location>
    <PlaceRef>
        <siri:StopPointRef>8507000</siri:StopPointRef>
        <Name>
            <Text>Bern</Text>
        </Name>
     </PlaceRef>
     <TimeAllowance>PT5M</TimeAllowance>
</Location>

 
Location/IndividualTransportOptions 0:* Opzioni per raggiungere o lasciare una fermata o un luogo.Modalità consentite (attuali): walk, cycle Successivamente: taxi, self-drive-car, others-drive-car, motorcycle, truck. Le distanze sono espresse in metri. La velocità è relativamente normale (=100%). AdditionalTime è tempo aggiuntivo in questa modalità. 
<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 i parametri 
<Params>
	<StopEventType>both</StopEventType>
	<IncludePreviousCalls>true</IncludePreviousCalls>
	<IncludeOnwardCalls>true</IncludeOnwardCalls>
	<IncludeOperatingDays>true</IncludeOperatingDays>
	<UseRealtimeData>full</UseRealtimeData>
</Params>

Parametri del StopEventDataFilters (Filtro eventi stop)

Elemento Cardinalità Descrizione Esempio
ModeFilter 0:1 Filtra per modalità. L’elemento Exclude indica se includere o escludere le modalità. È possibile aggiungere modalità 1:*. È supportato solo «PtMode», non «PersonalMode». <ModeFilter>
    <Exclude>true</Exclude>
    <PtMode>bus</PtMode>
</ModeFilter>
LineFilter 0:1 Filtro per linea. L’elemento Exclude indica se le linee devono essere incluse o escluse.È possibile aggiungere linea 1:*.

 

 
<LineFilter>
	<Line>
		<siri:LineRef>sbb:91018:A</siri:LineRef>
		<siri:DirectionRef>H</siri:DirectionRef>
	</Line>
	<Exclude>true</Exclude>
</LineFilter>
OperatorFilter 0:1 Filtro per operatore. L’elemento Exclude indica se gli operatori devono essere inclusi o esclusi.Possono essere aggiunti 1:* Riferimento operatore. 
<OperatorFilter>
	<Exclude>false</Exclude>
        <siri:OperatorRef>11</siri:OperatorRef>
</OperatorFilter>

 
NumberOfResults 0:1 Numero di risultati 
<NumberOfResults>10</NumberOfResults>
StopEventType 0:1 Tipo di StopEvent:

  • arrivo

  • partenza

  • entrambe


 
<StopEventType>both</StopEventType>
IncludePreviousCalls 0:1 Per le singole corse è necessario indicare anche le fermate precedenti? 
<IncludePreviousCalls>true</IncludePreviousCalls>
IncludeOnwardCalls 0:1 Per le singole corse occorre indicare anche le fermate di congiunzione? 
<IncludeOnwardCalls>true</IncludeOnwardCalls>
IncludeOperatingDays 0:1 È necessario inserire anche informazioni sui giorni di circolazione per questo StopEvent? 
<IncludeOperatingDays>true</IncludeOperatingDays>
UseRealtimeData 0:1 Determina come viene preso in considerazione il tempo reale, full = tutto; explanatory = anche treni in ritardo e cancellati Collegamenti (variante più dettagliata); none = solo secondo Orario. 
<UseRealtimeData>explanatory</UseRealtimeData>

Risposta

Il risultato ricevuto è una OJPStopEventDelivery Messaggio composto dal TripResponseContext e dai vari TripResults e si presenta come indicato:

<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 risposta è in una OJPStopEventDelivery strutturato come segue:

Elemento Cardinalità Descrizione Esempio
siri:ResponseTimestamp 1:1 Il timestamp della risposta 
<siri:ResponseTimestamp>2020-04-03T14:47:59Z</siri:ResponseTimestamp>
siri:RequesteMessageRef 0:1 Qui viene fatto riferimento al messaggio richiesto 
<siri:RequestMessageRef>756</siri:RequestMessageRef>
siri:DeliveryStatus 0:1 Lo stato della risposta, true significa che la richiesta è stata elaborata. 
<siri:Status>true</siri:Status>
CalcTime 0:1 Il tempo di calcolo in millisecondi 
<CalcTime>139</CalcTime>
StopEventResponseContext 0:1 Qui vengono restituite informazioni di riferimento come le fermate utilizzate.V. tabella separata
StopEventResult 0:* I risultati effettivi. Vedi esempio sopra. 
<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 del risultato 
<ResultId>ID-5194D714-33A5-48B0-8895-BDCBAB540958</ResultId>
StopEventResult/StopEvent 1:1 Le singole corseVedi tabella separata

ReponseContextStucture

Struttura con contesti di risposta relativi ai viaggi che contengono raccolte di luoghi e situazioni come i seguenti elementi:

  • Operatori
  • Posti
  • Situazione
Elemento Cardinalità Descrizione Esempio
Operators 0:1 Struttura per oggetti operatore. Dovrebbero essere generati solo gli oggetti operatore a cui si fa riferimento nella risposta. n.d.
Places 0:1 Nella struttura dovrebbero essere inclusi solo gli oggetti di posizionamento a cui si fa riferimento nella risposta. 
<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 Struttura per oggetti di situazione SIRI SX. Devono essere riportate solo le situazioni a cui si fa riferimento nella risposta. 
<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>

StrutturaStopEvent

Lo StopEvent è costituito da:

  • PreviousCall(s): Se è stato selezionato un parametro
  • ThisCall: La fermata attualmente selezionata
  • OnwardCall(s): Fermate future nella corsa
  • Servizio: Informazioni sulla corsa
Elemento Cardinalità Descrizione Esempio
PreviousCall 0:* Le PreviousCall sono le fermate che precedono chi è stato richiesto.Tutte le informazioni sono disponibili in un CallAtStop. Vedi la sezione corrispondente 
<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 Questa è la fermata oggetto della richiesta.Tutte le informazioni sono in un CallAtStop. Vedere il relativo paragrafo 
<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:* L’OnwardCall corrisponde alle fermate successive alla fermata attuale richiesta nella Request.Tutte le informazioni sono in un CallAtStop. Vedere il relativo paragrafo 
<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 Il servizio è l’informazione vera e propria sull’intero viaggio. 
<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à della corsa indicata e i giorni in cui questo collegamento è stato effettuato la ricerca 
<OperatingDays>
    <From>2025-02-02</From>
    <To>2025-12-12</To>
    <Pattern>01111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100011110011111000111000111110011111001111100111110011110001111100101110011111001111100111110010111001111000011110011111001111100111110011111001111100111110011111001111100111110011111</Pattern>
</OperatingDays>
OperatingDays/From 1:1 Descrizione 
<From>2025-02-02</From>
OperatingDays/To 1:1 Descrizione 
<To>2025-12-12</To>
OperatingDays/Pattern 1:1 Ulteriori informazioni sull’interpretazione del pattern sono disponibili qui: Calendario linee 
<Pattern>01111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100111110011111001111100011110011111000111000111110011111001111100111110011110001111100101110011111001111100111110010111001111000011110011111001111100111110011111001111100111110011111001111100111110011111</Pattern>

CallAtStopStruttura

 

Elemento Cardinalità Descrizione Esempio
siri:StopPointRef 1:1 Il numero di fermata. Al momento esiste ancora un numero DiDok. Può anche trattarsi di un ID NeTEx o di uno SLOID.Attenzione: Possono essere presenti sia DiDok che Sloid. Maggiori informazioni Informazioni. 
<siri:StopPointRef>8530813</siri:StopPointRef>
StopPointName 1:1 Nome della fermata 
<StopPointName>
    <Text>Zürich Kreuzplatz</Text>
</StopPointName>
PlannedQuay 0:1 Il marciapiede previsto 
<PlannedQuay>
    <Text xml:lang="de">1</Text>
</PlannedQuay>
EstimatedQuay 0:1 Il sentiero attuale, se disponibile 
<EstimatedQuay>
    <Text xml:lang="de">1</Text>
</EstimatedQuay
ServiceArrival 0:1 La prima fermata non ha nessun Arrival. 
<ServiceArrival>
    <TimetabledTime>2020-04-03T15:40:00Z</TimetabledTime>
    <EstimatedTime>2020-04-03T15:40:00Z</EstimatedTime>
</ServiceArrival>
ServiceDeparture 0:1 L’ultima fermata non ha Departure. 
<ServiceDeparture>
    <TimetabledTime>2020-04-03T15:40:00Z</TimetabledTime>
    <EstimatedTime>2020-04-03T15:40:00Z</EstimatedTime>
</ServiceDeparture>
Order 1:1 La sequenza delle fermate 
<Order>9</Order>

 
RequestStop 0:1 Fermata su richiesta. Booleana.Non implementato, pianificato per una versione futura. n.d.
UnplannedStop 0:1 Fermata che secondo la pianificazione non era prevista. Booleana.Non implementata, pianificata per una versione futura. n.d.
NotServicedStop 0:1 Contrariamente a quanto previsto dalla pianificazione, non sono previste fermate (soppressioni). 
<NotServicedStop>true</NotServicedStop>
NoBoardingAtStop 0:1 A questa fermata non è possibile salire a bordo. 
<NoBoardingAtStop>true</NoBoardingAtStop>
NoAlightingAtStop 0:1 A questa fermata non è possibile scendere dal treno. 
<NoAlightingAtStop>true</NoAlightingAtStop>

La ContinousServiceStructure

Elemento Cardinalità Descrizione Esempio
OperatingDayRef 1:1 Il giorno di esercizio rilevante 
<OperatingDayRef>2020-04-03</OperatingDayRef>
JourneyRef 1:1 L’ID della corsa. 
<JourneyRef>ch:1:sjyid:100001:627-001</JourneyRef>
siri:LineRef 1:1 ID della linea: 
<siri:LineRef>ojp:91021:H</siri:LineRef>
siri:DirectionRef 0:1 L’ID della direzione. 
<siri:DirectionRef>R</siri:DirectionRef>
Mode 1:1 La modalità traffico.L’elenco delle modalità è disponibile presso LocationInformation Request 
<Mode>
    <PtMode>tram</PtMode>
    <siri:TramSubmode>cityTram</siri:TramSubmode>
    <Name>
        <Text xml:lang="de">Tram</Text>
    </Name>
</Mode>
PublishedLineName 1:1 Il nome pubblicato dell’elenco 
<PublishedLineName>
    <Text>11</Text>
</PublishedLineNam
OperatorRef 0:1 Riferimento all’operatore.Attenzione: potrebbe ancora cambiare. 
<siri:OperatorRef>11</siri:OperatorRef>
Attribute 0:* Gli attributi sono caratteristiche per lo più sulle corse. Ad es. autobus a pianale ribassato, bar, prenotazione necessaria.Mandataory è true se l’attributo deve essere assolutamente visualizzato all’utente. 
<Attribute>
    <Text>
        <Text xml:lang="de">Linie 31: Niederflureinstieg</Text>
    <Text>
    <Code>30</Code>
    <Mandatory>false</Mandatory>
</Attribute>
OrginStopPointRef 0:1 Il numero DIDOK del punto di partenza.Attenzione: L’ID cambierà ancora. 
<OriginStopPointRef>8591315</OriginStopPointRef>
OriginText 0:1 Nome della fermata di inizio corsa. 
<OriginText>
    <Text xml:lang="de">Zürich, Rehalp</Text>
</OriginText>
DestinationStopPointRef 0:1 Il numero DiDok della/della fermata di destinazione.Attenzione: L’ID verrà modificato. 
<DestinationStopPointRef>8591049</DestinationStopPointRef>
DestinationText 0:1 Il nome della fermata di destinazione. 
<DestinationText>
    <Text xml:lang="de">Zürich, Auzelg</Text>
</DestinationText>
Unplanned 0:1 Indica se si tratta di una corsa supplementare non riportata nell’orario regolare. Var. booleana. 
<Unplanned>true</Unplanned>
Cancelled 0:1 Soppressione di una corsa. Var. booleana. 
<Cancelled>true</Cancelled>
Deviation 0:1 Indica se la corsa non viene effettuata in base all’orario.Previsto per una versione futura n.d.
BookingArrangements 0:1 Questa feature non è supportata. n.d.
ParticipantRef 1:1 Serve alla comunicazione di perturbazioni o di altre situazioni straordinarie. Previsto in una versione futura n.d.
siri:SituationNumber 1:1 Serve alla comunicazione di perturbazioni o di altre situazioni straordinarie. Previsto in una versione futura n.d.

Ulteriori indicazioni

Tempo reale

Concetti importanti:

  • Giorni d’esercizio: Giorni in cui circola un treno. Può infine durare più di 24 h. Tuttavia, la notazione GG-MM-AAAA come OperatingDays ad es. in Service / Mode.
  • Tempo Zulu: Corrisponde all’orario UTC ed è indicato come segue 2025-02-02T11:24:00Z, altrimenti anche in questo caso ISO 8601 Indicazione dell’ora con differenze di fusi orari 2025-02-02T09:24:00+0200. Nell’ora UTC non ci sono cambi dell’ora legale. L’output di frazioni di secondo è comune soprattutto con il timbro data.
  • «Hysterese» (Isteresi): Nell’ambito dell’informazione alla clientela, vengono trasmesse solo le modifiche che superano una certa entità. Questo avviene per mezzo di un’isteresi. In altre parole, i ritardi non vengono rilevati, ma trasmessi solo al momento di una determinata modifica. Gli scostamenti vengono comunicati in 1/10 minuti.

I dati dell’orario reale o del tempo reale sono forniti solo per il giorno d’esercizio attuale. Lo scostamento viene indicato rispettivamente in relazione a StopPointRef, che corrisponde anche all’elemento presente nell’orario, mentre uno StopPlaceRef fa riferimento a un punto in una stazione. In Svizzera vengono utilizzati ID identici per StopPointRef e StopPlaceRef.

Ecco un esempio con tempo reale basato su «CallAtStop». Lo stesso concetto può essere applicato a tutti i servizi in OJP, in cui vengono pubblicate scostamenti dall’orario:

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

La discrepanza tra «TimetabledTime» e «EstimatedTime» è lo scostamento in tempo reale rispetto all’orario, che viene indicato anche se si tratta ad es. di un arrivo anticipato. Pertanto è opportuno implementare una logica per l’emissione dello scostamento, in modo che vengano emessi solo gli scostamenti rilevanti per il cliente, come ad esempio un ritardo.

Treni Autotunnel

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

Profili di grandi dimensioni (presso la BLS) sono riconoscibili dall’attributo GF:

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