OJPTripRequest

Concetti importanti
OJP Trip Service (servizio viaggi)
Informazioni geografiche utilizzate
Richiesta di viaggio OJP con fornitori di condivisione

Concetti importanti

Fermate: a questo scopo si possono utilizzare anche i record di dati Uffici dei trasporti pubblici in Svizzera.
Viaggi: un viaggio è il trasporto di clienti su un percorso specifico, un collegamento orario specifico, con un mezzo di trasporto specifico, a un’ora specifica, in una direzione specifica.
Orario: un orario definisce il percorso di un mezzo di trasporto nel trasporto pubblico locale e a lunga distanza e nel trasporto ferroviario di merci. Le informazioni necessarie comprendono il numero del treno, i giorni di servizio, l’itinerario, gli orari di arrivo, partenza e transito alle fermate, nonché le velocità consentite nelle singole sezioni del percorso.
Previsioni: le previsioni sono i tempi di percorrenza futuri di un treno, calcolati in base alla posizione attuale del treno. Si tiene conto dei conflitti e delle disposizioni attualmente previste nei successivi x minuti. L’ulteriore andamento della previsione viene calcolato con un metodo meno complesso
Mezzi di trasporto (VM): o sinonimo di veicoli (treno, nave, tram, autobus) dei vari modi di trasporto o usato nel senso di “sistema di trasporto” (trasporto pubblico, ecc.).
DateTime in Response: è sempre l’ora Zulu (cioè l’ora di Zulu). UTC). Aggiungere due ore in estate e un’ora in inverno.

OJP Trip Service (servizio viaggi)

TripRequest è il servizio centrale. Un viaggio viene pianificato specificando l’origine e la destinazione.

Un viaggio ha diverse “Legs” (sezioni).

API-Explorer

È possibile provare le proprie richieste – link diretto all’API Explorer.

Request

<?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-31T12:30:00Z</RequestTimestamp>
            <RequestorRef>3CC3C04A-20A0-4B12-AC46-5A7843E328A7</RequestorRef>
            <ojp:OJPTripRequest>
				<RequestTimestamp>2020-01-31T12:30:00Z</RequestTimestamp>
                <ojp:Origin>
                    <ojp:PlaceRef>
                        <ojp:StopPlaceRef>8503000</ojp:StopPlaceRef>
                        <ojp:LocationName>
                            <ojp:Text>Bern</ojp:Text>
                        </ojp:LocationName>
                    </ojp:PlaceRef>
                </ojp:Origin>
                <ojp:Destination>
                    <ojp:PlaceRef>
                        <ojp:StopPlaceRef>8505000</ojp:StopPlaceRef>
                        <ojp:LocationName>
                            <ojp:Text>Luzern</ojp:Text>
                        </ojp:LocationName>
                    </ojp:PlaceRef>
                </ojp:Destination>
                <ojp:Params>
                    <ojp:NumberOfResults>10</ojp:NumberOfResults>
                    <ojp:OptimisationMethod>fastest</ojp:OptimisationMethod>
                </ojp:Params>
            </ojp:OJPTripRequest>
        </ServiceRequest>
    </OJPRequest>
</OJP>

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

<ojp:OJPTripRequest>

<ojp:Origin>

<ojp:PlaceRef>

<ojp:StopPlaceRef>8503000</ojp:StopPlaceRef>

<ojp:LocationName>

<ojp:Text>Bern</ojp:Text>

</ojp:LocationName>

</ojp:PlaceRef>

</ojp:Origin>

<ojp:Destination>

<ojp:PlaceRef>

<ojp:StopPlaceRef>8505000</ojp:StopPlaceRef>

<ojp:LocationName>

<ojp:Text>Luzern</ojp:Text>

</ojp:LocationName>

</ojp:PlaceRef>

</ojp:Destination>

<ojp:Params>

<ojp:NumberOfResults>10</ojp:NumberOfResults>

<ojp:OptimisationMethod>fastest</ojp:OptimisationMethod>

</ojp:Params>

</ojp:OJPTripRequest>

</ServiceRequest>

</OJPRequest>

</OJP>

Elemento

Cardinalità

Descrizione

Esempio

RequestTimestamp

1:1

Il timestamp della richiesta. Preferito come Zulu Time.

<RequestTimestamp>2020-01-31T12:30:00Z</RequestTimestamp>

1	<RequestTimestamp>2020-01-31T12:30:00Z</RequestTimestamp>

MessageIdentifier

0:1

L’identificatore del messaggio. Preferibilmente in modo rigorosamente monotono e ascendente.

<MessageIdentifier>756</MessageIdentifier>

1	<MessageIdentifier>756</MessageIdentifier>

ojp:Origin

1:*

Il punto di partenza della ricerca. OJP offre un numero relativamente elevato di opzioni per la modellazione di questo aspetto.

Maggiori informazioni nella sezione corrispondente.

<ojp:Origin>
  <ojp:PlaceRef>
    <ojp:StopPlaceRef>8503000</ojp:StopPlaceRef>
    <ojp:LocationName>
      <ojp:Text>Bern</ojp:Text>
    </ojp:LocationName>
  </ojp:PlaceRef>
  <ojp:DepArrTime>2020-01-20T12:00:00Z</ojp:DepArrTime>
</ojp:Origin>

<ojp:Origin>

<ojp:PlaceRef>

<ojp:StopPlaceRef>8503000</ojp:StopPlaceRef>

<ojp:LocationName>

<ojp:Text>Bern</ojp:Text>

</ojp:LocationName>

</ojp:PlaceRef>

<ojp:DepArrTime>2020-01-20T12:00:00Z</ojp:DepArrTime>

</ojp:Origin>

ojp:Destination

1:*

Il punto di arrivo della ricerca. OJP offre un numero relativamente elevato di opzioni per la modellazione di questo aspetto.

Maggiori informazioni nella sezione corrispondente.

<ojp:Destination>
  <ojp:PlaceRef>
    <ojp:StopPlaceRef>8505000</ojp:StopPlaceRef>
    <ojp:LocationName>
      <ojp:Text>Luzern</ojp:Text>
    </ojp:LocationName>
  </ojp:PlaceRef>
  <ojp:DepArrTime>2020-01-20T12:00:00Z</ojp:DepArrTime>
