OJPTripRequest

#AutoTranslate

Descrizione breve

TripRequest è il servizio centrale. Viene pianificato un viaggio con l’indicazione del luogo di origine e della destinazione.

Un viaggio ha diverse «gambe» (sezioni).

Descrizione del funzionamento

La modellazione di un viaggio comprende i seguenti elementi:

Fermate: A tale scopo sono disponibili anche i record di dati Posti di servizio.
Corse: Una corsa è il trasporto dei clienti su un determinato percorso, un determinato collegamento orario, con un determinato mezzo di trasporto (veicolo), a una determinata ora, in una determinata direzione.
Orario: Un orario stabilisce il percorso di un mezzo di trasporto nel traffico pubblico locale e a lunga percorrenza di viaggiatori e nel traffico merci su rotaia. I dati necessari sono il numero del treno, i giorni di circolazione, l’itinerario, gli orari di arrivo, di partenza e di transito alle fermate e le velocità ammesse nelle singole sezioni dell’itinerario.
Previsione: Le previsioni sono gli orari di circolazione futuri di una corsa, che vengono calcolati in base alla posizione attuale del veicolo. Le previsioni vengono calcolate nel prossimo futuro per mezzo di algoritmi consolidati che tengono conto di numerosi fattori. Nel prosieguo della previsione i fattori saranno considerati in misura minore.

Descrizione tecnica

API Explorer

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

Richiesta

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

Elemento	Cardinalità	Descrizione	Esempio
`RequestTimestamp`	1:1	Il Timestamp della richiesta nel formato ISO 8601. Preferito come Zulu Time.	<RequestTimestamp>2020-01-31T12:30:00Z</RequestTimestamp>
`MessageIdentifier`	0:1	Il Identifier il messaggio. Preferibilmente in modo rigorosamente monotono crescente.	<MessageIdentifier>756</MessageIdentifier>
`ojp:Origin`	1:*	Il punto di partenza della richiesta di viaggio. OJP offre diverse opzioni per descrivere questo elemento. 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:Destination`	1:*	Scopo della richiesta di viaggio. OJP offre diverse opzioni per descrivere questo elemento. 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:Via`	0:1	È supportata solo una via. Se occorre considerare più Via o calcolare una corsa circolare, la richiesta deve essere suddivisa per la richiesta in più viaggi.	<ojp:Via> <ojp:ViaPoint> <StopPointRef>8506000</StopPointRef> <ojp:LocationName> <ojp:Text>Winterthur</ojp:Text> </ojp:LocationName> </ojp:ViaPoint> </ojp:Via>
`ojp:Params`	0:1	Gli altri parametri. Si veda il relativo paragrafo.	<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 Origine/destinazione

