OJPTripInfoRequest

#AutoTranslate

Descrizione breve

Con la TripInfoRequest si possono richiedere ulteriori dettagli su un «Journey» (viaggio).

Descrizione tecnica

API Explorer

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

Request

L’informazione centrale per la TripInfoRequest è un ojp:JourneyRef con ojp:OperatingDayRef – ossia un riferimento a un determinato Journey in un giorno civile. Il JourneyRef va ricavato dalla risposta a un’altra richiesta (ad es. TripRequest o StopEventRequest).

<?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>2020-01-20T12:00:00Z</RequestTimestamp>
			<RequestorRef>IRMA</RequestorRef>
			<ojp:OJPTripInfoRequest>
				<RequestTimestamp>2020-01-20T12:00:00Z</RequestTimestamp>
				<MessageIdentifier>756</MessageIdentifier>
				<ojp:JourneyRef>ch:1:sjyid:100001:612-002</ojp:JourneyRef>
				<ojp:OperatingDayRef>2020-01-20</ojp:OperatingDayRef>
				<ojp:Params>
					<ojp:IncludeCalls>true</ojp:IncludeCalls>
					<ojp:IncludePosition>false</ojp:IncludePosition>
					<ojp:IncludeService>true</ojp:IncludeService>
					<ojp:IncludeTrackSections>true</ojp:IncludeTrackSections>
					<ojp:IncludeTrackProjection>true</ojp:IncludeTrackProjection>
				</ojp:Params>
			</ojp:OJPTripInfoRequest>
		</ServiceRequest>
	</OJPRequest>
</OJP>

Elemento	Cardinalità	Descrizione	Esempio
`RequestTimestamp`	1:1	Timestamp della richiesta. Preferito in Zulu Time.	<RequestTimestamp>2020-01-20T12:00:00Z</RequestTimestamp>
`MessageIdentifier`	0:1	L’identificativo della segnalazione. Preferibilmente di tipo crescente.	<MessageIdentifier>756</MessageIdentifier>
`JourneyRef`	0:1	Riferimento alla corsa. Il riferimento può essere determinato mediante una TripRequest o una StopEventRequest.	<ojp:JourneyRef>ch:1:sjyid:100001:612-002</ojp:JourneyRef>
`OperatingDayRef`	0:1	Nel formato AAAA-MM-GG	<ojp:OperatingDayRef>2026-06-23</ojp:OperatingDayRef>
`siri:VehicleRef`	0:1	n.d. Questa funzione non è disponibile.	n.d.
`TimeOfOperation`	0:1	n.d. Questa funzione non è disponibile.	n.d.
`Params`	0:1	Ulteriori parametri per la richiesta
`Params/UseTimetableDataOnly`	0:1	Si dovrebbe rinunciare al tempo reale? L’impostazione di default è falsa.
`Params/IncludeCalls`	0:1	Devono essere inserite le «Calls» (fermate intermedie)? L’impostazione di default è true.
`Params/IncludePosition`	0:1	Deve essere inserita la posizione attuale del treno? Questa funzione non è disponibile.	n.d.
`Params/IncludeService`	0:1	Deve essere inserita l’informazione sul servizio (LineRef, Mode, OperatorRef ecc.)? L’impostazione di default è true.
`Params/IncludeTrackSections`	0:1	Aggiungere informazioni geografiche dell’itinerario? L’impostazione di default è false.
`Params/IncludeTrackProjection`	0:1	Trasmettere anche i progetti di coordinate? Questa feature è prevista.

Risposta

In cima (del contenuto vero e proprio) si trova TripInfoResponseContext fornito, in particolare informazioni sui «luoghi» utilizzati – vedere descrizione più dettagliata in OJPTrip Request