</ojp:Destination>

<ojp:Destination>

<ojp:PlaceRef>

<ojp:StopPlaceRef>8505000</ojp:StopPlaceRef>

<ojp:LocationName>

<ojp:Text>Luzern</ojp:Text>

</ojp:LocationName>

</ojp:PlaceRef>

<ojp:DepArrTime>2020-01-20T12:00:00Z</ojp:DepArrTime>

</ojp:Destination>

ojp:Via

0:1

È supportata una via. Se si devono prendere in considerazione più viali o se si deve calcolare un percorso circolare, il sistema richiedente deve suddividere il percorso stesso in singoli percorsi che vengono ricercati separatamente.

<ojp:Via>
	<ojp:ViaPoint>
		<StopPointRef>8506000</StopPointRef>
		<ojp:LocationName>
			<ojp:Text>Winterthur</ojp:Text>
		</ojp:LocationName>
	</ojp:ViaPoint>
</ojp:Via>

<ojp:Via>

<ojp:ViaPoint>

<ojp:LocationName>

<ojp:Text>Winterthur</ojp:Text>

</ojp:LocationName>

</ojp:ViaPoint>

</ojp:Via>

ojp:Params

0:1

Gli altri parametri. Vedere la sezione corrispondente

<ojp:Params>
	<ojp:IncludeTrackSections>true</ojp:IncludeTrackSections>
	<ojp:IncludeLegProjection>true</ojp:IncludeLegProjection>
	<ojp:IncludeTurnDescription>true</ojp:IncludeTurnDescription>
	<ojp:IncludeAccessibility>true</ojp:IncludeAccessibility>
	<ojp:IncludeIntermediateStops>true</ojp:IncludeIntermediateStops>
	<ojp:IncludeFare>true</ojp:IncludeFare>
</ojp:Params>

<ojp:Params>

<ojp:IncludeTrackSections>true</ojp:IncludeTrackSections>

<ojp:IncludeLegProjection>true</ojp:IncludeLegProjection>

<ojp:IncludeTurnDescription>true</ojp:IncludeTurnDescription>

<ojp:IncludeAccessibility>true</ojp:IncludeAccessibility>

<ojp:IncludeIntermediateStops>true</ojp:IncludeIntermediateStops>

<ojp:IncludeFare>true</ojp:IncludeFare>

</ojp:Params>

Struttura Origin/Destination

Elemento

Cardinalità

Descrizione

Esempio

ojp:PlaceRef/siri:StopPointRef

0:1

Riferimento a StopPoint.

Attenzione: possono verificarsi sia didok che sloid. Maggiori informazioni.

<ojp:PlaceRef>
	<StopPointRef>8530813</StopPointRef>
	<ojp:LocationName>
		<ojp:Text>Zürich Kreuzplatz</ojp:Text>
	</ojp:LocationName>
</ojp:PlaceRef>

<ojp:PlaceRef>

<ojp:LocationName>

<ojp:Text>Zürich Kreuzplatz</ojp:Text>

</ojp:LocationName>

</ojp:PlaceRef>

ojp:PlaceRef/ojp:StopPlaceRef

0:1

Riferimento a una fermata

<ojp:PlaceRef>
	<StopPointRef>8530813</StopPointRef>
	<ojp:LocationName>
		<ojp:Text>Zürich Kreuzplatz</ojp:Text>
	</ojp:LocationName>
</ojp:PlaceRef>

<ojp:PlaceRef>

<ojp:LocationName>

<ojp:Text>Zürich Kreuzplatz</ojp:Text>

</ojp:LocationName>

</ojp:PlaceRef>

ojp:PlaceRef/ojp:GeoPosition

0:1

Coordinate WGS84

<ojp:PlaceRef>
	<ojp:GeoPosition>
		<Longitude>8.484003</Longitude>
		<Latitude>47.386135</Latitude>
	</ojp:GeoPosition>
	<ojp:LocationName>
		<ojp:Text>Altstetten</ojp:Text>
	</ojp:LocationName>
</ojp:PlaceRef>

<ojp:PlaceRef>

<ojp:GeoPosition>

</ojp:GeoPosition>

<ojp:LocationName>

<ojp:Text>Altstetten</ojp:Text>

</ojp:LocationName>

</ojp:PlaceRef>

ojp:PlaceRef/ojp:TopographicPlaceRef

0:1

Riferimento a un “luogo”. Difficile, poiché i valori non possono essere indovinati

<ojp:PlaceRef>
	<ojp:TopographicPlaceRef>23006351:1</ojp:TopographicPlaceRef>
	<ojp:LocationName>
		<ojp:Text>Bern (Bern)</ojp:Text>
	</ojp:LocationName>
</ojp:PlaceRef>

<ojp:PlaceRef>

<ojp:TopographicPlaceRef>23006351:1</ojp:TopographicPlaceRef>

<ojp:LocationName>

<ojp:Text>Bern (Bern)</ojp:Text>

</ojp:LocationName>

</ojp:PlaceRef>

ojp:PlaceRef/ojp:PointOfInterestRef

0:1

Riferimento a un punto di interesse. Il nome della località viene ignorato.

<ojp:PlaceRef>
	<ojp:PointOfInterestRef>1</ojp:PointOfInterestRef>
	<ojp:LocationName>
		<ojp:Text>unbekannt</ojp:Text>
	</ojp:LocationName>
</ojp:PlaceRef>

<ojp:PlaceRef>

<ojp:PointOfInterestRef>1</ojp:PointOfInterestRef>

<ojp:LocationName>

<ojp:Text>unbekannt</ojp:Text>

</ojp:LocationName>

</ojp:PlaceRef>

ojp:PlaceRef/ojp:AddressRef

0:1

Riferimento a un indirizzo

<ojp:PlaceRef>
	<ojp:AddressRef>
	      <ojp:AddressCode>streetID:1500000041::23020227:-1:Via al Dosso:Torricella-Taverne:Via al Dosso::Via al Dosso: 6807:ANY:DIVA_STREET:994668:6208464:MRCV:sbb</ojp:AddressCode>
	</ojp:>AddressRef
