StopEventService
Il servizio StopEvent viene utilizzato per costruire un monitor di partenza o di arrivo.
API-Explorer
È possibile provare le proprie richieste – link diretto all’API Explorer.
Request
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 |
<?xml version="1.0" encoding="utf-8"?> <OJP xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.siri.org.uk/siri" version="1.0" xmlns:ojp="http://www.vdv.de/ojp" xsi:schemaLocation="http://www.siri.org.uk/siri ../ojp-xsd-v1.0/OJP.xsd"> <OJPRequest> <ServiceRequest> <RequestTimestamp>2021-01-09T11:34:25.507Z</RequestTimestamp> <RequestorRef>API-Explorer</RequestorRef> <ojp:OJPStopEventRequest> <RequestTimestamp>2020-01-20T12:00:00Z</RequestTimestamp> <MessageIdentifier>756</MessageIdentifier> <ojp:Location> <ojp:PlaceRef> <ojp:StopPlaceRef>8530813</ojp:StopPlaceRef> <ojp:LocationName> <ojp:Text>Zürich Kreuzplatz</ojp:Text> </ojp:LocationName> </ojp:PlaceRef> <ojp:DepArrTime>2021-01-20T12:00:00Z</ojp:DepArrTime> <ojp:IndividualTransportOptions> <Mode>walk</Mode> <MaxDistance>5000</MaxDistance> <MaxDuration>PT5M</MaxDuration> <MinDistance>0</MinDistance> <MinDuration>PT0M</MinDuration> <Speed>50</Speed> <AdditionalTime>PT10M</AdditionalTime> </ojp:IndividualTransportOptions> </ojp:Location> <ojp:Params> <ojp:StopEventType>both</ojp:StopEventType> <ojp:IncludePreviousCalls>true</ojp:IncludePreviousCalls> <ojp:IncludeOnwardCalls>true</ojp:IncludeOnwardCalls> <ojp:IncludeOperatingDays>true</ojp:IncludeOperatingDays> <ojp:IncludeRealtimeData>true</ojp:IncludeRealtimeData> </ojp:Params> </ojp:OJPStopEventRequest> </ServiceRequest> </OJPRequest> </OJP> |
| Elemento | Cardinalità | Descrizione | Esempio | ||
| RequestTimestamp | 1:1 | Timestamp (data e ora) della richiesta. Preferibilmente in tempo Zulu. |
|
||
| MessageIdentifier | 0:1 | L’identificatore del messaggio. Preferibilmente in costante aumento. |
|
||
| ojp:Location/ojp:PlaceRef | 0:1 | È preferibile utilizzare uno StopPlaceRef. Il Location Name (nome della località) viene ignorato.
Attenzione: possono verificarsi sia Didok che SLOID. Maggiori informazioni. |
|
||
| ojp:Location/ojp:DepArrTime | 0:1 | Il tempo da utilizzare. Meglio come Zulu Time
“Z” è l’ora Zulu (cioè indipendente dai fusi orari). Per Z, è necessario specificare anche i secondi. Se il formato non è corretto o non c’è Z, il sistema tenta di interpretare l’ora come ora locale. |
|
||
| ojp:Location/ojp:TimeAllowance | 0:1 | In alternativa a DepArrTime. Tempo ancora necessario per raggiungere la località. xs:Duration. |
|
||
| ojp:Location/ojp:IndividualTransportOptions | 0:* | Opzioni per raggiungere o lasciare il luogo. Vedere la sezione IndividualTransportOptions sotto Trip Service.
Modi di trasporto consentiti: walk, cycle, taxi, self-drive-car, others-drive-car, motorcycle, truck. Al momento sono supportati solo gli spostamenti walk e cycle. Le distanze sono espresse in metri. La velocità relativa al normale (=100%). AdditionalTime è il tempo aggiuntivo in questa modalità. |
|
||
| ojp:/Params | 0:1 | i parametri |
|
Params (i parametri)
| Elemento | Cardinalità | Descrizione | Esempio | ||
| ojp:PtModeFilter | 0:1 | Filtrare per moda. L’elemento Exclude specifica se le modalità devono essere incluse o escluse.
1:* possono essere aggiunte modalità. Vedere PtModeFilter in Trip Service |
|
||
| ojp:LineFilter | 0:1 | Filtrare per linea. L’elemento Exclude specifica se le righe devono essere incluse o escluse.
1:* È possibile aggiungere linee.
|
|
||
| ojp:OperatorFilter | 0:1 | Filtrare per operatore. L’elemento Exclude specifica se gli operatori devono essere inclusi o esclusi.
1:* È possibile aggiungere OperatorRef. |
|
||
| ojp:NumberOfResults | 0:1 | Numero di risultati |
|
||
| ojp:StopEventType | 0:1 | Tipo di StopEvents:
|
|
||
| ojp:IncludePreviousCalls | 0:1 | Le fermate precedenti devono essere specificate anche per i singoli viaggi? |
|
||
| ojp:IncludeOnwardCalls | 0:1 | Le fermate successive devono essere specificate anche per i singoli viaggi? |
|
||
| ojp:IncludeOperatingDays | 0:1 | Le informazioni sul giorno di funzionamento devono essere inserite anche per questo evento di arresto? |
|
||
| ojp:IncludeRealtimeData | 0:1 | I dati in tempo reale devono essere utilizzati per calcolare il viaggio? |
|
Response
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 |
<?xml version="1.0" encoding="UTF-8"?> <siri:OJP xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:siri="http://www.siri.org.uk/siri" version="1.0" xmlns:ojp="http://www.vdv.de/ojp" xsi:schemaLocation="http://www.siri.org.uk/siri ../ojp-xsd-v1.0/OJP.xsd"> <siri:OJPResponse> <siri:ServiceDelivery> <siri:ResponseTimestamp>2020-01-12T22:27:13Z</siri:ResponseTimestamp> <siri:ProducerRef>OJPCH_test</siri:ProducerRef> <siri:Status>true</siri:Status> <ojp:OJPStopEventDelivery> <siri:ResponseTimestamp>2020-01-12T22:27:13Z</siri:ResponseTimestamp> <siri:RequestMessageRef>756</siri:RequestMessageRef> <siri:Status>true</siri:Status> <ojp:CalcTime>310</ojp:CalcTime> <ojp:StopEventResponseContext> <ojp:Places> <ojp:Location> <ojp:StopPlace> <ojp:StopPlaceRef>8530813</ojp:StopPlaceRef> <ojp:StopPlaceName> <ojp:Text>Zürich Kreuzplatz</ojp:Text> </ojp:StopPlaceName> <ojp:TopographicPlaceRef>-1:-1</ojp:TopographicPlaceRef> </ojp:StopPlace> <ojp:LocationName> <ojp:Text xml:lang="de">Zürich Kreuzplatz</ojp:Text> </ojp:LocationName> <ojp:GeoPosition/> </ojp:Location> <ojp:Location> <ojp:StopPoint> <siri:StopPointRef>8530813</siri:StopPointRef> <ojp:StopPointName> <ojp:Text>Zürich Kreuzplatz</ojp:Text> </ojp:StopPointName> <ojp:ParentRef>8530813</ojp:ParentRef> <ojp:TopographicPlaceRef>-1:-1</ojp:TopographicPlaceRef> </ojp:StopPoint> <ojp:LocationName> <ojp:Text xml:lang="de">Zürich Kreuzplatz</ojp:Text> </ojp:LocationName> <ojp:GeoPosition> <siri:Longitude>8.55408</siri:Longitude> <siri:Latitude>47.36488</siri:Latitude> </ojp:GeoPosition> </ojp:Location> <!--- and so on ---> </ojp:Places> </ojp:StopEventResponseContext> <ojp:StopEventResult> <ojp:ResultId>ID-61BB1C56-4F28-410A-9D03-298D9BF9165C</ojp:ResultId> <ojp:StopEvent> <ojp:PreviousCall> <ojp:CallAtStop> <siri:StopPointRef>8591228</siri:StopPointRef> <ojp:StopPointName> <ojp:Text>Zürich, Kienastenwies</ojp:Text> </ojp:StopPointName> <ojp:ServiceDeparture> <ojp:TimetabledTime>2020-01-12T12:42:00Z</ojp:TimetabledTime> </ojp:ServiceDeparture> <ojp:Order>1</ojp:Order> </ojp:CallAtStop> </ojp:PreviousCall> <!--- and so on ---> <ojp:ThisCall> <ojp:CallAtStop> <siri:StopPointRef>8530813</siri:StopPointRef> <ojp:StopPointName> <ojp:Text>Zürich Kreuzplatz</ojp:Text> </ojp:StopPointName> <ojp:ServiceArrival> <ojp:TimetabledTime>2020-01-12T12:56:00Z</ojp:TimetabledTime> </ojp:ServiceArrival> <ojp:Order>14</ojp:Order> </ojp:CallAtStop> </ojp:ThisCall> <ojp:OnwardCall> <ojp:CallAtStop> <siri:StopPointRef>8591375</siri:StopPointRef> <ojp:StopPointName> <ojp:Text>Zürich, Sprecherstrasse</ojp:Text> </ojp:StopPointName> <ojp:ServiceArrival> <ojp:TimetabledTime>2020-01-12T12:56:00Z</ojp:TimetabledTime> </ojp:ServiceArrival> <ojp:ServiceDeparture> <ojp:TimetabledTime>2020-01-12T12:56:00Z</ojp:TimetabledTime> </ojp:ServiceDeparture> <ojp:Order>15</ojp:Order> </ojp:CallAtStop> </ojp:OnwardCall> <!--- and so on ---> <ojp:Service> <ojp:OperatingDayRef></ojp:OperatingDayRef> <ojp:JourneyRef>sbb:92031::R:j20:21060</ojp:JourneyRef> <siri:LineRef>sbb:92031::R</siri:LineRef> <siri:DirectionRef>H</siri:DirectionRef> <ojp:Mode> <ojp:PtMode>bus</ojp:PtMode> <siri:BusSubmode>regionalBus</siri:BusSubmode> <ojp:Name> <ojp:Text xml:lang="de">Bus</ojp:Text> </ojp:Name> </ojp:Mode> <ojp:PublishedLineName> <ojp:Text>31</ojp:Text> </ojp:PublishedLineName> <ojp:OperatorRef>sbb:849:VerkehrsbetriebeZrich</ojp:OperatorRef> <ojp:Attribute> <ojp:Text> <ojp:Text xml:lang="de">Linie 31: Niederflureinstieg</ojp:Text> </ojp:Text> <ojp:Code>30</ojp:Code> <ojp:Mandatory>false</ojp:Mandatory> </ojp:Attribute> <ojp:OriginStopPointRef>8591228</ojp:OriginStopPointRef> <ojp:OriginText> <ojp:Text xml:lang="de">Zürich, Kienastenwies</ojp:Text> </ojp:OriginText> <ojp:DestinationStopPointRef>8591056</ojp:DestinationStopPointRef> <ojp:DestinationText> <ojp:Text xml:lang="de">Zürich Altstetten, Bahnhof</ojp:Text> </ojp:DestinationText> </ojp:Service> </ojp:StopEvent> </ojp:StopEventResult> </ojp:OJPStopEventDelivery> </siri:ServiceDelivery> </siri:OJPResponse> </siri:OJP> |
È importante sapere che in alcuni casi non sono incluse solo le informazioni pertinenti alla fermata selezionata, ma anche tutte le informazioni sul viaggio. La risposta è contenuta in un ojp:OJPStopEventDelivery.
| Elemento | Cardinalità | Descrizione | Esempio | ||
| siri:ResponseTimestamp | 1:1 | Il timestamp della risposta |
|
||
| siri:RequesteMessageRef | 0:1 | Il messaggio richiesto è riportato qui |
|
||
| siri:Status | 1:1 | Lo stato della risposta. true significa che la richiesta è stata elaborata. |
|
||
| ojp:CalcTime | 1:1 | Il tempo di calcolo in millisecondi |
|
||
| ojp:StopEventResponseContext | 1:1 | Qui vengono restituite le informazioni di riferimento, come le fermate utilizzate.
Vedi tabella separata |
|||
| ojp:StopEventResult | 0:n | I risultati effettivi | |||
| ojp:StopEventResult/ojp:StopEventResultID | 1:1 | L’ID del risultato |
|
||
| ojp:StopEventResult/ojp:StopEvent | 1:1 | I viaggi individuali
vedi tabella separata |
StopEventResponseContext
Il contesto contiene
- Location(s) (posizione(i))
- Situazione/i (on ancora attuata)
| Elemento | Cardinalità | Descrizione | Esempio | ||
| ojp:StopPlace | 1:1 | ||||
| ojp:StopPlace/ojp:StopPlaceRef | 1:1 | Il riferimento alla fermata dell’autobus. Al momento si tratta del numero DiDok. Tuttavia, può anche essere il NeTEx-id di uno StopPlace o, in futuro, uno Swiss Location id (SLOID). Per il momento, esiste una stretta connessione tra i tre riferimenti. |
|
||
| ojp:StopPlace/ojp:StopPlaceName | 1:1 | Il nome della fermata. Attualmente non esiste una lingua per le fermate. |
|
||
| ojp:StopPlace/ojp:TopographicPlaceRef | 1:1 | Si tratta di un riferimento nell’albero delle posizioni.
Poiché non è prevista la pubblicazione dell’albero di localizzazione, questa funzione può essere utilizzata solo se è stata richiesta in anticipo in una LocationInformationRequest. |
|
||
| ojp:StopPlace/ojp:LocationName | 1:1 | Nome del luogo |
|
||
| ojp:StopPlace/ojp:GeoPosition | 1:1 | Coordinate WGS84 |
|
ojp:StopEvent
L’evento StopEvent è composto da:
- ojp:PreviousCall(s): se il parametro è selezionato
- ojp:ThisCall: la fermata attualmente selezionata
- ojp:OnwardCall(s): Le future tappe del viaggio
- ojp:Servizio: Informazioni sul viaggio
| Elemento | Cardinalità | Descrizione | Esempio | ||
| ojp:PreviousCall | 0:* | Le PreviousCall sono le fermate precedenti a quella richiesta.
Tutte le informazioni sono contenute in una CallAtStop. Vedere la sezione corrispondente |
|
||
| ojp:ThisCall | 1:1 | Questo è il senso della richiesta.
Tutte le informazioni sono contenute in una CallAtStop. Vedere la sezione corrispondente |
|
||
| ojp:OnwardCall | 0:* | Le OnwardCall sono le fermate successive alla fermata corrente che è stata richiesta nella domanda.
Tutte le informazioni sono contenute in una CallAtStop. Vedere la sezione corrispondente |
|
||
| ojp:Service | 1:1 | Il servizio è l’informazione effettiva sull’intero viaggio. |
|
ojp:CallAtStop
| Elemento | Cardinalità | Descrizione | Esempio | ||
| siri:StopPointRef | 1:1 | Il numero della fermata. Al momento è ancora un numero DiDok. Può anche essere un ID NeTEx o uno SLOID.
Attenzione: possono verificarsi sia didok che sloid. Maggiori informazioni. |
|
||
| ojp:StopPointName | 1:1 | Il nome della fermata |
|
||
| ojp:PlannedQuay | 0:1 | La salita prevista |
|
||
| ojp:EstimatedQuay | 0:1 | La salita attuale, se disponibile |
|
||
| ojp:ServiceArrival | 0:1 | La prima fermata non prevede alcun Arrival (arrivo). |
|
||
| ojp:ServiceDeparture | 0:1 | L’ultima fermata non ha Departure (partenza). |
|
||
| ojp:Order | 1:1 | L’ordine delle fermate |
|
||
| ojp:RequestStop | 0:1 | Fermata su richiesta. Boolean:
Non implementato, previsto per una versione futura. |
n/a | ||
| ojp:UnplannedStop | 0:1 | Sosta, che non era prevista. Boolean:
Non implementato, previsto per una versione futura. |
n/a | ||
| ojp:NotServicedStop | 0:1 | Contrariamente alla pianificazione, non c’è alcuno stop (cancellazioni). |
|
||
| ojp:SituationFullRef | 0:1 | La funzione non è disponibile.
|
n/a |
ojp:Service
| Elemento | Cardinalità | Descrizione | Esempio | ||
| ojp:OperatingDayRef | 1:1 | Il giorno operativo in questione |
|
||
| ojp:JourneyRef | 1:1 | L’id del viaggio. |
|
||
| siri:LineRef | 1:1 | L’id della linea. |
|
||
| siri:DirectionRef | 1:1 | L’id della direzione. |
|
||
| ojp:Mode | 1:1 | La modalità di traffico.
L’elenco delle modalità si trova nella richiesta LocationInformationRequest |
|
||
| ojp:PublishedLineName | 1:1 | Il nome pubblicato dell’elenco. |
|
||
| ojp:OperatorRef | 0:1 | Il riferimento all’operatore.
Attenzione: cambierà ancora. |
|
||
| ojp:Attribute | 0:* | Gli attributi sono soprattutto proprietà nei viaggi. Ad esempio, autobus a pianale ribassato, bar, prenotazione necessaria.
ojp:Mandataory è true (vero) se l’attributo deve essere visualizzato dall’utente. |
|
||
| ojp:OrginStopPointRef | 0:1 | Il numero Didok del punto di partenza.
Attenzione: l’id continuerà a cambiare. |
|
||
| ojp:OriginText | 0:1 | Il nome dell’arresto iniziale. |
|
||
| ojp:DestinationStopPointRef | 0:1 | Il numero DiDok della fermata di destinazione.
Attenzione: l’id continuerà a cambiare. |
|
||
| ojp:DestinationText | 0:1 | Il nome della fermata di destinazione. |
|
||
| ojp:Unplanned | 0:1 | Indica se si tratta di una corsa aggiuntiva non presente nell’orario regolare. Boolean. |
|
||
| ojp:Cancelled | 0:1 | Cancellazione di un viaggio. Boolean. |
|
||
| ojp:Deviation | 0:1 | Indica se il viaggio non viene effettuato secondo l’orario.
Previsto per una versione futura |
n/a | ||
| ojp:BookingArrangements | 0:1 | La funzione non è supportata. | n/a | ||
| ojp:ParticipantRef | 1:1 | Utilizzato per comunicare guasti o altre situazioni insolite.
Previsto per una versione futura |
n/a | ||
| ojp:SituationNumber | 1:1 | Utilizzato per comunicare guasti o altre situazioni insolite.
Previsto per una versione futura |
n/a |
Casi speciali
Treni per auto in galleria
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 |
<siri: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="1.0"> <siri:OJPRequest> <siri:ServiceRequest> <siri:RequestTimestamp>2024-07-22T10:40:16.970Z</siri:RequestTimestamp> <siri:RequestorRef>OJP_JS_SDK_v0.9.35</siri:RequestorRef> <OJPStopEventRequest> <siri:RequestTimestamp>2024-07-22T10:40:16.970Z</siri:RequestTimestamp> <Location> <PlaceRef> <StopPlaceRef>8519606</StopPlaceRef> <LocationName> <Text/> </LocationName> </PlaceRef> <DepArrTime>2024-07-22T10:40:02.237Z</DepArrTime> </Location> <Params> <NumberOfResults>10</NumberOfResults> <StopEventType>departure</StopEventType> <IncludePreviousCalls>true</IncludePreviousCalls> <IncludeOnwardCalls>true</IncludeOnwardCalls> <IncludeRealtimeData>true</IncludeRealtimeData> </Params> <siri:Extensions> <ParamsExtension> <PrivateModeFilter> <Exclude>false</Exclude> </PrivateModeFilter> </ParamsExtension> </siri:Extensions> </OJPStopEventRequest> </siri:ServiceRequest> </siri:OJPRequest> </siri:OJP> |
|
1 2 3 4 5 6 |
<ojp:Attribute> <ojp:Text> <ojp:Text xml:lang="de">Grossraumprofil</ojp:Text> </ojp:Text> <ojp:Code>A__GF</ojp:Code> </ojp:Attribute> |