Ottieni un percorso con il trasporto pubblico

Sviluppatori dello Spazio economico europeo (SEE)

Un itinerario del trasporto pubblico fornisce indicazioni di navigazione utilizzando le opzioni di trasporto pubblico disponibili nella regione. Le opzioni di trasporto pubblico possono includere autobus, metropolitane e treni, tra gli altri. Un itinerario del trasporto pubblico di solito include anche le indicazioni per raggiungere a piedi le stazioni del trasporto pubblico, per spostarsi da una stazione all'altra e per allontanarsi dalla stazione. Poiché un itinerario del trasporto pubblico in genere richiede di viaggiare utilizzando più di un mezzo di trasporto, il modo in cui richiedi l'itinerario e alcune parti della risposta sono diversi.

Differenze tra gli itinerari del trasporto pubblico e gli altri itinerari

I percorsi del trasporto pubblico, che richiedi impostando un travelMode di TRANSIT, sono diversi dai percorsi che utilizzano diverse opzioni di modalità di viaggio. Non puoi richiedere tutti gli stessi oggetti e opzioni e la risposta restituisce campi diversi rispetto ad altri percorsi.

Nell'API Routes, i passaggi sono sempre un'istruzione di navigazione per tutti i tipi di viaggio. Quindi, ogni istruzione di navigazione è un passaggio. Una risposta di itinerario del trasporto pubblico è molto simile agli itinerari con altre modalità di trasporto, con alcune differenze fondamentali:

Richiedi differenze Differenze nelle risposte
Non puoi specificare waypoint intermedi. Include i dettagli del trasporto pubblico.
Impossibile ottenere percorsi ecosostenibili Include i metadati per ogni modalità di viaggio che contiene il riepilogo dei passaggi per quella modalità di viaggio, in stepsOverview (per richiedere questi metadati, utilizza la maschera di campo stepsOverview).
Non è possibile specificare come e se includere i dati sul traffico
Impossibile specificare le caratteristiche del percorso da evitare
Può specificare solo transitPreferences. Per maggiori dettagli, vedi TransitPreference.

Per ottenere un itinerario con i mezzi pubblici

  1. Imposta l'origine e la destinazione.
  2. Imposta travelMode su TRANSIT.
  3. Aggiungi le maschere di campo appropriate per ottenere la risposta che ti serve. Consulta Richiedere i campi dell'itinerario del trasporto pubblico di cui hai bisogno.
  4. Se necessario, imposta i parametri facoltativi. Consulta Impostare i parametri per un itinerario del trasporto pubblico

Richiedi i campi dell'itinerario del trasporto pubblico di cui hai bisogno

Richiedi i campi dell'itinerario del trasporto pubblico di cui hai bisogno utilizzando le maschere di campo. La tabella seguente contiene alcune risposte suggerite per un itinerario del trasporto pubblico e la maschera del campo da utilizzare per richiederle.

Per richiedere queste informazioni Utilizza questa maschera di campo
Tutti i dettagli dell'itinerario. *
Dettagli del trasporto pubblico per le tratte del percorso. legs
Tariffa stimata per ogni tappa del percorso e tariffa stimata localizzata. travelAdvisory
Testo localizzato per durata e distanza localizedValues

Imposta i parametri per un percorso di transito

Di seguito sono riportati i parametri pertinenti per i percorsi dei mezzi pubblici:

Per fare questo Utilizza questo parametro Note
Seleziona la modalità di transito travelMode: "TRANSIT" Obbligatorio. Ulteriori informazioni.
Impostare un orario di arrivo o partenza arrivalTime: new Date(yyyy-mm-ddThh:mm:ssZ)

OPPURE

departureTime: new Date(yyyy-mm-ddThh:mm:ssZ)		 Facoltativo. Puoi specificare l'ora di arrivo o di partenza. Se non viene specificato alcun orario, departureTime corrisponde all'ora di esecuzione corrente (now). Puoi impostare gli orari di arrivo e partenza solo all'interno della seguente finestra temporale, con l'ora di esecuzione corrente (now) come riferimento:
  • fino a 7 giorni prima del giorno now incluso
  • fino a 100 giorni dopo now inclusi
L'ora è espressa come oggetto Date.

Nota: gli orari del trasporto pubblico cambiano spesso, i viaggi disponibili possono cambiare nel tempo e non è garantita la coerenza dei risultati per le previsioni a lungo termine.
Includi percorsi alternativi computeAlternativeRoutes: true Facoltativo. Imposta su true per consentire a computeRoutes di calcolare fino a 3 itinerari aggiuntivi, se disponibili. Scopri di più
Specificare le preferenze per il tipo di trasporto pubblico transitPreference: {allowedTransitModes: ["BUS", "SUBWAY", "TRAIN", "LIGHT_RAIL", "RAIL"]}

Nota: se specifichi una modalità di viaggio preferita, gli itinerari restituiti potrebbero comunque utilizzare altre modalità di trasporto pubblico, anche solo altre modalità di trasporto pubblico, a seconda dell'efficienza dell'itinerario e della disponibilità della modalità di viaggio preferita.

 Facoltativo. Specifica le modalità di trasporto pubblico preferite. Scopri di più
Specificare le preferenze per l'itinerario del trasporto pubblico transitPreference: {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} Facoltativo. Specifica le preferenze di routing del trasporto pubblico. Scopri di più

Esempio di richiesta

L'esempio seguente mostra come richiedere un itinerario del trasporto pubblico:

const request = {
  origin: 'Hunters Point San Francisco, CA 94124',
  destination: '201 Marine Dr, San Francisco, CA 94129',
  travelMode: 'TRANSIT',
  departureTime: new Date(),
  transitPreference: {
    allowedTransitModes: ['BUS', 'SUBWAY', 'TRAIN', 'LIGHT_RAIL', 'RAIL'],
    routingPreference: 'FEWER_TRANSFERS', // Alternatively, 'LESS_WALKING'.
  },
  fields: ['path', 'legs', 'travelAdvisory', 'localizedValues'],
};