</ojp:PlaceRef>

<ojp:PlaceRef>

<ojp:AddressRef>

<ojp:AddressCode>streetID:1500000041::23020227:-1:Via al Dosso:Torricella-Taverne:Via al Dosso::Via al Dosso: 6807:ANY:DIVA_STREET:994668:6208464:MRCV:sbb</ojp:AddressCode>

</ojp:>AddressRef

</ojp:PlaceRef>

ojp:PlaceRef/ojp:LocationName

1:1

Nome pubblico della località

Attenzione: il nome viene ignorato. È necessario prima effettuare una LocationRequest, che restituisce un Rif o una coordinata!

<ojp:PlaceRef>
	<StopPointRef>8503003</StopPointRef>
	<ojp:LocationName>
	<ojp:Text>Zürich Stadelhofen</ojp:Text>
	</ojp:LocationName>
</ojp:PlaceRef>

<ojp:PlaceRef>

<ojp:LocationName>

<ojp:Text>Zürich Stadelhofen</ojp:Text>

</ojp:LocationName>

</ojp:PlaceRef>

ojp:DepArrtime

0:1

Tempo di utilizzo.

“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:DepArrTime>2020-01-20T12:00:00Z</ojp:DepArrTime>

1	<ojp:DepArrTime>2020-01-20T12:00:00Z</ojp:DepArrTime>

ojp:TimeAllowance

0:1

Invece di DepArrTime. Tempo aggiuntivo richiesto per raggiungere e lasciare il luogo.

<ojp:TimeAllowance>PT2H</ojp:TimeAllowance>

1	<ojp:TimeAllowance>PT2H</ojp:TimeAllowance>

IndividualTransportOptions

0:*

Opzioni per andare e tornare dalle fermate

Vedi tabella separata

<ojp:IndividualTransportOptions>
    <ojp:Mode>walk</ojp:Mode>
    <ojp:MaxDistance>5000</ojp:MaxDistance>
    <ojp:MaxDuration>PT1H</ojp:MaxDuration>
    <ojp:Speed>120</ojp:Speed>
</ojp:IndividualTransportOptions>

<ojp:IndividualTransportOptions>

<ojp:Mode>walk</ojp:Mode>

<ojp:MaxDistance>5000</ojp:MaxDistance>

<ojp:MaxDuration>PT1H</ojp:MaxDuration>

<ojp:Speed>120</ojp:Speed>

</ojp:IndividualTransportOptions>

IndividualTransportOptions

Elemento

Cardinalità

Descrizione

Esempio

ojp:Mode

1:1

Modalità con cui si vuole raggiungere l’Origine. Al momento è supportata solo la camminata.

Altri valori:

walk
cycle
taxi
self-drive-car
others-drive-car
motorcycle
truck

<ojp:Mode>walk</ojp:Mode>

1	<ojp:Mode>walk</ojp:Mode>

ojp:MaxDistance

0:1

Distanza massima in metri. Questo riduce al minimo i percorsi.

<ojp:MaxDistance>10000</ojp:MaxDistance>

1	<ojp:MaxDistance>10000</ojp:MaxDistance>

ojp:MaxDuration

0:1

Durata massima Controlla il router per quanto riguarda la durata massima. Il formato deve essere rispettato. È una xs:duration.

<ojp:MaxDuration>PT2H</ojp:MaxDuration>

1	<ojp:MaxDuration>PT2H</ojp:MaxDuration>

ojp:MinDistance

0:1

Distanza minima in metri. Questo riduce al minimo i percorsi.

La funzione non è supportata.

<ojp:MinDistance>1</ojp:MinDistance>

1	<ojp:MinDistance>1</ojp:MinDistance>

ojp:MinDuration

0:1

Durata minima Controlla il router per quanto riguarda la durata minima. Il formato deve essere rispettato. È una xs:duration.

La funzione non è supportata.

<ojp:MinDuration>PT1S</ojp:MinDuration>

1	<ojp:MinDuration>PT1S</ojp:MinDuration>

ojp:Speed

0:1

Velocità relativa in percentuale. La normalità è il 100%.

<ojp:Speed>100</ojp:Speed>

1	<ojp:Speed>100</ojp:Speed>

Params

Elemento

Cardinalità

Descrizione

Esempio

ojp:PtModeFilter

0:1

Il filtro specifica quali modalità devono essere prese in considerazione.

Gli elenchi di modalità e sottomodalità sono tratti da SIRI e sono elencati nell’XSD.

<ojp:PtModeFilter>
	<ojp:Exclude>true</ojp:Exclude>
	<ojp:Mode>
		<ojp:PtMode>urbanRail</ojp:PtMode>
	</ojp:Mode>
	<ojp:Mode>
		<ojp:PtMode>bus</ojp:PtMode>
		<ojp:BusSubMode>regionalBus</ojp:BusSubMode>
	</ojp:Mode>
</ojp:PtModeFilter>

<ojp:PtModeFilter>

<ojp:Exclude>true</ojp:Exclude>

<ojp:Mode>

<ojp:PtMode>urbanRail</ojp:PtMode>

</ojp:Mode>

<ojp:Mode>

<ojp:PtMode>bus</ojp:PtMode>

<ojp:BusSubMode>regionalBus</ojp:BusSubMode>

</ojp:Mode>

</ojp:PtModeFilter>

ojp:LineFilter

0:1

Linee che devono essere incluse o escluse.

<ojp:LineFilter>
    <ojp:Line>
        <LineRef>sbb:92080::R</LineRef>
    </ojp:Line>
    <ojp:Line>
        <LineRef>sbb:91012:B:H</LineRef>
    </ojp:Line>
    <ojp:Exclude>true</ojp:Exclude>
</ojp:LineFilter>

<ojp:LineFilter>

<ojp:Line>

</ojp:Line>

<ojp:Line>

</ojp:Line>

<ojp:Exclude>true</ojp:Exclude>

</ojp:LineFilter>

ojp:OperatorFilter

0:1

Operatori che devono essere inclusi o esclusi.