<ojp:TripInfoResponseContext>
    <ojp:Places>
        <ojp:Location>
            <ojp:StopPlace>
                <ojp:StopPlaceRef>ch:1:sloid:3000</ojp:StopPlaceRef>
                <ojp:StopPlaceName>
                    <ojp:Text>Zürich HB</ojp:Text>
                </ojp:StopPlaceName>
                <ojp:PrivateCode>
                    <ojp:System>EFA</ojp:System>
                    <ojp:Value>104014:0:8</ojp:Value>
                </ojp:PrivateCode>
                <ojp:TopographicPlaceRef>23026261:27</ojp:TopographicPlaceRef>
            </ojp:StopPlace>
            <ojp:LocationName>
                <ojp:Text xml:lang="de">Zürich HB</ojp:Text>
            </ojp:LocationName>
            <ojp:GeoPosition>
                <siri:Longitude>8.54021</siri:Longitude>
                <siri:Latitude>47.37818</siri:Latitude>
            </ojp:GeoPosition>
        </ojp:Location>
<!-- ... -->
    </ojp:Places>
</ojp:TripInfoResponseContext>

TripInfoResult

Attenzione: A seconda dei parametri impostati, le parti sottostanti vengono o meno nella risposta. Pertanto, eventualmente, verificare i parametri nella richiesta per ottenere (non) determinate parti.

Esempio di risposta completa: TripInfoRequest_example_response

A seconda del contesto segue il viaggio stesso; prima tutte le fermate con PreviousCall (fermate precedenti) e Onward call (fermate successive). Possono essere riportate più fermate rispetto alla TripRequest utilizzata per il rilevamento del JourneyRef, poiché in TripInfoRequest viene fornita l’intera corsa.

Se nella request non è stato escluso l’orario in tempo reale con UseTimetableDataOnly=true, oltre all’orario previsto dall’orario ufficiale e al binario dalla partenza/arrivo (TimetabledTime, Planned Quay) vengono forniti (se disponibili) anche i dati in tempo reale (EstimatedTime, EstimatedQuay).

Esempio: Per una TripRequest da Berna a Zurigo, nella corrispondente TripInfoRequest potrebbe essere fornita una corsa da Ginevra a San Gallo, di cui la sezione Berna – Zurigo è un sottoinsieme.

<ojp:TripInfoResult>
    <ojp:PreviousCall>
        <siri:StopPointRef>ch:1:sloid:3000</siri:StopPointRef>
        <ojp:StopPointName>
            <ojp:Text>Zürich HB</ojp:Text>
        </ojp:StopPointName>
        <ojp:PlannedQuay>
            <ojp:Text xml:lang="de">8</ojp:Text>
        </ojp:PlannedQuay>
        <ojp:EstimatedQuay>
            <ojp:Text xml:lang="de">9</ojp:Text>
        </ojp:EstimatedQuay>
        <ojp:ServiceDeparture>
            <ojp:TimetabledTime>2020-07-13T13:32:00Z</ojp:TimetabledTime>
            <ojp:EstimatedTime>2020-07-13T13:32:00Z</ojp:EstimatedTime>
        </ojp:ServiceDeparture>
        <ojp:Order>1</ojp:Order>
    </ojp:PreviousCall>
    <ojp:PreviousCall>
        <siri:StopPointRef>ch:1:sloid:2204</siri:StopPointRef>
        <ojp:StopPointName>
            <ojp:Text>Zug</ojp:Text>
        </ojp:StopPointName>
        <ojp:PlannedQuay>
            <ojp:Text xml:lang="de">4</ojp:Text>
        </ojp:PlannedQuay>
        <ojp:ServiceArrival>
            <ojp:TimetabledTime>2020-07-13T13:56:00Z</ojp:TimetabledTime>
            <ojp:EstimatedTime>2020-07-13T13:57:00Z</ojp:EstimatedTime>
        </ojp:ServiceArrival>
        <ojp:ServiceDeparture>
            <ojp:TimetabledTime>2020-07-13T13:58:00Z</ojp:TimetabledTime>
            <ojp:EstimatedTime>2020-07-13T13:59:00Z</ojp:EstimatedTime>
        </ojp:ServiceDeparture>
        <ojp:Order>2</ojp:Order>
    </ojp:PreviousCall>
