OJPTripInfoRequest

#AutoTranslate

Descrizione breve

Con la TripInfoRequest è possibile richiedere ulteriori dettagli su un «Journey» (corsa).

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 deve essere 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>qv1:91011::H:j20:500</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. Preferibilmente in Zulu Time.	<RequestTimestamp>2020-01-20T12:00:00Z</RequestTimestamp>
`MessageIdentifier`	0:1	L’identificativo della segnalazione. Preferibilmente in ordine crescente.	<MessageIdentifier>756</MessageIdentifier>
`JourneyRef`	0:1	Riferimento alla corsa. Il riferimento può essere determinato tramite TripRequest o StopEventRequest.	<ojp:JourneyRef>qv1:91011::H:j20:500</ojp:JourneyRef>
`OperatingDayRef`	0:1	Nel formato AAAA-MM-GG	<ojp:OperatingDayRef>2020-01-20</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	Altri parametri per la richiesta
`Params/UseTimetableDataOnly`	0:1	Non si dovrebbe utilizzare il tempo reale? Default is false (Default is false).
`Params/IncludeCalls`	0:1	Devono essere inserite le «Calls» (fermate intermedie)? Di default è true.
`Params/IncludePosition`	0:1	Va inserita la posizione attuale del treno? Questa funzione non è disponibile.	n.d.
`Params/IncludeService`	0:1	L’informazione di servizio deve essere inserita (LineRef, Mode, OperatorRef ecc.)? Il valore di default è true.
`Params/IncludeTrackSections`	0:1	Devono essere aggiunte informazioni geografiche sull’itinerario? Di default è false.
`Params/IncludeTrackProjection`	0:1	Devono essere trasmessi anche i progetti di coordinate? Questa feature è prevista.

Risposta

In alto (del contenuto vero e proprio) viene visualizzato TripInfoResponseContext fornito, soprattutto informazioni sui «luoghi» utilizzati – vedere descrizione più dettagliata in OJPTrip Request

<ojp:TripInfoResponseContext>
    <ojp:Places>
        <ojp:Location>
            <ojp:StopPlace>
                <ojp:StopPlaceRef>8503000</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 elencate di seguito compaiono o meno nella risposta. Pertanto, eventualmente verificare i parametri della Request per ricevere (non) determinate parti.

Esempio di risposta completa: TripInfoRequest_esempio_response

A seconda del contesto, il Journey stesso, innanzitutto tutte le fermate con PreviousCall (fermate precedenti) e Onward Call (fermate successive). Possono contenere più fermate rispetto alla TripRequest utilizzata per la determinazione del JourneyRef, poiché nella TripInfoRequest viene fornita rispettivamente l’intera corsa.

Se nella Request non è stato escluso il tempo reale con UseTimetableDataOnly=true, oltre all’orario e al binario di partenza/arrivo previsti dall’orario ufficiale (TimetabledTime, Planned Quay) vengono visualizzati anche i dati in tempo reale (EstimatedTime, EstimatedQuay).

Esempio: In una TripRequest da Berna a Zurigo, nella corrispondente TripInfoRequest potrebbe essere fornita una corsa da Ginevra a San Gallo, laddove il tratto Berna–Zurigo è una quantità parziale.

<ojp:TripInfoResult>
    <ojp:PreviousCall>
        <siri:StopPointRef>8503000</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>8502204</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>8505300</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 relative a Servizio: LineRef, Mode (tipo di mezzo di distribuzione), 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>8503000</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 vengono Journey track (parametri nella richiesta: IncludeTrackSections) informazioni geografiche sulla Journey.

<ojp:TripInfoResult>
<!-- ... --> 
	<ojp:JourneyTrack>
		<ojp:TrackSection>
			<ojp:TrackStart>
				<siri:StopPointRef>8503000</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 figura attualmente come unica informazione il numero pubblicato (nell’esempio in basso «319», perché 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