<ojp:OperatorFilter>
    <ojp:Exclude>false</ojp:Exclude>
    <ojp:OperatorRef>sbb:11:SchweizerischeBundesbahnenSBB</ojp:OperatorRef>
</ojp:OperatorFilter>

<ojp:OperatorFilter>

<ojp:Exclude>false</ojp:Exclude>

<ojp:OperatorRef>sbb:11:SchweizerischeBundesbahnenSBB</ojp:OperatorRef>

</ojp:OperatorFilter>

ojp:PrivateModeFilter

0:1

È opportuno utilizzare o meno le modalità private.

La funzione non è disponibile.

n/a

ojp:NoSingleStep

0:1

L’utente non può superare un passo.

La funzione non è disponibile.

n/a

ojp:NoStairs

0:1

L’utente non può utilizzare le scale.

La funzione è prevista, ma non ancora disponibile nella versione attuale (1.0).

n/a

ojp:NoEscalator

0:1

L’utente non può utilizzare una costola rotante.

La funzione è prevista, ma non ancora disponibile nella versione attuale (1.0).

n/a

ojp:NoElevator

0:1

L’utente non può utilizzare un ascensore.

La funzione è prevista, ma non ancora disponibile nella versione attuale (1.0).

n/a

ojp:NoRamp

0:1

L’utente non può utilizzare una rampa.

La funzione non è disponibile.

n/a

ojp:LevelEntrance

0:1

L’utente ha bisogno di ingressi/transizioni a livello del suolo.

La funzione è prevista, ma non ancora disponibile nella versione attuale (1.0).

n/a

ojp:BikeTransport

0:1

L’utente desidera portare con sé una bicicletta.

La funzione è prevista, ma non ancora disponibile nella versione attuale (1.0).

n/a

ojp:WalkSpeed

Deviazione dalla normale velocità di marcia. Normale 100%.

La funzione è prevista, ma non ancora disponibile nella versione attuale (1.0).

n/a

ojp:NumberOfResults

0:1

Numero di risultati.

<ojp:NumberOfResults>10</ojp:NumberOfResults>

1	<ojp:NumberOfResults>10</ojp:NumberOfResults>

ojp:NumberOfResultsBefore

0:1

Numero di risultati prima di un determinato tempo (all’arrivo o alla partenza).

Se un client OJP vuole ricevere i prossimi viaggi precedenti oltre a quelli già ricevuti, deve inviare una nuova richiesta con NumberOfResultsBefore=n e Destination.DepArrTime = la prima EndTime trovata nell’ultima risposta meno 1 minuto.

<ojp:NumberOfResultsBefore>4</ojp:NumberOfResultsBefore>

1	<ojp:NumberOfResultsBefore>4</ojp:NumberOfResultsBefore>

ojp:NumberOfResultsAfter

0:1

Numero di risultati dopo un determinato tempo (all’arrivo o alla partenza).

Se un client OJP vuole ricevere i successivi viaggi oltre a quelli già ricevuti, deve inviare una nuova richiesta con NumberOfResultsAfter=n e Origin.DepArrTime = ultimo StartTime trovato nell’ultima risposta più 1 minuto.

<ojp:NumberOfResultsAfter>6</ojp:NumberOfResultsAfter>

1	<ojp:NumberOfResultsAfter>6</ojp:NumberOfResultsAfter>

ojp:IgnoreRealtimeData

0:1

I dati in tempo reale devono essere presi in considerazione?

<ojp:IgnoreRealtimeData>true</ojp:IgnoreRealtimeData>

1	<ojp:IgnoreRealtimeData>true</ojp:IgnoreRealtimeData>

ojp:ImmediateTripStart

0:1

Si deve presumere che l’utente sia già in viaggio?

Non è supportato.

n/a

ojp:TransferLimit

0:1

Numero massimo di trasferimenti

<ojp:TransferLimit>3</ojp:TransferLimit>

1	<ojp:TransferLimit>3</ojp:TransferLimit>

ojp:OptimisationMethod

0:1

Quale metodo di ottimizzazione si deve utilizzare?

fastest (più veloce), least walking (meno a piedi), ecc.

La funzione è prevista, ma non ancora disponibile nella versione attuale (1.0).

n/a

ojp:ItModesToCover

0:*

Per ogni modalità dell’elenco, oltre ai viaggi intermodali, è necessario individuare un viaggio monomodale separato.

Nuovo supporto per la condivisione delle offerte dall’agosto 2022.

Vedere il capitolo sulla condivisione.

ojp:IncludeTrackSection

0:1

Deve contenere l’informazione TrackSection Information, che consente una proiezione geografica di una tratta. Vengono emessi TrackStart, TrackEnd e Duration.

Le informazioni devono ovviamente essere disponibili (al momento lo sono un po’ meno).

<ojp:IncludeTrackSections>true</ojp:IncludeTrackSections>

1	<ojp:IncludeTrackSections>true</ojp:IncludeTrackSections>

ojp:IncludeLegProjection

0:1

Il risultato deve contenere la presentazione geografica di una gamba. Questo dato è attualmente soppresso per le tratte del trasporto pubblico, poiché il percorso non è noto. Questo verrà fatto anche per le gambe “a piedi”.

<ojp:IncludeLegProjection>true</ojp:IncludeLegProjection>

1	<ojp:IncludeLegProjection>true</ojp:IncludeLegProjection>

ojp:IncludeTurnDescription

0:1

Una descrizione dettagliata del percorso per ogni tappa è contenuta nella PathGuidance.

<ojp:IncludeTurnDescription>true</ojp:IncludeTurnDescription>

1	<ojp:IncludeTurnDescription>true</ojp:IncludeTurnDescription>

ojp:IncludeAccessibility

0:1

È necessario inserire le informazioni di BehiG.

La funzione è prevista, ma non ancora disponibile nella versione attuale (1.0).

<ojp:IncludeAccessibility>true</ojp:IncludeAccessibility>

1	<ojp:IncludeAccessibility>true</ojp:IncludeAccessibility>

ojp:IncludeIntermediateStops

0:1