Elementi	Cardinalità	Descrizione	Esempio
`ojp:PlaceRef/siri:StopPointRef`	0:1	Rimando allo StopPoint. Attenzione: possono essere utilizzati sia DiDok che sloid. Di più Informazioni.	<ojp:PlaceRef> <StopPointRef>8530813</StopPointRef> <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: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:TopographicPlaceRef`	0:1	Rimando a un «luogo. Difficile perché 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:PointOfInterestRef`	0:1	Riferimento a un punto di interesse. Il nome della location viene ignorato.	<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:LocationName`	1:1	Nome pubblico del luogo Attenzione: il nome viene ignorato. Si deve prima eseguire una LocationRequest, che poi fornirà un Ref o una coordinata!	<ojp:PlaceRef> <StopPointRef>8503003</StopPointRef> <ojp:LocationName> <ojp:Text>Zürich Stadelhofen</ojp:Text> </ojp:LocationName> </ojp:PlaceRef>
`ojp:DepArrTime`	0:1	Tempo che deve essere utilizzato. «Z» è l’orario Zulu (indipendente dal fuso orario). Per la Z devono essere assolutamente indicati anche i secondi. Se il formato non è corretto o se non è presente alcuna Z, il sistema cerca di interpretare l’orario come orario locale.	<ojp:DepArrTime>2020-01-20T12:00:00Z</ojp:DepArrTime>
`ojp:TimeAllowance`	0:1	Anziché «DepArrTime». Tempo supplementare necessario per raggiungere e lasciare la location.	<ojp:TimeAllowance>PT2H</ojp:TimeAllowance>
`IndividualTransportOptions`	0:*	Opzioni per il tragitto da e per le fermate Vedere 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>

IndividualTransportOptions

Elementi	Cardinalità	Descrizione	Esempio
`ojp:Mode`	1:1	Modalità per raggiungere Origin. Al momento è supportato solo walk. Valori altrimenti: walk ciclo taxi auto a guida autonoma veicoli-altre-drive motocicletta autocarro	<ojp:Mode>walk</ojp:Mode>
`ojp:MaxDistance`	0:1	Distanza massima in metri. In questo modo gli itinerari vengono ridotti al minimo.	<ojp:MaxDistance>10000</ojp:MaxDistance>
`ojp:MaxDuration`	0:1	Durata massima. Controlla il router per quanto riguarda la durata massima. Prestare attenzione al formato. Si tratta di una xs:duration.	<ojp:MaxDuration>PT2H</ojp:MaxDuration>
`ojp:MinDistance`	0:1	Distanza minima in metri. In questo modo gli itinerari vengono ridotti al minimo. Questa feature non è supportata.	<ojp:MinDistance>1</ojp:MinDistance>
`ojp:MinDuration`	0:1	Durata minima. Controlla il router rispetto alla durata minima. Prestare attenzione al formato. Si tratta di una xs:duration. Questa feature non è supportata.	<ojp:MinDuration>PT1S</ojp:MinDuration>
`ojp:Speed`	0:1	Velocità relativa in percentuale. Normale è 100%.	<ojp:Speed>100</ojp:Speed>

Parametri

Elementi	Cardinalità	Descrizione	Esempio
`ojp:PtModeFilter`	0:1	Il filtro indica quali modalità devono essere prese in considerazione. Gli elenchi delle modalità sono riportati in XSD. Il filtraggio sulle modalità sub non ha alcun effetto.	<ojp:PtModeFilter> <ojp:Exclude>true</ojp:Exclude> <ojp:PtMode>rail</ojp:PtMode> </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:OperatorFilter`	0:1	Operatori da includere o escludere.	<ojp:OperatorFilter> <ojp:Exclude>false</ojp:Exclude> <ojp:OperatorRef>sbb:11:SchweizerischeBundesbahnenSBB</ojp:OperatorRef> </ojp:OperatorFilter>
`ojp:PrivateModeFilter`	0:1	Utilizzare o meno modalità private. La funzione non è disponibile.	n.d.
`ojp:NoSingleStep`	0:1	L’utente non può superare un paragrafo. La funzione non è disponibile.	n.d.
`ojp:NoStairs`	0:1	L’utente non può utilizzare le scale. La funzione non è disponibile.	n.d.
`ojp:NoEscalator`	0:1	L’utente non può utilizzare la scala mobile. La funzione non è disponibile.	n.d.
`ojp:NoElevator`	0:1	L’utente non può utilizzare l’ascensore. La funzione non è disponibile.	n.d.
`ojp:NoRamp`	0:1	L’utente non può utilizzare le rampe La funzione non è disponibile.	n.d.
`ojp:LevelEntrance`	0:1	L’utente necessita di ingressi/transizioni a livello del suolo La funzione non è disponibile.	n.d.
`ojp:BikeTransport`	0:1	L’utente vuole portare con sé una bicicletta La funzione non è disponibile.	n.d.
`ojp:WalkSpeed`	0:	Scostamento rispetto alla velocità di corsa normale. Normale al 100%. La funzione non è disponibile.	n.d.
`ojp:NumberOfResults`	0:1	Se i risultati vengono ponderati allo stesso modo dall’algoritmo di ricerca, vengono restituiti più risultati. Se non si riesce a trovare il numero di collegamenti desiderato, vengono restituiti meno risultati. Altrimenti viene restituito il numero di risultati desiderato.	<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 prima corse in partenza già ricevute, deve inviare una nuova request con NumberOfResultsBefore=n e Destination.DepArrTime = prima ora di fine trovata nell’ultima risposta meno 1 minuto.	<ojp:NumberOfResultsBefore>4</ojp:NumberOfResultsBefore>
`ojp:NumberOfResultsAfter`	0:1	Numero di risultati in un determinato tempo (all’arrivo o alla partenza). Se un client OJP vuole ricevere successivamente le corse già ricevute, deve inviare una nuova request con NumberOfResultsAfter=n e Origin.DepArrTime = ultima ora di inizio trovata nell’ultima risposta più 1 minuto.	<ojp:NumberOfResultsAfter>6</ojp:NumberOfResultsAfter>
`ojp:IgnoreRealtimeData`	0:1	Devono essere considerati anche i dati in tempo reale?	<ojp:IgnoreRealtimeData>true</ojp:IgnoreRealtimeData>
`ojp:ImmediateTripStart`	0:1	Si deve presumere che l’utente sia già in viaggio? Non supportato.	n.d.
`ojp:TransferLimit`	0:1	Numero massimo di cambi	<ojp:TransferLimit>3</ojp:TransferLimit>
`ojp:OptimisationMethod`	0:1	Quale metodo di ottimizzazione deve essere utilizzato? fastest, least walking ecc. La funzione non è disponibile.	n.d.
`ojp:ItModesToCover`	0:*	Per ogni modalità dell’elenco occorre trovare un viaggio monomodale separato in aggiunta ai viaggi intermodali. Supportato da agosto 2022 per le offerte di mobilità condivisa.	V. il capitolo sulla condivisione sottostante.
`ojp:IncludeTrackSection`	0:1	Se il risultato deve contenere elementi TrackSection per descrivere l’andamento geografico di questa corsa del veicolo.	<ojp:IncludeTrackSections>true</ojp:IncludeTrackSections>
`ojp:IncludeLegProjection`	0:1	Il risultato deve includere la presentazione geografica di una gamba.	<ojp:IncludeLegProjection>true</ojp:IncludeLegProjection>
`ojp:IncludeTurnDescription`	0:1	Una descrizione dettagliata del percorso per ogni tappa è fornita nella PathGuidance.	<ojp:IncludeTurnDescription>true</ojp:IncludeTurnDescription>
`ojp:IncludeAccessibility`	0:1	Devono essere aggiunte informazioni LDis.	<ojp:IncludeAccessibility>true</ojp:IncludeAccessibility>
`ojp:IncludeIntermediateStops`	0:1	Indica se le fermate devono essere indicate anche per la singola corsa. Si tratta quindi di tutte le fermate intermedie.	<ojp:IncludeIntermediateStops>true</ojp:IncludeIntermediateStops>
`ojp:IncludeFare`	0:1	Occorre inserire informazioni di prezzo. Questa funzionalità non è attualmente supportata.	<ojp:IncludeFare>true</ojp:IncludeFare>
`ojp:Extension`	0:1	Utilizzato per determinate modalità di condivisione.	V. il capitolo sulla condivisione sottostante.