<!-- ... -->
    <ojp:OnwardCall>
        <siri:StopPointRef>ch:1:sloid:5300</siri:StopPointRef>
        <ojp:StopPointName>
            <ojp:Text>Lugano</ojp:Text>
        </ojp:StopPointName>
        <ojp:PlannedQuay>
            <ojp:Text xml:lang="de">3</ojp:Text>
        </ojp:PlannedQuay>
        <ojp:ServiceArrival>
            <ojp:TimetabledTime>2020-07-13T15:56:00Z</ojp:TimetabledTime>
            <ojp:EstimatedTime>2020-07-13T15:52:00Z</ojp:EstimatedTime>
        </ojp:ServiceArrival>
        <ojp:Order>8</ojp:Order>
    </ojp:OnwardCall>
<!-- ... -->
</ojp:TripInfoResult>

Successivamente le informazioni su Servizio: LineRef, Mode (tipo di mezzo di intermediazione), OperatorRef. ecc.

<ojp:TripInfoResult>
<!-- ... -->
    <ojp:Service>
        <ojp:OperatingDayRef>2020-07-13</ojp:OperatingDayRef>
        <ojp:JourneyRef>ojp:91002:F:R:j20:205</ojp:JourneyRef>
        <siri:LineRef>ojp:91002:F</siri:LineRef>
        <siri:DirectionRef>R</siri:DirectionRef>
        <ojp:Mode>
            <ojp:PtMode>rail</ojp:PtMode>
            <siri:RailSubmode>local</siri:RailSubmode>
            <ojp:Name>
                <ojp:Text xml:lang="de">Zug</ojp:Text>
            </ojp:Name>
            <ojp:ShortName>
                <ojp:Text xml:lang="de">IC</ojp:Text>
            </ojp:ShortName>
        </ojp:Mode>
        <ojp:PublishedLineName>
            <ojp:Text>2</ojp:Text>
        </ojp:PublishedLineName>
        <ojp:OperatorRef>ojp:11</ojp:OperatorRef>
        <ojp:OriginStopPointRef>ch:1:sloid:3000</ojp:OriginStopPointRef>
        <ojp:OriginText>
            <ojp:Text xml:lang="de">Zürich HB</ojp:Text>
        </ojp:OriginText>
        <ojp:DestinationStopPointRef>8505300</ojp:DestinationStopPointRef>
        <ojp:DestinationText>
            <ojp:Text xml:lang="de">Lugano</ojp:Text>
        </ojp:DestinationText>
    </ojp:Service>
<!-- ... -->
</ojp:TripInfoResult>

Successivamente, in Journey Track (Parametri nella richiesta: IncludeTrackSections) informazioni geografiche sul viaggio.

<ojp:TripInfoResult>
<!-- ... --> 
	<ojp:JourneyTrack>
		<ojp:TrackSection>
			<ojp:TrackStart>
				<siri:StopPointRef>ch:1:sloid:3000</siri:StopPointRef>
				<ojp:LocationName>
					<ojp:Text xml:lang="de">Zürich HB</ojp:Text>
				</ojp:LocationName>
			</ojp:TrackStart>
			<ojp:TrackEnd>
				<siri:StopPointRef>8505307</siri:StopPointRef>
				<ojp:LocationName>
					<ojp:Text xml:lang="de">Chiasso</ojp:Text>
				</ojp:LocationName>
			</ojp:TrackEnd>
			<ojp:Length>220041</ojp:Length>
		</ojp:TrackSection>
	</ojp:JourneyTrack>
</ojp:TripInfoResult>

Infine, nell’estensione, attualmente come unica informazione viene visualizzato il numero pubblicato (nell’esempio in basso «319», poiché si tratta dell’EC 319)

<ojp:TripInfoResult>
<!-- ... -->
    <ojp:Extension>
        <ojp:TransportTypeName>
            <ojp:Text xml:lang="de"></ojp:Text>
        </ojp:TransportTypeName>
        <ojp:PublishedJourneyNumber>
            <ojp:Text xml:lang="de">319</ojp:Text>
        </ojp:PublishedJourneyNumber>
    </ojp:Extension>
</ojp:TripInfoResult>

Indice della materia

Ricerca nella pagina