Specifica se le fermate devono essere specificate anche durante il viaggio individuale, cioè tutte le fermate intermedie.

<ojp:IncludeIntermediateStops>true</ojp:IncludeIntermediateStops>

1	<ojp:IncludeIntermediateStops>true</ojp:IncludeIntermediateStops>

ojp:IncludeFare

0:1

È necessario inserire le informazioni sui prezzi.

La funzione non è attualmente supportata.

<ojp:IncludeFare>true</ojp:IncludeFare>

1	<ojp:IncludeFare>true</ojp:IncludeFare>

ojp:Extension

0:1

Utilizzato per alcune modalità di condivisione.

Vedere il capitolo sulla condivisione.

Response

Un esempio di risposta completa: tripresponse

Innanzitutto, viene consegnato ojp:TripResponseContext. Contiene i dettagli di tutti i luoghi utilizzati (fermate, città, indirizzi, ecc.) nell’elemento ojp:Places:

<ojp:Location>
	<ojp:StopPlace>
		<ojp:StopPlaceRef>8591252</ojp:StopPlaceRef>
		<ojp:StopPlaceName>
			<ojp:Text>Zürich, Letzigrund</ojp:Text>
		</ojp:StopPlaceName>
		<ojp:TopographicPlaceRef>23026261:27</ojp:TopographicPlaceRef>
	</ojp:StopPlace>
	<ojp:LocationName>
		<ojp:Text xml:lang="de">Zürich, Letzigrund</ojp:Text>
	</ojp:LocationName>
	<ojp:GeoPosition>
		<siri:Longitude>8.50373</siri:Longitude>
		<siri:Latitude>47.38124</siri:Latitude>
	</ojp:GeoPosition>
</ojp:Location>

<ojp:Location>

<ojp:StopPlace>

<ojp:StopPlaceRef>8591252</ojp:StopPlaceRef>

<ojp:StopPlaceName>

<ojp:Text>Zürich, Letzigrund</ojp:Text>

</ojp:StopPlaceName>

<ojp:TopographicPlaceRef>23026261:27</ojp:TopographicPlaceRef>

</ojp:StopPlace>

<ojp:LocationName>

<ojp:Text xml:lang="de">Zürich, Letzigrund</ojp:Text>

</ojp:LocationName>

<ojp:GeoPosition>

<siri:Longitude>8.50373</siri:Longitude>

<siri:Latitude>47.38124</siri:Latitude>

</ojp:GeoPosition>

</ojp:Location>

In futuro, il contesto potrà includere anche le situazioni (guasti).

Segue 0:* TripResult. Dopo l’intestazione

<ojp:TripResult>
	<ojp:ResultId>ID-153A06C3-1F00-4048-9141-A217840479A6</ojp:ResultId>
	<ojp:Trip>
		<ojp:TripId>ID-153A06C3-1F00-4048-9141-A217840479A6</ojp:TripId>
		<ojp:Duration>PT29M</ojp:Duration>
		<ojp:StartTime>2020-01-20T11:57:00Z</ojp:StartTime>
		<ojp:EndTime>2020-01-20T12:26:00Z</ojp:EndTime>
		<ojp:Transfers>1</ojp:Transfers>
<!-- ... -->

<ojp:TripResult>

<ojp:ResultId>ID-153A06C3-1F00-4048-9141-A217840479A6</ojp:ResultId>

<ojp:Trip>

<ojp:TripId>ID-153A06C3-1F00-4048-9141-A217840479A6</ojp:TripId>

<ojp:Duration>PT29M</ojp:Duration>

<ojp:StartTime>2020-01-20T11:57:00Z</ojp:StartTime>

<ojp:EndTime>2020-01-20T12:26:00Z</ojp:EndTime>

<ojp:Transfers>1</ojp:Transfers>

seguiti da viaggi individuali.

Se non si è calcolato da e verso una fermata, le gambe che portano alla fermata vengono prima.

Altrimenti si utilizza un TimedLeg.

<ojp:TripLeg>
	<ojp:LegId>1</ojp:LegId>
	<ojp:TimedLeg>
		<ojp:LegBoard>
			<siri:StopPointRef>8591252</siri:StopPointRef>
				<ojp:StopPointName>
					<ojp:Text>Zürich, Letzigrund</ojp:Text>
				</ojp:StopPointName>
				<ojp:ServiceDeparture>
					<ojp:TimetabledTime>2020-01-20T11:57:00Z</ojp:TimetabledTime>
				</ojp:ServiceDeparture>
				<ojp:Order>1</ojp:Order>
		</ojp:LegBoard>
		<ojp:LegIntermediates>
			<siri:StopPointRef>8591038</siri:StopPointRef>
			<ojp:StopPointName>
				<ojp:Text>Zürich, Albisriederplatz</ojp:Text>
			</ojp:StopPointName>
			<ojp:ServiceArrival>
				<ojp:TimetabledTime>2020-01-20T11:59:00Z</ojp:TimetabledTime>
			</ojp:ServiceArrival>
			<ojp:ServiceDeparture>
				<ojp:TimetabledTime>2020-01-20T11:59:00Z</ojp:TimetabledTime>
			</ojp:ServiceDeparture>
			<ojp:Order>2</ojp:Order>
		</ojp:LegIntermediates>
