Directions

Classe DirectionsService

lezione google.maps.DirectionsService

Un servizio per il calcolo di indicazioni stradali tra due o più luoghi.

Quando usi v=beta, puoi accedervi chiamando const {DirectionsService} = await google.map.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

DirectionsService
DirectionsService()
Parametri: nessuno
Crea una nuova istanza di DirectionsService che invia query di indicazioni stradali ai server di Google.
route
route(request[, callback])
Parametri:
Valore restituito: Promise<DirectionsResult>
Invia una richiesta di ricerca delle indicazioni stradali.

Interfaccia di DirectionsRequest

google.maps.DirectionsRequest interfaccia

Una query di indicazioni stradali da inviare a DirectionsService.

destination
Località di destinazione. Può essere specificato come stringa da geocodificare, LatLng o Place. Obbligatorio.
origin
Località di origine. Può essere specificato come stringa da geocodificare, LatLng o Place. Obbligatorio.
travelMode
Tipo di routing richiesto. Obbligatorio.
avoidFerries optional
Tipo: boolean optional
Se true, indica al servizio Directions di evitare i traghetti, ove possibile. (Facoltativo)
avoidHighways optional
Tipo: boolean optional
Se true, indica al servizio Directions di evitare le autostrade, se possibile. (Facoltativo)
avoidTolls optional
Tipo: boolean optional
Se true, indica al servizio Indicazioni stradali di evitare strade a pedaggio, se possibile. (Facoltativo)
drivingOptions optional
Tipo: DrivingOptions optional
Impostazioni che si applicano solo alle richieste in cui travelMode è DRIVING. Questo oggetto non avrà effetto per le altre modalità di viaggio.
language optional
Tipo: string optional
L'identificatore della lingua della lingua in cui devono essere restituiti i risultati, se possibile. Consulta l'elenco delle lingue supportate.
optimizeWaypoints optional
Tipo: boolean optional
Se impostato su true, DirectionsService proverà a riordinare i punti intermedi intermedi forniti per ridurre al minimo il costo complessivo del percorso. Se i Waypoint sono ottimizzati, esamina DirectionsRoute.waypoint_order nella risposta per determinare il nuovo ordine.
provideRouteAlternatives optional
Tipo: boolean optional
Indica se devono essere fornite o meno alternative. (Facoltativo)
region optional
Tipo: string optional
Codice regione utilizzato come bias per le richieste di geocodifica. Il codice regione accetta un valore di due caratteri ccTLD ("primo livello dominio"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune notevoli eccezioni. Ad esempio, il ccTLD del Regno Unito è "uk" (.co.uk) mentre il codice ISO 3166-1 è "gb" (tecnicamente per l'entità del "Regno Unito di Gran Bretagna e Irlanda del Nord").
transitOptions optional
Tipo: TransitOptions optional
Impostazioni che si applicano solo alle richieste in cui travelMode è TRANSIT. Questo oggetto non avrà effetto per le altre modalità di viaggio.
unitSystem optional
Tipo: UnitSystem optional
Predefinito: il sistema di unità utilizzato nel paese di origine.
Sistema di unità preferito da usare per la visualizzazione della distanza.
waypoints optional
Tipo: Array<DirectionsWaypoint> optional
Array di tappe intermedie. Le indicazioni stradali vengono calcolate dall'origine alla destinazione in base a ciascun punto di via in questo array. Per il numero massimo di tappe consentiti, consulta la guida per gli sviluppatori. I Waypoint non sono supportati per le indicazioni stradali di trasporto pubblico. (Facoltativo)

Costanti di DirectionsStatus

google.maps.DirectionsStatus costanti

Lo stato restituito da DirectionsService al termine di una chiamata al numero route(). Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'OK' o google.maps.DirectionsStatus.OK.

Quando usi v=beta, puoi accedervi chiamando const {DirectionsStatus} = await google.map.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

INVALID_REQUEST Il campo DirectionsRequest fornito non era valido.
MAX_WAYPOINTS_EXCEEDED Sono stati forniti troppi DirectionsWaypoint nella DirectionsRequest. Per il numero massimo di tappe consentiti, consulta la guida per gli sviluppatori.
NOT_FOUND Non è stato possibile geocodificare almeno uno dei punti di origine, di destinazione o di tappe.
OK La risposta contiene un elemento DirectionsResult valido.
OVER_QUERY_LIMIT La pagina web ha superato il limite di richieste in un periodo di tempo troppo breve.
REQUEST_DENIED La pagina web non è autorizzata a utilizzare il servizio indicazioni stradali.
UNKNOWN_ERROR Impossibile elaborare una richiesta di indicazioni stradali a causa di un errore del server. Se riprovi, la richiesta potrebbe avere esito positivo.
ZERO_RESULTS Nessun percorso trovato tra l'origine e la destinazione.

Interfaccia DirectionsResult

google.maps.DirectionsResult interfaccia

La risposta delle indicazioni stradali recuperata dal server delle indicazioni stradali. Puoi eseguire il rendering utilizzando un DirectionsRenderer o analizzare questo oggetto ed eseguirne il rendering. Devi mostrare gli avvisi e il copyright come specificato nei Termini di servizio di Google Maps Platform. Tieni presente che, sebbene questo risultato sia "simile a JSON", non è strettamente JSON, poiché include indirettamente LatLng oggetti.

routes
Un array di DirectionsRoute, ognuno dei quali contiene informazioni sulle gambe e sui passaggi che lo compongono. Sarà presente un solo percorso a meno che DirectionsRequest non sia stato impostato con provideRouteAlternatives impostato su true.
available_travel_modes optional
Tipo: Array<TravelMode> optional
Contiene una serie di modalità di viaggio disponibili. Questo campo viene restituito quando una richiesta specifica una modalità di viaggio e non restituisce risultati. L'array contiene le modalità di viaggio disponibili nei paesi di un determinato insieme di tappe. Questo campo non viene restituito se uno o più tappe sono "tramite Waypoint".
geocoded_waypoints optional
Un array di DirectionsGeocodedWaypoint, ognuno dei quali contiene informazioni sulla geocodifica di origine, destinazione e tappe.

Classe DirectionsRenderer

lezione google.maps.DirectionsRenderer

Visualizza le indicazioni stradali ottenute da DirectionsService.

Questo corso estende MVCObject.

Quando usi v=beta, puoi accedervi chiamando const {DirectionsRenderer} = await google.map.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

DirectionsRenderer
DirectionsRenderer([opts])
Parametri:
Crea il renderer con le opzioni specificate. Le indicazioni stradali possono essere visualizzate su una mappa (come overlay visivi) o anche su un riquadro <div> (come istruzioni testuali).
getDirections
getDirections()
Parametri: nessuno
Valore restituito: DirectionsResult
Restituisce l'insieme di indicazioni stradali attuali del renderer.
getMap
getMap()
Parametri: nessuno
Valore restituito: Map
Restituisce la mappa su cui viene eseguito il rendering di DirectionsResult.
getPanel
getPanel()
Parametri: nessuno
Valore restituito: HTMLElement|null
Restituisce il riquadro <div> in cui viene eseguito il rendering di DirectionsResult.
getRouteIndex
getRouteIndex()
Parametri: nessuno
Valore restituito: number
Restituisce l'indice della route corrente (basato su zero) utilizzato da questo oggetto DirectionsRenderer.
setDirections
setDirections(directions)
Parametri:
Valore di restituzione: nessuno
Imposta il renderer in modo che utilizzi il risultato di DirectionsService. Se imposti un insieme di indicazioni valide in questo modo, verranno mostrate le indicazioni sulla mappa e sul riquadro del renderer.
setMap
setMap(map)
Parametri:
Valore di restituzione: nessuno
Questo metodo specifica la mappa su cui verranno visualizzate le indicazioni stradali. Supera null per rimuovere le indicazioni stradali dalla mappa.
setOptions
setOptions(options)
Parametri:
Valore di restituzione: nessuno
Modifica le impostazioni delle opzioni di questo DirectionsRenderer dopo l'inizializzazione.
setPanel
setPanel(panel)
Parametri:
Valore di restituzione: nessuno
Questo metodo esegue il rendering delle indicazioni stradali in un <div>. Passa null per rimuovere i contenuti dal riquadro.
setRouteIndex
setRouteIndex(routeIndex)
Parametri:
  • routeIndex: number
Valore di restituzione: nessuno
Imposta l'indice (basato su zero) della route nell'oggetto DirectionsResult di cui eseguire il rendering. Per impostazione predefinita, viene visualizzato il primo percorso dell'array.
Ereditata: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando le indicazioni stradali visualizzate cambiano, quando viene impostata una nuova DirectionsResult o quando l'utente completa il trascinamento di una modifica alle indicazioni stradali.

Interfaccia di DirectionsRendererOptions

google.maps.DirectionsRendererOptions interfaccia

Questo oggetto definisce le proprietà che possono essere impostate su un oggetto DirectionsRenderer.

directions optional
Tipo: DirectionsResult optional
Le indicazioni stradali per visualizzare la mappa e/o in un riquadro <div>, recuperate come un oggetto DirectionsResult da DirectionsService.
draggable optional
Tipo: boolean optional
Se true, consente all'utente di trascinare e modificare i percorsi delle route visualizzate da questo DirectionsRenderer.
hideRouteList optional
Tipo: boolean optional
Predefinito: false
Questa proprietà indica se il renderer deve fornire un elenco di route selezionabili dall'utente mostrato nel riquadro delle indicazioni stradali.
infoWindow optional
Tipo: InfoWindow optional
InfoWindow in cui visualizzare le informazioni testuali quando viene fatto clic su un indicatore. I contenuti della finestra informativa esistente verranno sovrascritti e la sua posizione verrà spostata. Se non viene specificata alcuna finestra informativa, DirectionsRenderer creerà e utilizzerà la propria finestra informativa. Questa proprietà verrà ignorata se suppressInfoWindows è impostato su true.
map optional
Tipo: Map optional
Mappa su cui visualizzare le indicazioni stradali.
markerOptions optional
Tipo: MarkerOptions optional
Opzioni per gli indicatori. Tutti gli indicatori visualizzati da DirectionsRenderer utilizzeranno queste opzioni.
panel optional
Tipo: HTMLElement optional
Il <div> in cui visualizzare i passaggi per le indicazioni stradali.
polylineOptions optional
Tipo: PolylineOptions optional
Opzioni per le polilinee. Tutte le polilinee visualizzate da DirectionsRenderer utilizzeranno queste opzioni.
preserveViewport optional
Tipo: boolean optional
Predefinito: false
Se questa opzione è impostata su true o non è mai stata impostata il centro della mappa e lo zoom non è mai stato impostato, la mappa di input viene centrata e ingrandita sul riquadro di delimitazione di queste indicazioni stradali.
routeIndex optional
Tipo: number optional
L'indice del percorso all'interno dell'oggetto DirectionsResult. Il valore predefinito è 0.
suppressBicyclingLayer optional
Tipo: boolean optional
Disattiva la visualizzazione di BicyclingLayer quando vengono richieste indicazioni stradali per le biciclette.
suppressInfoWindows optional
Tipo: boolean optional
Disattiva il rendering delle finestre informative.
suppressMarkers optional
Tipo: boolean optional
Elimina il rendering degli indicatori.
suppressPolylines optional
Tipo: boolean optional
Elimina il rendering delle polilinee.

Interfaccia di DirectionsWaypoint

google.maps.DirectionsWaypoint interfaccia

DirectionsWaypoint rappresenta una località tra l'origine e la destinazione attraverso la quale deve essere effettuata la corsa.

location optional
Tipo: string|LatLng|LatLngLiteral|Place optional
Posizione del punto di accesso. Può essere una stringa indirizzo, un LatLng o un Place. (Facoltativo)
stopover optional
Tipo: boolean optional
Predefinito: true
Se true, indica che questo waypoint è una fermata tra l'origine e la destinazione. In questo modo si divide il percorso in due giri. Se false, indica che la strada deve essere limitata in modo da seguire questo punto di passaggio, ma non suddivisa in due parti. Questo è utile se vuoi creare un percorso in risposta all'utente che trascina i tappe su una mappa.

Interfaccia DirectionsGeocodedWaypoint

google.maps.DirectionsGeocodedWaypoint interfaccia

Un unico waypoint geocodificato.

partial_match optional
Tipo: boolean optional
Indica se il geocodificatore non ha restituito una corrispondenza esatta per il punto di partenza originale, sebbene sia riuscito a far corrispondere parte dell'indirizzo richiesto.
place_id optional
Tipo: string optional
L'ID del luogo associato al punto di accesso. Gli ID luogo identificano in modo univoco un luogo nel database di Google Places e su Google Maps. Scopri di più sugli ID luogo nella guida per gli sviluppatori dell'API Places.
types optional
Tipo: Array<string> optional
Un array di stringhe che indicano il tipo di elemento geocodificato restituito. Per un elenco delle possibili stringhe, consulta la sezione Tipi di componenti degli indirizzi della Guida per gli sviluppatori.

Interfaccia DirectionsRoute

google.maps.DirectionsRoute interfaccia

Un unico percorso contenente un insieme di gambe in DirectionsResult. Tieni presente che, sebbene questo oggetto sia di tipo "JSON", non è strettamente JSON, in quanto include direttamente e indirettamente oggetti LatLng.

bounds
I limiti per questo percorso.
copyrights
Tipo: string
Testo del copyright da visualizzare per questo percorso.
legs
Un array di DirectionsLeg, ciascuno dei quali contiene informazioni sui passaggi che lo compongono. Sarà presente una sola gamba per ogni tappa o destinazione specificata per la tappa. Una route con tappe non può contenere solo DirectionsLeg, mentre una con due tappe.
overview_path
Tipo: Array<LatLng>
Un array di LatLng che rappresentano l'intero percorso di questa route. Il percorso è semplificato per renderlo adatto a contesti in cui è richiesto un numero limitato di vertici (ad esempio gli URL dell'API Static Maps).
overview_polyline
Tipo: string
Una rappresentazione polilinea codificata del percorso in panoramiche_path. Questa polilinea è un percorso approssimativo (superficiale) delle indicazioni stradali risultanti.
summary
Tipo: string
Contiene una breve descrizione testuale del percorso, adatta per denominare il percorso e distinguerlo dalle alternative.
warnings
Tipo: Array<string>
Avvisi da visualizzare durante la visualizzazione di queste indicazioni stradali.
waypoint_order
Tipo: Array<number>
Se il criterio optimizeWaypoints è stato impostato su true, questo campo conterrà la permutazione riordinata dei Waypoint di input. Ad esempio, se l'input fosse:
Origine: Los Angeles
Waypoints: Dallas, Bangor, Phoenix
Destinazione: New York
e l'output ottimizzato è stato ordinato come segue:
Origine: Los Angeles
Waypoints: Phoenix, Dallas, Bangor
Destinazione: New York
, questo campo sarà un Array contenente i valori [2, 0, 1] Tieni presente che la numerazione dei Waypoint è basata su zero.
Se in uno dei punti di immissione il valore stopover è impostato su false, questo campo sarà vuoto perché l'ottimizzazione del percorso non è disponibile per queste query.
fare optional
Tipo: TransitFare optional
La tariffa totale dell'intero viaggio con il trasporto pubblico. Valido solo per le richieste di trasporto pubblico.

Interfaccia di DirectionsLeg

google.maps.DirectionsLeg interfaccia

Una gamba composta da un insieme di passi in DirectionsResult. Alcuni campi della gamba potrebbero non essere restituiti per tutte le richieste. Tieni presente che, anche se il risultato è di tipo "JSON", non è rigorosamente JSON, poiché include direttamente e indirettamente LatLng oggetti.

end_address
Tipo: string
L'indirizzo della destinazione della tratta. Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo formattato in modo programmatico.
end_location
Tipo: LatLng
DirectionsService calcola le indicazioni stradali tra località utilizzando l'opzione di trasporto più vicina (di solito una strada) nelle posizioni di partenza e di arrivo. end_location indica la destinazione geocodificata effettiva, che potrebbe essere diversa dalla end_location dell'ultimo passaggio se, ad esempio, la strada non è vicina alla destinazione di questa tratta.
start_address
Tipo: string
L'indirizzo dell'origine della gamba. Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo formattato in modo programmatico.
start_location
Tipo: LatLng
DirectionsService calcola le indicazioni stradali tra località utilizzando l'opzione di trasporto più vicina (di solito una strada) nelle posizioni di partenza e di arrivo. start_location indica l'effettiva origine geocodificata e potrebbe essere diversa da start_location del primo passaggio se, ad esempio, la strada non si trova vicino all'origine di questa gamba.
steps
Un array di DirectionsStep, ognuno dei quali contiene informazioni sui singoli passaggi di questa tratta.
traffic_speed_entry
Tipo: Array<?>
Informazioni sulla velocità del traffico lungo la tratta.
via_waypoints
Tipo: Array<LatLng>
Un array di tappe non di tappa lungo questa tratta, che sono stati specificati nella richiesta originale.

Deprecato in percorsi alternativi. La versione 3.27 sarà l'ultima versione dell'API che aggiungerà ulteriori via_waypoints nelle route alternative.

Quando utilizzi il servizio Directions per implementare indicazioni stradali trascinabili, ti consigliamo di disattivare il trascinamento dei percorsi alternativi. Deve essere trascinabile solo il percorso principale. Gli utenti possono trascinare il percorso principale finché non corrisponde a un percorso alternativo.

arrival_time optional
Tipo: Time optional
Un orario di arrivo stimato per questa tratta. Valido solo per le richieste di TRANSIT.
departure_time optional
Tipo: Time optional
Un orario di partenza stimato per questa tratta. Valido solo per le richieste di TRANSIT.
distance optional
Tipo: Distance optional
La distanza totale coperta da questa gamba. Questa proprietà potrebbe non essere definita perché la distanza potrebbe essere sconosciuta.
duration optional
Tipo: Duration optional
La durata totale di questa gamba. Questa proprietà potrebbe essere undefined perché la durata potrebbe essere sconosciuta.
duration_in_traffic optional
Tipo: Duration optional
La durata totale di questa tratta, tenendo conto delle condizioni del traffico indicate dalla proprietà trafficModel. Questa proprietà potrebbe essere undefined perché la durata potrebbe essere sconosciuta.

Interfaccia di DirectionsStep

google.maps.DirectionsStep interfaccia

Un solo DirectionsStep in DirectionsResult. Alcuni campi potrebbero essere undefined. Tieni presente che, sebbene questo oggetto sia di tipo "JSON", non è rigorosamente JSON, in quanto include direttamente oggetti LatLng.

encoded_lat_lngs
Tipo: string
Una rappresentazione polilinea codificata del passaggio. Si tratta di un percorso approssimativo del passaggio.
end_location
Tipo: LatLng
La posizione finale di questo passaggio.
end_point
Tipo: LatLng
La posizione finale di questo passaggio.
instructions
Tipo: string
Istruzioni per questo passaggio.
lat_lngs
Tipo: Array<LatLng>
Una sequenza di LatLng che descrive il corso di questo passaggio. Si tratta di un percorso approssimativo del passaggio.
maneuver
Tipo: string
Contiene l'azione da eseguire per il passaggio corrente (turn-left, merge, straight e così via). I valori sono soggetti a modifica e i nuovi valori potrebbero essere introdotti senza preavviso.
path
Tipo: Array<LatLng>
Una sequenza di LatLng che descrive il corso di questo passaggio. Si tratta di un percorso approssimativo del passaggio.
start_location
Tipo: LatLng
La posizione iniziale di questo passaggio.
start_point
Tipo: LatLng
La posizione iniziale di questo passaggio.
travel_mode
La modalità di viaggio utilizzata in questo passaggio.
distance optional
Tipo: Distance optional
La distanza percorsa da questo passaggio. Questa proprietà potrebbe essere undefined perché la distanza potrebbe essere sconosciuta.
duration optional
Tipo: Duration optional
Il tempo tipico necessario per eseguire questo passaggio in secondi e sotto forma di testo. Questa proprietà potrebbe essere undefined perché la durata potrebbe essere sconosciuta.
polyline optional
Tipo: DirectionsPolyline optional
Contiene un oggetto con una singola proprietà "points" che contiene una rappresentazione polilinea codificata del passaggio. Questa polilinea è un percorso approssimativo del passaggio.
steps optional
Tipo: Array<DirectionsStep> optional
Passaggi secondari di questo passaggio. Specificato per le sezioni non di trasporto pubblico dei percorsi di trasporto pubblico.
transit optional
Tipo: TransitDetails optional
Dettagli su questo passaggio specifici per il trasporto pubblico. Questa proprietà non sarà definita a meno che la modalità di viaggio di questo passaggio non sia TRANSIT.
transit_details optional
Tipo: TransitDetails optional
Dettagli relativi a questo passaggio se la modalità di viaggio è TRANSIT.

Interfaccia di DirectionsPolyline

google.maps.DirectionsPolyline interfaccia

Un oggetto contenente una proprietà points per descrivere la polilinea di un DirectionsStep.

points
Tipo: string

Interfaccia di Place

google.maps.Place interfaccia

Contiene le informazioni necessarie per individuare, identificare o descrivere un luogo per un DirectionsRequest o DistanceMatrixRequest. In questo contesto, per "luogo" si intende un'attività, un punto d'interesse o una posizione geografica. Per informazioni su un luogo, consulta PlacesService.

location optional
Tipo: LatLng|LatLngLiteral optional
Il LatLng dell'entità descritta da questo luogo.
placeId optional
Tipo: string optional
L'ID del luogo (ad es. un'attività o un punto d'interesse). L'ID luogo è un identificatore univoco di un luogo nel database di Google Maps. Tieni presente che placeId è il modo più preciso per identificare un luogo. Se possibile, devi specificare placeId invece di query. Un ID luogo può essere recuperato da qualsiasi richiesta all'API Places, come TextSearch. Gli ID luogo possono essere recuperati anche dalle richieste all'API Geocoding. Per ulteriori informazioni, consulta la panoramica degli ID luogo.
query optional
Tipo: string optional
Una query di ricerca che descrive il luogo (ad esempio un'attività o un punto d'interesse). Una query di esempio è "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". Se possibile, devi specificare placeId invece di query. L'API non garantisce l'accuratezza della risoluzione della stringa di query in una determinata posizione. Se sono presenti sia placeId che query, si verifica un errore.

Costanti TravelMode

google.maps.TravelMode costanti

Le modalità di viaggio valide che possono essere specificate in DirectionsRequest e le modalità di viaggio restituite in un DirectionsStep. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'BICYCLING' o google.maps.TravelMode.BICYCLING.

Quando usi v=beta, puoi accedervi chiamando const {TravelMode} = await google.map.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

BICYCLING Specifica una richiesta di indicazioni stradali per le biciclette.
DRIVING Specifica una richiesta di indicazioni stradali.
TRANSIT Specifica una richiesta di indicazioni stradali per il trasporto pubblico.
WALKING Specifica una richiesta di indicazioni a piedi.

Interfaccia di DriveOptions

google.maps.DrivingOptions interfaccia

Configura DirectionsRequest quando la modalità di viaggio è impostata su DRIVING.

departureTime
Tipo: Date
L'orario di partenza desiderato per il percorso, specificato come oggetto Date. L'oggetto Date misura il tempo in millisecondi dal 1° gennaio 1970. Questo valore deve essere specificato affinché un elemento DrivingOptions sia valido. L'orario di partenza deve essere impostato sull'ora attuale o su una data futura. Non può essere nel passato.
trafficModel optional
Tipo: TrafficModel optional
Il presupposto preferito per prevedere la durata del traffico. Il valore predefinito è BEST_GUESS.

Costanti TrafficModel

google.maps.TrafficModel costanti

Le ipotesi da utilizzare quando si prevede la durata del traffico. Specificato come parte di DirectionsRequest o DistanceMatrixRequest. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'bestguess' o google.maps.TrafficModel.BEST_GUESS.

Quando usi v=beta, puoi accedervi chiamando const {TrafficModel} = await google.map.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

BEST_GUESS Utilizza i dati storici sul traffico per stimare al meglio il tempo trascorso nel traffico.
OPTIMISTIC Utilizza i dati storici sul traffico per stimare in modo ottimistico la durata del traffico.
PESSIMISTIC Utilizza i dati storici sul traffico per fare una stima pessimistica della durata del traffico.

Interfaccia TransitOptions

google.maps.TransitOptions interfaccia

L'oggetto TransitOptions da includere in DirectionsRequest quando la modalità di viaggio è impostata su TRANSIT.

arrivalTime optional
Tipo: Date optional
L'ora di arrivo desiderata per il percorso, specificata come oggetto Date. L'oggetto Date misura il tempo in millisecondi dal 1° gennaio 1970. Se viene specificato l'ora di arrivo, l'orario di partenza viene ignorato.
departureTime optional
Tipo: Date optional
L'orario di partenza desiderato per il percorso, specificato come oggetto Date. L'oggetto Date misura il tempo in millisecondi dal 1° gennaio 1970. Se non viene specificato né l'orario di partenza né quello di arrivo, si presume che l'orario sia "ora".
modes optional
Tipo: Array<TransitMode> optional
Una o più modalità di trasporto pubblico preferite, ad esempio autobus o treno. Se non viene data alcuna preferenza, l'API restituisce il percorso migliore predefinito.
routingPreference optional
Tipo: TransitRoutePreference optional
Una preferenza che può influenzare la scelta del percorso con il trasporto pubblico, ad esempio una minore camminata. Se non viene data alcuna preferenza, l'API restituisce il percorso migliore predefinito.

Costanti di TransitMode

google.maps.TransitMode costanti

La modalità di trasporto pubblico valida, ad esempio l'autobus che può essere specificato in una TransitOptions. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'BUS' o google.maps.TransitMode.BUS.

Quando usi v=beta, puoi accedervi chiamando const {TransitMode} = await google.map.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

BUS Specifica l'autobus come mezzo di trasporto preferito.
RAIL Specifica la ferrovia come mezzo di trasporto preferito.
SUBWAY Specifica la metropolitana come mezzo di trasporto preferito.
TRAIN Specifica il treno come modalità di trasporto pubblico preferita.
TRAM Specifica il tram come mezzo di trasporto preferito.

Costanti TransitRoutePreferenza

google.maps.TransitRoutePreference costanti

Il tipo di percorso di trasporto pubblico valido che può essere specificato in una TransitOptions. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'LESS_WALKING' o google.maps.TransitRoutePreference.LESS_WALKING.

Quando usi v=beta, puoi accedervi chiamando const {TransitRoutePreference} = await google.map.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

FEWER_TRANSFERS Specifica che il percorso calcolato deve preferire un numero limitato di cambi.
LESS_WALKING Specifica che il percorso calcolato dovrebbe preferire una quantità limitata di tratti di camminata.

Interfaccia TransitTariffa

google.maps.TransitFare interfaccia

Una tariffa per DirectionsRoute composta da valore e valuta.

currency
Tipo: string
Un codice valuta ISO 4217 che indica la valuta in cui è espressa la tariffa.
value
Tipo: number
Il valore numerico della tariffa, espresso in currency.

Interfaccia TransitDetails

google.maps.TransitDetails interfaccia

Dettagli su partenza, arrivo e modalità di trasporto pubblico utilizzati in questo passaggio.

arrival_stop
La fermata di arrivo di questo passaggio del trasporto pubblico.
arrival_time
Tipo: Time
L'ora di arrivo di questo passaggio, specificata come oggetto Time.
departure_stop
La fermata di partenza di questo passaggio per il trasporto pubblico.
departure_time
Tipo: Time
L'ora di partenza di questo passaggio, specificata come oggetto time.
headsign
Tipo: string
La direzione di viaggio su questa linea, indicata sul veicolo o alla fermata.
headway
Tipo: number
Il numero di secondi previsto tra i veicoli equivalenti a questa fermata.
line
Dettagli sulla linea di trasporto pubblico utilizzati in questo passaggio.
num_stops
Tipo: number
Il numero di fermate in questo passaggio. Include la fermata di arrivo, ma non la fermata di partenza.
trip_short_name
Tipo: string
Il testo visualizzato negli orari e nei cartelloni per identificare un viaggio in transito ai passeggeri, ad esempio, per identificare i numeri dei treni per le corse ferroviarie di pendolari. Il testo identifica in modo univoco una corsa in un giorno di servizio.

Interfaccia TransitStop

google.maps.TransitStop interfaccia

Dettagli su una fermata o una stazione di transito.

location
Tipo: LatLng
La posizione di questa fermata.
name
Tipo: string
Il nome di questa fermata del trasporto pubblico.

Interfaccia TransitLine

google.maps.TransitLine interfaccia

Informazioni sulla linea di trasporto pubblico che gestisce questo passaggio.

agencies
L'azienda di trasporto pubblico che gestisce questa linea di trasporto pubblico.
color
Tipo: string
Il colore di uso comune della segnaletica, per questa linea di trasporto pubblico, rappresentata da una stringa esagonale.
icon
Tipo: string
L'URL di un'icona associata a questa riga.
name
Tipo: string
Il nome completo di questa linea di trasporto pubblico, ad esempio "Via Verdi 8".
short_name
Tipo: string
Il nome breve di questa linea di trasporto pubblico, ad esempio "E".
text_color
Tipo: string
Il colore del testo di uso comune nella segnaletica per questa linea di transito, rappresentato come una stringa esadecimale.
url
Tipo: string
L'URL dell'azienda di trasporto specifico per questa linea di trasporto pubblico.
vehicle
Il tipo di veicolo utilizzato, ad esempio treno o autobus.

Interfaccia TransitAgency

google.maps.TransitAgency interfaccia

Informazioni su un'azienda di trasporto pubblico che gestisce una linea di trasporto pubblico.

name
Tipo: string
Il nome dell'azienda di trasporto pubblico.
phone
Tipo: string
Il numero di telefono dell'azienda di trasporto pubblico.
url
Tipo: string
URL dell'azienda di trasporto pubblico.

Interfaccia Transit Vehicle

google.maps.TransitVehicle interfaccia

Informazioni sul veicolo che opera su una linea di trasporto pubblico.

icon
Tipo: string
L'URL di un'icona che corrisponde al tipo di veicolo utilizzato su questa linea.
local_icon
Tipo: string
Un URL per un'icona che corrisponde al tipo di veicolo utilizzato in questa regione anziché all'icona più generica.
name
Tipo: string
Un nome per questo tipo di TransitTransport, ad esempio "Treno" o "Pullman".
type
Il tipo di veicolo utilizzato, ad esempio treno, autobus o traghetto.

Costanti VehicleType

google.maps.VehicleType costanti

I valori possibili per i tipi di veicoli.

Quando usi v=beta, puoi accedervi chiamando const {VehicleType} = await google.map.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

BUS Autobus.
CABLE_CAR Un veicolo che funziona su un cavo, solitamente a terra. Le funicolari per auto possono essere del tipo GONDOLA_LIFT.
COMMUTER_TRAIN Ferrovia per pendolari.
FERRY Traghetto.
FUNICULAR Un veicolo che sale su una ripida pendenza da un cavo.
GONDOLA_LIFT Una funivia.
HEAVY_RAIL Ferrovia pesante.
HIGH_SPEED_TRAIN Treno ad alta velocità.
INTERCITY_BUS Autolinee regionali e nazionali.
METRO_RAIL Metropolitana leggera.
MONORAIL Monorotaia.
OTHER Altri veicoli.
RAIL Ferrovia.
SHARE_TAXI Il taxi condiviso è una sorta di trasporto in autobus che consente di scendere e prendere passeggeri ovunque lungo il percorso. Di solito il taxi è condiviso con i minibus.
SUBWAY Metropolitana leggera.
TRAM Metropolitana leggera su terra.
TROLLEYBUS Tram.

Costanti di UnitSystem

google.maps.UnitSystem costanti

I sistemi di unità validi che possono essere specificati in una DirectionsRequest.

Quando usi v=beta, puoi accedervi chiamando const {UnitSystem} = await google.map.importLibrary("core"). Consulta la sezione Librerie nell'API Maps JavaScript.

IMPERIAL Specifica che le distanze in DirectionsResult devono essere espresse in unità imperiali.
METRIC Specifica che le distanze in DirectionsResult devono essere espresse in unità metriche.

Interfaccia a distanza

google.maps.Distance interfaccia

Una rappresentazione della distanza come valore numerico e stringa di visualizzazione.

text
Tipo: string
Una rappresentazione stringa del valore della distanza, utilizzando UnitSystem specificato nella richiesta.
value
Tipo: number
La distanza in metri.

Durata dell'interfaccia

google.maps.Duration interfaccia

Una rappresentazione della durata come valore numerico e stringa di visualizzazione.

text
Tipo: string
Una rappresentazione stringa del valore della durata.
value
Tipo: number
La durata in secondi.

Interfaccia Ora

google.maps.Time interfaccia

Una rappresentazione dell'ora come oggetto della data, una stringa localizzata e un fuso orario.

text
Tipo: string
Una stringa che rappresenta il valore dell'ora. L'ora viene visualizzata nel fuso orario della fermata del trasporto pubblico.
time_zone
Tipo: string
Il fuso orario in cui si trova la fermata. Il valore è il nome del fuso orario definito nel database dei fusi orari IANA, ad esempio "America/New_York".
value
Tipo: Date
L'ora di partenza o di arrivo, specificata come oggetto della data JavaScript.

Costanti DirectionsTravelMode

google.maps.DirectionsTravelMode costanti

Costanti DirectionsUnitSystem

google.maps.DirectionsUnitSystem costanti