Risposta

Un esempio di risposta completa: tripresponse

Per prima cosa viene fornito ojp:TripResponseContext. Esso contiene informazioni su tutti i luoghi utilizzati (fermate, località, 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>

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

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

seguono singoli viaggi.

Se non è stato instradato da e verso una fermata, vengono prima le continue leg che conducono alla fermata.

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

Osservazioni:

Tutti i XXXRef vengono progressivamente aggiornati con nuovi identificatori svizzeri stabili SID 4 PT.
Gli attributi derivano dagli attributi noti da HRDF con A__ . I nomi derivano dagli Indicazioni sul traffico derivate. In alcuni casi corrispondono anche a una combinazione di SIRI Facilities. La mappatura avviene secondo il Notes2FacilitiesMappingFile in OJP 1.0 non sono tutti presenti. In questi casi non viene effettuata alcuna mappatura.

Alcuni punti sono realizzati tramite estensioni:

Name per il (ad es. «treno») Transport Mode (categoria di mezzo di trasporto, download from https://data.opentransportdata.swiss/dataset/vm-liste)
ShortName (ad es. «IC») Trasporto submode Abbreviazione (categoria di offerta-denominazione abbreviata, download in https://data.opentransportdata.swiss/dataset/vm-liste)
PublishedLineName (ad es. «IC8» o «S1») testo della tratta rilevante per il passeggero
TimedLeg.Extension.TransportTypeName (ad es. «InterCity») Trasporto submode name (nome della categoria di offerta, download alla voce https://data.opentransportdata.swiss/dataset/vm-liste)
TimedLeg.Extension.PublishedJourneyNumber (ad es. «829») Numero del treno
TimedLeg.Extension.OperatorName (ad es. «Ferrovie federali svizzere FFS») OperatorName

Quando si cambia treno TransferLegs utilizzato:

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

Miglioramenti saranno necessari nel contesto della LDis soprattutto per i trasferimenti.

Informazioni geografiche utilizzate

Il percorso a piedi si basa su Open Street Map (OSM). Le seguenti parti sono attualmente basate esclusivamente su OSM:

Nel ContinuousLeg e TransferLeg (TransferMode=walk):

TrackSection
TurnAction
nel TimedLeg
LegIntermediates
IncludeAccessibility

I dati OSM sono disponibili all’indirizzo Open Data Commons Licenza Open Database (ODbL). Le applicazioni che utilizzano OSM devono indicare OSM come fonte. Le modalità di utilizzo sono illustrate nella seguente direttiva Linee guida OSM per l’attribuzione dei nomi.

OJP Trip Request con operatori di sharing

Da agosto 2022, con la TripRequest OJP è possibile calcolare catene di viaggio con veicoli in condivisione (bicicletta, monopattini elettrici, bici a noleggio o car sharing) all’inizio e/o alla fine (primo e/o ultimo miglio).

Indicazioni generali

La funzionalità ha carattere inizialmente sperimentale. Possono risultare catene di viaggio inattese o poco praticabili. Il team SKI+ è lieto di ricevere feedback in proposito.

Dove possibile, sono stati utilizzati elementi dello standard OJP 1.0. Tuttavia, è stato necessario implementare alcuni ampliamenti mediante estensioni. Con l’introduzione del protocollo OJP 2.0, la multimodalità e l’intermodalità vengono implementate secondo la definizione nello standard.

I calcoli si basano su questa Fonte dei dati.

Le sedi dei veicoli in condivisione possono essere consultate anche con il seguente servizio: OJPLocationInformation Request

Parametri per la gestione della TripRequest

La richiesta in TripRequest è controllata per mezzo di parametri (elementi XML supplementari) in quattro possibili punti:

1. Viaggiare monomodale con la bicicletta

Conformemente a Standard OJP 1.0 a tale scopo <ojp:Params> viene integrato con l’elemento <ojp:ItModesToCover> e il valore «cycle» (ciclo):

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

2. Viaggiare in monomodale con monopattini elettrici, biciclette a noleggio o carsharing

<ojp:Params> viene visualizzato con una Estensione ampliato:

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

con «escooter_rental», «bicycle_rental» o «car_sharing».

3. Viaggi intermodali con i trasporti pubblici e con una bicicletta all’inizio e/o alla fine

Conformemente a Standard OJP 1.0 <ojp:Origin> e/o <ojp:Destination> ricevono l’elemento <ojp:IndividualTransportOptions>. Esso definisce la modalità (cycle), la durata minima/massima in minuti e la distanza minima/massima in metri, come illustrato 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>

4. Viaggiare intermodali con i trasporti pubblici e con un monopattino elettrico, una bicicletta a noleggio o il carsharing all’inizio e/o alla fine

<ojp:Params> viene visualizzato con una Estensione ampliate, per analogia con <ojp:Origin> e/o <ojp:Destination> e con la modalità escooter_rental, bicycle_rental o car_sharing, oppure, come illustrato 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>

Panoramica delle possibili combinazioni

La tabella seguente mostra quali combinazioni sono raccomandabili per i viaggi monomodali e multimodali. (Attenzione: il trasporto pubblico è considerato come una modalità, anche se collegato a diversi mezzi di trasporto e cambi):

Combinazione	Viaggio monomodale	Multimodale — Modalità all’inizio	Multimodale — Modalità alla fine	Modalità Inizio e 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 auto privata*	`ItModesToCover= self-drive-car`	—	—	—
*Bicicletta Sharing*	`Ext./ItModesToCover= bicycle_rental`	`Ext./Origin/Mode= bicycle_rental`	`Ext./Destin./Mode= bicycle_rental`	possibile se Origin e Destin. Modalità uguali
*e-Scooter Sharing*	`Ext./ItModesToCover= escooter_rental`	`Ext./Origin/Mode= escooter_rental`	`Ext./Destin./Mode= escooter_rental`	possibile se Origin e Destin. Modalità uguali
*Car Sharing*	`Ext./ItModesToCover= car_sharing`	—	`Ext./Destin./Mode= car_sharing`	—

Cerca treni auto in galleria

Esempio di richiesta per un treno auto in galleria (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>

Indice della materia

Ricerca nella pagina