<!-- weitere LegIntermediate --->
		<ojp:LegAlight>
			<siri:StopPointRef>8591105</siri:StopPointRef>
			<ojp:StopPointName>
				<ojp:Text>Zürich, Bürkliplatz</ojp:Text>
			</ojp:StopPointName>
			<ojp:ServiceArrival>
				<ojp:TimetabledTime>2020-01-20T12:13:00Z</ojp:TimetabledTime>
			</ojp:ServiceArrival>
			<ojp:Order>11</ojp:Order>
		</ojp:LegAlight>
		<ojp:Service>
			<ojp:OperatingDayRef>2020-01-20</ojp:OperatingDayRef>
			<ojp:JourneyRef>sbb:91002::H:j20:1253</ojp:JourneyRef>
			<siri:LineRef>sbb:91002:</siri:LineRef>
			<siri:DirectionRef>H</siri:DirectionRef>
			<ojp:Mode>
				<ojp:PtMode>tram</ojp:PtMode>
				<siri:TramSubmode>cityTram</siri:TramSubmode>
				<ojp:Name>
					<ojp:Text xml:lang="de">Tram</ojp:Text>
				</ojp:Name>
			</ojp:Mode>
			<ojp:PublishedLineName>
				<ojp:Text>2</ojp:Text>
			</ojp:PublishedLineName>
			<ojp:OperatorRef>sbb:3849</ojp:OperatorRef>
			<ojp:Attribute>
				<ojp:Text>
					<ojp:Text xml:lang="de">Niederflureinstieg</ojp:Text>
				</ojp:Text>
				<ojp:Code>A__NF</ojp:Code>
			</ojp:Attribute>
			<ojp:DestinationStopPointRef>de:00000:-1</ojp:DestinationStopPointRef>
			<ojp:DestinationText>
				<ojp:Text xml:lang="de">Zürich Tiefenbrunnen, Bahnhof</ojp:Text>
			</ojp:DestinationText>
		</ojp:Service>
	</ojp:TimedLeg>
</ojp:TripLeg>

<ojp:TripLeg>

<ojp:LegId>1</ojp:LegId>

<ojp:TimedLeg>

<ojp:LegBoard>

<siri:StopPointRef>8591252</siri:StopPointRef>

<ojp:StopPointName>

<ojp:Text>Zürich, Letzigrund</ojp:Text>

</ojp:StopPointName>

<ojp:ServiceDeparture>

<ojp:TimetabledTime>2020-01-20T11:57:00Z</ojp:TimetabledTime>

</ojp:ServiceDeparture>

<ojp:Order>1</ojp:Order>

</ojp:LegBoard>

<ojp:LegIntermediates>

<siri:StopPointRef>8591038</siri:StopPointRef>

<ojp:StopPointName>

<ojp:Text>Zürich, Albisriederplatz</ojp:Text>

</ojp:StopPointName>

<ojp:ServiceArrival>

<ojp:TimetabledTime>2020-01-20T11:59:00Z</ojp:TimetabledTime>

</ojp:ServiceArrival>

<ojp:ServiceDeparture>

<ojp:TimetabledTime>2020-01-20T11:59:00Z</ojp:TimetabledTime>

</ojp:ServiceDeparture>

<ojp:Order>2</ojp:Order>

</ojp:LegIntermediates>

<ojp:LegAlight>

<siri:StopPointRef>8591105</siri:StopPointRef>

<ojp:StopPointName>

<ojp:Text>Zürich, Bürkliplatz</ojp:Text>

</ojp:StopPointName>

<ojp:ServiceArrival>

<ojp:TimetabledTime>2020-01-20T12:13:00Z</ojp:TimetabledTime>

</ojp:ServiceArrival>

<ojp:Order>11</ojp:Order>

</ojp:LegAlight>

<ojp:Service>

<ojp:OperatingDayRef>2020-01-20</ojp:OperatingDayRef>

<ojp:JourneyRef>sbb:91002::H:j20:1253</ojp:JourneyRef>

<siri:LineRef>sbb:91002:</siri:LineRef>

<siri:DirectionRef>H</siri:DirectionRef>

<ojp:Mode>

<ojp:PtMode>tram</ojp:PtMode>

<siri:TramSubmode>cityTram</siri:TramSubmode>

<ojp:Name>

<ojp:Text xml:lang="de">Tram</ojp:Text>

</ojp:Name>

</ojp:Mode>

<ojp:PublishedLineName>

<ojp:Text>2</ojp:Text>

</ojp:PublishedLineName>

<ojp:OperatorRef>sbb:3849</ojp:OperatorRef>

<ojp:Attribute>

<ojp:Text>

<ojp:Text xml:lang="de">Niederflureinstieg</ojp:Text>

</ojp:Text>

<ojp:Code>A__NF</ojp:Code>

</ojp:Attribute>

<ojp:DestinationStopPointRef>de:00000:-1</ojp:DestinationStopPointRef>

<ojp:DestinationText>

<ojp:Text xml:lang="de">Zürich Tiefenbrunnen, Bahnhof</ojp:Text>

</ojp:DestinationText>

</ojp:Service>

</ojp:TimedLeg>

</ojp:TripLeg>

Osservazioni:

Purtroppo non è ancora disponibile in tempo reale. Altrimenti le informazioni pertinenti sarebbero già integrate.
L’XXXRef sarà gradualmente adattato ai nuovi identificatori svizzeri.
I DestinationStopPointRef non sono ancora ideali.
Gli attributi sono formati dagli attributi noti dell’HRDF con A__ . I nomi sono derivati dalle informazioni sul traffico. In alcuni casi, questi corrispondono anche a una combinazione di strutture SIRI. La mappatura viene effettuata in base a Notes2FacilitiesMappingFile. In OJP 1.0 non tutte sono disponibili. In questi casi, non viene eseguita alcuna mappatura.

Alcuni punti sono memorizzati in estensioni:

Nome/testo (ad es. “Treno”) Modalità di trasporto treno (categoria modalità di trasporto, scaricare da https://opentransportdata.swiss/it/dataset/verkehrsmittellisten)
Nome breve/Testo (ad es. “IC”) Sottomodalità di trasporto abbr. (descrizione breve della categoria di offerta, download da https://opentransportdata.swiss/it/dataset/verkehrsmittellisten)
Nome della linea/testo pubblicato (es. “IC8” o “S1”) testo del percorso relativo al passeggero
TimedLeg.Extension.TransportTypeName/Text (es. “InterCity”) Nome della sottomodalità di trasporto (nome della categoria di offerta, download da https://opentransportdata.swiss/it/dataset/verkehrsmittellisten)
TimedLeg.Extension.PublishedJourneyNumber/Text (es. “829”) Train number (Numero del treno)
TimedLeg.Extension.OperatorName/Text (ad es. “Ferrovie Federali Svizzere FFS”) OperatorName (Nome dell’operatore)

Le gambe di trasferimento vengono utilizzate per cambiare treno:

<ojp:TransferLeg>
	<ojp:TransferMode>walk</ojp:TransferMode>
	<ojp:LegStart>
		<siri:StopPointRef>8591105</siri:StopPointRef>
		<ojp:LocationName>
			<ojp:Text xml:lang="de">Zürich, Bürkliplatz</ojp:Text>
		</ojp:LocationName>
	</ojp:LegStart>
	<ojp:LegEnd>
		<siri:StopPointRef>8591105</siri:StopPointRef>
		<ojp:LocationName>
			<ojp:Text xml:lang="de">Zürich, Bürkliplatz</ojp:Text>
		</ojp:LocationName>
	</ojp:LegEnd>
	<ojp:TimeWindowStart>2020-01-20T12:13:00Z</ojp:TimeWindowStart>
	<ojp:TimeWindowEnd>2020-01-20T12:15:00Z</ojp:TimeWindowEnd>
	<ojp:Duration>PT2M</ojp:Duration>
	<ojp:WalkDuration>PT2M</ojp:WalkDuration>
	<ojp:BufferTime>PT0M</ojp:BufferTime>
</ojp:TransferLeg>

<ojp:TransferLeg>

<ojp:TransferMode>walk</ojp:TransferMode>

<ojp:LegStart>

<siri:StopPointRef>8591105</siri:StopPointRef>

<ojp:LocationName>

<ojp:Text xml:lang="de">Zürich, Bürkliplatz</ojp:Text>

</ojp:LocationName>

</ojp:LegStart>

<ojp:LegEnd>

<siri:StopPointRef>8591105</siri:StopPointRef>

<ojp:LocationName>

<ojp:Text xml:lang="de">Zürich, Bürkliplatz</ojp:Text>

</ojp:LocationName>

</ojp:LegEnd>

<ojp:TimeWindowStart>2020-01-20T12:13:00Z</ojp:TimeWindowStart>

<ojp:TimeWindowEnd>2020-01-20T12:15:00Z</ojp:TimeWindowEnd>

<ojp:Duration>PT2M</ojp:Duration>

<ojp:WalkDuration>PT2M</ojp:WalkDuration>

<ojp:BufferTime>PT0M</ojp:BufferTime>

</ojp:TransferLeg>

Saranno necessari miglioramenti nel contesto del BehiG, in particolare per quanto riguarda i trasferimenti.

Informazioni geografiche utilizzate

Il percorso dei sentieri si basa su OpenStreetMap (OSM). Le parti seguenti sono attualmente basate esclusivamente su OSM:

In ContinuousLeg e TransferLeg (TransferMode=walk):

TrackSection (senza coordinate, perché la LegProjection può essere configurata solo per tutti i LegType insieme a causa dei percorsi mancanti)
TurnAction (azione di svolta)
nel TimedLeg
LegIntermediate

Importante:

IncludeAccessibility è supportato solo da BehiG in poi.

I dati OSM sono disponibili secondo la licenza Open Data Commons Open Database-Lizenz (ODbL). Le applicazioni che utilizzano OSM devono specificare OSM come fonte. Il modo in cui questo può essere fatto (a seconda del tipo di applicazione) può essere trovato nelle linee guida OSM per la denominazione.

Richiesta di viaggio OJP con fornitori di condivisione

Nuovo da agosto 2022, il TripRequest OJP può essere utilizzato per calcolare le catene di viaggio con veicoli di condivisione (bicicletta, eScooter, bici a noleggio o car sharer) all’inizio e/o alla fine (primo e/o ultimo miglio).

Indicazioni generali

La funzionalità è per il momento sperimentale. Questo può comportare catene di viaggio inaspettate o poco pratiche. Il team di SKI+ sarà lieto di ricevere un feedback.

Per quanto possibile, sono stati utilizzati elementi dello standard OJP 1.0. Tuttavia, alcune estensioni hanno dovuto essere implementate utilizzando delle estensioni. Si prevedono adeguamenti in relazione alla nuova versione principale OJP 2.0.

I calcoli si basano su questa fonte di dati.

In alternativa alla TripRequest, le posizioni dei veicoli di condivisione possono ora essere richiamate tramite la OJPLocationInformationRequest.

Parametri per il controllo della richiesta di viaggio

La query nella TripRequest è controllata tramite parametri (elementi XML aggiuntivi) in quattro punti possibili:

1. spostamenti monomodali in bicicletta

Secondo lo standard OJP 1.0, <ojp:Params> è completato dall’elemento <ojp:ItModesToCover> con il valore “cycle”:

<ojp:ItModesToCover>cycle</ojp:ItModesToCover>

1	<ojp:ItModesToCover>cycle</ojp:ItModesToCover>

2. viaggi monomodali con eScooter, bici a noleggio o car sharing

<ojp:Params> è esteso con un’estensione:

<ojp:Extension> ...
  <ojp:ItModesToCover>escooter_rental</ojp:ItModesToCover> ...
</ojp:Extension>

<ojp:Extension> ...

<ojp:ItModesToCover>escooter_rental</ojp:ItModesToCover> ...

</ojp:Extension>

con “escooter_rental”, “bicycle_rental” o “car_sharing”, rispettivamente.

3. viaggi intermodali con i mezzi pubblici e con la bicicletta all’inizio e/o alla fine del viaggio

Secondo lo standard OJP 1.0, <ojp:Origin> e/o <ojp:Destination> ricevono l’elemento <ojp:IndividualTransportOptions>. Definisce la modalità (cycle), la durata min./max. in minuti e la distanza min./max. in metri, come mostrato nell’esempio seguente.

<ojp:IndividualTransportOptions>
  <ojp:Mode>cycle</ojp:Mode> <!--Fahrrad am Anfang -->
  <ojp:MaxDuration>PT30M</ojp:MaxDuration> <!--Optional: maximale Dauer -->
  <ojp:MinDuration>PT2M</ojp:MinDuration> <!--Optional: minimale Dauer -->
  <ojp:MaxDistance>20000</ojp:MaxDistance> <!--Optional: maximale Fahrdistanz -->
  <ojp:MinDistance>100</ojp:MinDistance> <!--Optional: minimale Fahrdistanz -->
</ojp:IndividualTransportOptions>

<ojp:IndividualTransportOptions>

<ojp:Mode>cycle</ojp:Mode>

<ojp:MaxDuration>PT30M</ojp:MaxDuration>

<ojp:MinDuration>PT2M</ojp:MinDuration>

<ojp:MaxDistance>20000</ojp:MaxDistance>

<ojp:MinDistance>100</ojp:MinDistance>

</ojp:IndividualTransportOptions>

4. viaggi intermodali con i mezzi pubblici e con un eScooter, una bicicletta a noleggio o un car sharing all’inizio e/o alla fine del viaggio

<ojp:Params> è esteso con un’estensione, con analoghi <ojp:Origin> e/o <ojp:Destination> e con modalità escooter_rental, bicycle_rental o car_sharing, rispettivamente, come mostrato nell’esempio seguente:

<ojp:Extension>
  <ojp:Origin>
    <ojp:Mode>escooter_rental</ojp:Mode> <!--eScooter zu Beginn-->
    <ojp:MaxDuration>PT30M</ojp:MaxDuration> <!--Optional: maximale Dauer-->
    <ojp:MinDuration>PT2M</ojp:MinDuration> <!--Optional: minimale Dauer-->
    <ojp:MaxDistance>20000</ojp:MaxDistance> <!--Optional: maximale Fahrdistanz-->
    <ojp:MinDistance>100</ojp:MinDistance> <!--Optional: minimale Fahrdistanz-->
  </ojp:Origin>
</ojp:Extension>

<ojp:Extension>

<ojp:Origin>

<ojp:Mode>escooter_rental</ojp:Mode>

<ojp:MaxDuration>PT30M</ojp:MaxDuration>

<ojp:MinDuration>PT2M</ojp:MinDuration>

<ojp:MaxDistance>20000</ojp:MaxDistance>

<ojp:MinDistance>100</ojp:MinDistance>

</ojp:Origin>

</ojp:Extension>

Panoramica delle combinazioni possibili

La tabella seguente mostra quali combinazioni hanno senso per i viaggi monomodali e multimodali. (Nota: il trasporto pubblico viene qui considerato come un’unica modalità, anche se prevede diversi mezzi di trasporto e trasferimenti):

Combinazione	Viaggio monomodale	Modalità multimodale — modo all’inizio	Modalità multimodale — modo alla fine	Modo all’inizio & alla fine
*trasporti pubblici*	default	—	—	—
*a piedi*	ItModesToCover=walk oder IndividualTransportOptions=walk (Wanderungen, s. oben)	default	default	default
*con la propria bicicletta*	ItModesToCover= cycle	IndividualTransportOptions … Mode=cycle	—	—
*con la propria auto*	ItModesToCover= self-drive-car	—	—	—
*Bike Sharing*	Ext./ItModesToCover= bicycle_rental	Ext./Origin/Mode= bicycle_rental	Ext./Destin./Mode= bicycle_rental	possibile se Origine e Destino. Modalità uguali
*e-Scooter Sharing*	Ext./ItModesToCover= escooter_rental	Ext./Origin/Mode= escooter_rental	Ext./Destin./Mode= escooter_rental	possibile se Origine e Destino. Modalità uguali
*Car Sharing*	Ext./ItModesToCover= car_sharing	—	Ext./Destin./Mode= car_sharing	—

Ricerca di treni in galleria per auto

Esempio di richiesta di un treno in galleria per auto (ATZ):

<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-03-21T16:22:30.112Z</siri:RequestTimestamp>
      <siri:RequestorRef>OJP_JS_SDK_v0.9.31</siri:RequestorRef>
      <OJPTripRequest>
        <siri:RequestTimestamp>2024-03-21T16:22:30.112Z</siri:RequestTimestamp>
        <Origin>
          <PlaceRef>
            <StopPlaceRef>8511171</StopPlaceRef>
            <LocationName>
              <Text>Kandersteg Autoverlad</Text>
            </LocationName>
          </PlaceRef>
        </Origin>
        <Destination>
          <PlaceRef>
            <StopPlaceRef>8519655</StopPlaceRef>
            <LocationName>
              <Text>Goppenstein Autoverlad</Text>
            </LocationName>
          </PlaceRef>
        </Destination>
      <ojp:Params>
            <ojp:PrivateModeFilter>
                  <ojp:Exclude>false</ojp:Exclude>
            </ojp:PrivateModeFilter>
            <ojp:NumberOfResults>3</ojp:NumberOfResults>
      <ojp:IncludeTrackSections>false</ojp:IncludeTrackSections>
      <ojp:IncludeLegProjection>false</ojp:IncludeLegProjection>
      <ojp:IncludeTurnDescription>false</ojp:IncludeTurnDescription>
      <ojp:IncludeIntermediateStops>true</ojp:IncludeIntermediateStops>
      </ojp:Params>
      </OJPTripRequest>
    </siri:ServiceRequest>
  </siri:OJPRequest>
</siri:OJP>

<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-03-21T16:22:30.112Z</siri:RequestTimestamp>

<siri:RequestorRef>OJP_JS_SDK_v0.9.31</siri:RequestorRef>

<siri:RequestTimestamp>2024-03-21T16:22:30.112Z</siri:RequestTimestamp>

<Text>Kandersteg Autoverlad</Text>

</LocationName>

</PlaceRef>

</Origin>

<Text>Goppenstein Autoverlad</Text>

</LocationName>

</PlaceRef>

</Destination>

<ojp:Params>

<ojp:PrivateModeFilter>

<ojp:Exclude>false</ojp:Exclude>

</ojp:PrivateModeFilter>

<ojp:NumberOfResults>3</ojp:NumberOfResults>

<ojp:IncludeTrackSections>false</ojp:IncludeTrackSections>

<ojp:IncludeLegProjection>false</ojp:IncludeLegProjection>

<ojp:IncludeTurnDescription>false</ojp:IncludeTurnDescription>

<ojp:IncludeIntermediateStops>true</ojp:IncludeIntermediateStops>

</ojp:Params>

</OJPTripRequest>

</siri:ServiceRequest>

</siri:OJPRequest>

</siri:OJP>