Directions

Classe DirectionsService

google.maps.DirectionsService classe

Un servizio per calcolare le indicazioni stradali tra due o più luoghi.

Accedi chiamando const {DirectionsService} = await google.maps.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

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

Interfaccia DirectionsRequest

Interfaccia google.maps.DirectionsRequest

Una query sulle indicazioni stradali da inviare a DirectionsService.

destination
Tipo:  string|LatLng|Place|LatLngLiteral
Località di destinazione. Può essere specificata come stringa da geocodificare oppure LatLng o Place. obbligatorio.
origin
Tipo:  string|LatLng|Place|LatLngLiteral
Località di origine. Può essere specificata come stringa da geocodificare oppure LatLng o Place. obbligatorio.
travelMode
Tipo:  TravelMode
Tipo di routing richiesto. obbligatorio.
avoidFerries optional
Tipo:  boolean optional
Se true, indica al servizio Directions di evitare i traghetti, ove possibile. Campo facoltativo.
avoidHighways optional
Tipo:  boolean optional
Se true, indica al servizio Indicazioni stradali di evitare le autostrade, ove possibile. Campo facoltativo.
avoidTolls optional
Tipo:  boolean optional
Se true, indica al servizio Indicazioni stradali di evitare le strade a pedaggio, se possibile. Campo facoltativo.
drivingOptions optional
Tipo:  DrivingOptions optional
Impostazioni che si applicano solo alle richieste in cui travelMode è DRIVING. Questo oggetto non avrà effetto per altre modalità di viaggio.
language optional
Tipo:  string optional
Un identificatore della lingua per la lingua in cui restituire i risultati, se possibile. Consulta l'elenco delle lingue supportate.
optimizeWaypoints optional
Tipo:  boolean optional
Se viene impostato su true, DirectionsService tenterà di riordinare i waypoint 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 è necessario fornire o meno alternative di percorso. Campo facoltativo.
region optional
Tipo:  string optional
Codice regione utilizzato come bias per le richieste di geocodifica. Il codice regione accetta un ccTLD ("dominio di primo livello") a due caratteri. La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD del Regno Unito è "uk " (.co.uk), mentre il codice ISO 3166-1 è"gb " (tecnicamente per l'entità "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 altre modalità di viaggio.
unitSystem optional
Tipo:  UnitSystem optional
Predefinite: il sistema di unità utilizzato nel paese di origine.
Sistema di unità preferito da utilizzare per la visualizzazione della distanza.
waypoints optional
Tipo:  Array<DirectionsWaypoint> optional
Array di waypoint intermedi. Le indicazioni stradali vengono calcolate dall'origine alla destinazione per mezzo di ciascun waypoint in questo array. Consulta la guida per gli sviluppatori per conoscere il numero massimo di waypoint consentiti. I waypoint non sono supportati per le indicazioni stradali con il trasporto pubblico. Campo facoltativo.

Costanti DirectionsStatus

google.maps.DirectionsStatus costanti

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

Accedi chiamando const {DirectionsStatus} = await google.maps.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

INVALID_REQUEST Il DirectionsRequest fornito non è valido.
MAX_WAYPOINTS_EXCEEDED Nel DirectionsRequest sono stati specificati troppi DirectionsWaypoint. Consulta la guida per gli sviluppatori per conoscere il numero massimo di waypoint consentiti.
NOT_FOUND Non è stato possibile geocodificare almeno uno dei punti di partenza, di destinazione o dei waypoint.
OK La risposta contiene un valore 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 riuscire.
ZERO_RESULTS Non è stato trovato alcun percorso tra l'origine e la destinazione.

Interfaccia di DirectionsResult

Interfaccia google.maps.DirectionsResult

La risposta delle indicazioni stradali recuperata dal server delle indicazioni stradali. Puoi eseguire il rendering di questi elementi utilizzando un DirectionsRenderer oppure analizzare questo oggetto ed eseguirne il rendering. Devi mostrare gli avvisi e i copyright come indicato nei Termini di servizio di Google Maps Platform. Tieni presente che anche se questo risultato è di tipo "JSON", non è strettamente JSON, poiché include indirettamente gli oggetti LatLng.

request
La richiesta DirectionsRequest che ha restituito questo risultato.
routes
Un array di DirectionsRoute, ognuno dei quali contiene informazioni sui cateti e sui passaggi di cui è composto. Ci sarà un solo percorso, a meno che il DirectionsRequest non sia stato creato con provideRouteAlternatives impostato su true.
available_travel_modes optional
Tipo:  Array<TravelMode> optional
Contiene un array di modalità di viaggio disponibili. Questo campo viene restituito quando una richiesta specifica una modalità di viaggio e non genera risultati. L'array contiene le modalità di viaggio disponibili nei paesi dell'insieme di waypoint specificato. Questo campo non viene restituito se uno o più waypoint sono "tramite waypoint".
geocoded_waypoints optional
Un array di DirectionsGeocodedWaypoint, ognuno dei quali contiene informazioni sulla geocodifica dell'origine, della destinazione e dei waypoint.

Classe DirectionsRenderer

google.maps.DirectionsRenderer classe

Visualizza le indicazioni stradali ottenute da DirectionsService.

Questa classe estende MVCObject.

Accedi chiamando const {DirectionsRenderer} = await google.maps.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 in aggiunta in un riquadro <div> (come istruzioni testuali).
getDirections
getDirections()
Parametri: nessuno
Valore restituito:  DirectionsResult
Restituisce l'insieme di direzioni correnti del renderer.
getMap
getMap()
Parametri: nessuno
Valore restituito:  Map
Restituisce la mappa su cui viene visualizzato DirectionsResult.
getPanel
getPanel()
Parametri: nessuno
Valore restituito:  HTMLElement|null
Restituisce il riquadro <div> in cui viene visualizzato l'elemento DirectionsResult.
getRouteIndex
getRouteIndex()
Parametri: nessuno
Valore restituito:  number
Restituisce l'indice di route corrente (in base a zero) utilizzato da questo oggetto DirectionsRenderer.
setDirections
setDirections(directions)
Parametri: 
Valore restituito: nessuno
Imposta il renderer in modo che utilizzi il risultato di DirectionsService. Impostando un insieme valido di direzioni in questo modo verranno visualizzate le direzioni sulla mappa e sul riquadro designati dal renderer.
setMap
setMap(map)
Parametri: 
Valore restituito: nessuno
Questo metodo specifica la mappa su cui verranno visualizzate le indicazioni stradali. Supera null per rimuovere le indicazioni dalla mappa.
setOptions
setOptions(options)
Parametri: 
Valore restituito: nessuno
Modifica le impostazioni delle opzioni di DirectionsRenderer dopo l'inizializzazione.
setPanel
setPanel(panel)
Parametri: 
Valore restituito: nessuno
Questo metodo esegue il rendering delle direzioni in un oggetto <div>. Passa null per rimuovere i contenuti dal riquadro.
setRouteIndex
setRouteIndex(routeIndex)
Parametri: 
  • routeIndexnumber
Valore restituito: nessuno
Imposta l'indice (in base zero) della route nell'oggetto DirectionsResult di cui eseguire il rendering. Per impostazione predefinita, verrà eseguito il rendering della prima route nell'array.
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando le direzioni visualizzate cambiano, quando viene impostato un nuovo DirectionsResult o quando l'utente finisce di trascinare una modifica nel percorso delle indicazioni stradali.

Interfaccia DirectionsRendererOptions

Interfaccia google.maps.DirectionsRendererOptions

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

directions optional
Tipo:  DirectionsResult optional
Le indicazioni stradali da visualizzare sulla mappa e/o in un riquadro <div>, recuperate come oggetto DirectionsResult da DirectionsService.
draggable optional
Tipo:  boolean optional
Se true, consente all'utente di trascinare e modificare i percorsi dei percorsi visualizzati in questo DirectionsRenderer.
hideRouteList optional
Tipo:  boolean optional
Predefinita: false
Questa proprietà indica se il renderer deve fornire un elenco selezionabile dall'utente di route mostrate nel riquadro delle indicazioni stradali.
infoWindow optional
Tipo:  InfoWindow optional
Il InfoWindow in cui visualizzare le informazioni di testo quando si fa clic su un indicatore. I contenuti delle finestre informative esistenti verranno sovrascritti e la loro posizione verrà spostata. Se non viene specificata alcuna finestra informativa, DirectionsRenderer creerà e utilizzerà la propria finestra informativa. Questa proprietà verrà ignorata se il criterio suppressInfoWindows è impostato su true.
map optional
Tipo:  Map optional
Mappa sulla quale visualizzare le indicazioni stradali.
markerOptions optional
Tipo:  MarkerOptions optional
Opzioni per gli indicatori. Tutti gli indicatori visualizzati da DirectionsRenderer useranno queste opzioni.
panel optional
Tipo:  HTMLElement optional
Il <div> in cui visualizzare i passaggi delle indicazioni stradali.
polylineOptions optional
Tipo:  PolylineOptions optional
Opzioni per le polilinee. Tutte le polilinee visualizzate dall'elemento DirectionsRenderer useranno queste opzioni.
preserveViewport optional
Tipo:  boolean optional
Predefinita: false
Se questa opzione è impostata su true o se il centro della mappa non è mai stato impostato e lo zoom non è mai stato impostato, la mappa di input viene centrata e ingrandita rispetto al riquadro di delimitazione di questo insieme di direzioni.
routeIndex optional
Tipo:  number optional
L'indice della route all'interno dell'oggetto DirectionsResult. Il valore predefinito è 0.
suppressBicyclingLayer optional
Tipo:  boolean optional
Elimina il rendering di BicyclingLayer quando vengono richieste indicazioni stradali in bicicletta.
suppressInfoWindows optional
Tipo:  boolean optional
Elimina 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 DirectionsWaypoint

Interfaccia google.maps.DirectionsWaypoint

Un DirectionsWaypoint rappresenta una località tra l'origine e la destinazione attraverso la quale deve essere effettuato il percorso della corsa.

location optional
Tipo:  string|LatLng|LatLngLiteral|Place optional
Posizione del waypoint. Può essere una stringa indirizzo, LatLng o Place. Campo facoltativo.
stopover optional
Tipo:  boolean optional
Predefinita: true
Se true, indica che il waypoint è una fermata tra il luogo di partenza e la destinazione. In questo modo, il percorso viene suddiviso in due parti. Se false, indica che il percorso deve essere parziale per attraversare questo waypoint, ma non essere diviso in due tratti. Ciò è utile se vuoi creare un percorso in risposta all'utente che trascina i waypoint su una mappa.

Interfaccia DirectionsGeocodedWaypoint

Interfaccia google.maps.DirectionsGeocodedWaypoint

Un singolo waypoint geocodificato.

partial_match optional
Tipo:  boolean optional
Indica se il geocodificatore non ha restituito una corrispondenza esatta per il waypoint originale, nonostante sia stato in grado di corrispondere a parte dell'indirizzo richiesto.
place_id optional
Tipo:  string optional
L'ID luogo associato al waypoint. 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 indica il tipo dell'elemento geocodificato restituito. Per un elenco di possibili stringhe, consulta la sezione Tipi di componenti per l'indirizzo della Guida per gli sviluppatori.

Interfaccia DirectionsRoute

Interfaccia google.maps.DirectionsRoute

Un singolo percorso contenente un insieme di tratti in un DirectionsResult. Tieni presente che, anche se questo oggetto è di tipo "JSON", non è strettamente JSON, poiché include direttamente e indirettamente gli oggetti LatLng.

bounds
Tipo:  LatLngBounds
I limiti di questo percorso.
copyrights
Tipo:  string
Testo del copyright da mostrare per questo percorso.
legs
Un array di DirectionsLeg, ognuno dei quali contiene informazioni sui passaggi di cui è composto. Ci sarà una tratta per ogni tappa o destinazione di sosta specificati. Pertanto, un percorso senza waypoint di scalo conterrà un DirectionsLeg, mentre un percorso con un waypoint di sosta ne conterrà due.
overview_path
Tipo:  Array<LatLng>
Un array di LatLng che rappresenta l'intero percorso di questo percorso. Il percorso è semplificato per renderlo adatto in contesti in cui è richiesto un numero ridotto di vertici (come gli URL dell'API Static Maps).
overview_polyline
Tipo:  string
Una rappresentazione di una polilinea codificata della route in overview_path. Questa polilinea è un percorso approssimativo (attenuato) delle direzioni risultanti.
summary
Tipo:  string
Contiene una breve descrizione testuale per il percorso, utile per assegnargli un nome e distinguere il percorso dalle alternative.
warnings
Tipo:  Array<string>
Avvisi da visualizzare quando si visualizzano queste indicazioni stradali.
waypoint_order
Tipo:  Array<number>
Se il criterio optimizeWaypoints è stato impostato su true, questo campo conterrà le permutazioni riordinate dei waypoint di input. Ad esempio, se l'input era:
Origine: Los Angeles
Waypoints: Dallas, Bangor, Phoenix
Destinazione: New York
e l'output ottimizzato è stato ordinato come segue:
Origine: Los Angeles
Waypoint: Phoenix, Dallas, Bangor
Destinazione: New York
, questo campo sarà un Array contenente i valori [2], 0, 1. Tieni presente che la numerazione dei waypoint è in base zero.
Se il valore stopover per uno dei waypoint inseriti è impostato su false, questo campo sarà vuoto, poiché l'ottimizzazione del percorso non è disponibile per queste query.
fare optional
Tipo:  TransitFare optional
Tariffa totale per l'intero percorso con il trasporto pubblico. Valido solo per le richieste di trasporto pubblico.

Interfaccia DirectionsLeg

Interfaccia google.maps.DirectionsLeg

Una singola gamba composta da una serie di passi in un DirectionsResult. È possibile che alcuni campi nel segmento non vengano restituiti per tutte le richieste. Tieni presente che, anche se questo risultato è di tipo "JSON", non è strettamente JSON, poiché include direttamente e indirettamente gli oggetti LatLng.

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

Deprecato in route alternative. La versione 3.27 sarà l'ultima dell'API che aggiunge via_waypoints in più nelle route alternative.

Se utilizzi il servizio Indicazioni stradali per implementare le direzioni trascinabili, ti consigliamo di disattivare il trascinamento dei percorsi alternativi. Solo il percorso principale deve essere trascinabile. Gli utenti possono trascinare il percorso principale fino a trovare un percorso alternativo.

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

Interfaccia DirectionsStep

Interfaccia google.maps.DirectionsStep

Un singolo DirectionsStep in un DirectionsResult. Alcuni campi potrebbero essere undefined. Tieni presente che, anche se questo oggetto è di tipo "JSON", non è strettamente JSON, poiché include direttamente gli oggetti LatLng.

encoded_lat_lngs
Tipo:  string
Una rappresentazione di una polilinea codificata del passaggio. Questo è un percorso approssimativo (attenuato) 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 lo svolgimento di questo passaggio. Questo è un percorso approssimativo (attenuato) 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 lo svolgimento di questo passaggio. Questo è un percorso approssimativo (attenuato) del passaggio.
start_location
Tipo:  LatLng
La posizione iniziale di questo passaggio.
start_point
Tipo:  LatLng
La posizione iniziale di questo passaggio.
travel_mode
Tipo:  TravelMode
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 medio necessario per eseguire questo passaggio, espresso in secondi e in formato 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 (attenuato) del passo.
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 relativi al trasporto pubblico su questo passaggio. 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 DirectionsPolyline

Interfaccia google.maps.DirectionsPolyline

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

points
Tipo:  string

Interfaccia del luogo

Interfaccia google.maps.Place

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

location optional
Tipo:  LatLng|LatLngLiteral optional
LatLng dell'entità descritta da questo luogo.
placeId optional
Tipo:  string optional
L'ID del luogo (ad esempio un'attività commerciale o un punto d'interesse). L'ID luogo è l'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 anziché un valore query. L'ID luogo può essere recuperato da qualsiasi richiesta all'API Places, ad esempio TextSearch. Gli ID luogo possono essere recuperati 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à commerciale 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 anziché un valore query. L'API non garantisce la precisione della risoluzione della stringa di query in una posizione. Se vengono forniti sia placeId sia query, si verifica un errore.

Costanti di TravelMode

google.maps.TravelMode costanti

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

Accedi chiamando const {TravelMode} = await google.maps.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

BICYCLING Specifica una richiesta di indicazioni stradali in bicicletta.
DRIVING Specifica una richiesta di indicazioni stradali.
TRANSIT Specifica una richiesta di indicazioni stradali con il trasporto pubblico.
WALKING Specifica una richiesta di indicazioni a piedi.

Interfaccia DrivingOptions

Interfaccia google.maps.DrivingOptions

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. Deve essere specificato affinché DrivingOptions sia valido. L'ora di partenza deve essere impostata sull'ora corrente o su un'ora nel futuro. Non può essere nel passato.
trafficModel optional
Tipo:  TrafficModel optional
L'ipotesi preferita da utilizzare per prevedere la durata nel traffico. Il valore predefinito è BEST_GUESS.

Costanti TrafficModel

google.maps.TrafficModel costanti

Le ipotesi da utilizzare per prevedere la durata nel traffico. È stato specificato come parte di un DirectionsRequest o DistanceMatrixRequest. Specificali in base al valore o utilizzando il nome della costante. Ad esempio, 'bestguess' o google.maps.TrafficModel.BEST_GUESS.

Accedi chiamando const {TrafficModel} = await google.maps.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

BEST_GUESS Utilizzare i dati storici sul traffico per stimare al meglio il tempo trascorso nel traffico.
OPTIMISTIC Utilizza i dati storici sul traffico per fare una stima ottimistica della durata del traffico.
PESSIMISTIC Utilizza i dati storici sul traffico per effettuare una stima pessimistica della durata del traffico.

Interfaccia di TransitOptions

Interfaccia google.maps.TransitOptions

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 Data. L'oggetto Data misura il tempo in millisecondi dal 1° gennaio 1970. Se è specificata l'ora di arrivo, quella di partenza viene ignorata.
departureTime optional
Tipo:  Date optional
L'ora di partenza desiderata per il percorso, specificata come oggetto Data. L'oggetto Data misura il tempo in millisecondi dal 1° gennaio 1970. Se non viene specificato né l'ora di partenza né quella di arrivo, si presume che l'ora sia "ora".
modes optional
Tipo:  Array<TransitMode> optional
Una o più modalità di trasporto preferite, ad esempio autobus o treno. Se non viene fornita alcuna preferenza, l'API restituisce la route migliore predefinita.
routingPreference optional
Tipo:  TransitRoutePreference optional
Una preferenza che può influenzare la scelta del percorso di trasporto pubblico, ad esempio meno tratti a piedi. Se non viene fornita alcuna preferenza, l'API restituisce la route migliore predefinita.

Costanti di TransitMode

google.maps.TransitMode costanti

La modalità di trasporto pubblico valida, ad esempio bus, che può essere specificata in un TransitOptions. Specificali in base al valore o utilizzando il nome della costante. Ad esempio, 'BUS' o google.maps.TransitMode.BUS.

Accedi chiamando const {TransitMode} = await google.maps.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

BUS Specifica il pullman come mezzo di trasporto preferito.
RAIL Specifica ferrovia come mezzo di trasporto preferito.
SUBWAY Specifica la metropolitana come mezzo di trasporto preferito.
TRAIN Specifica il treno come mezzo di trasporto preferito.
TRAM Specifica il tram come mezzo di trasporto preferito.

Costanti TransitRoutePreference

google.maps.TransitRoutePreference costanti

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

Accedi chiamando const {TransitRoutePreference} = await google.maps.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 deve preferire un numero di camminate limitate.

Interfaccia TransitFare

Interfaccia google.maps.TransitFare

Una tariffa di DirectionsRoute , composta da valore e valuta.

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

Interfaccia TransitDetails

Interfaccia google.maps.TransitDetails

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

arrival_stop
Tipo:  TransitStop
La fermata di arrivo di questo passaggio.
arrival_time
Tipo:  Time
L'ora di arrivo di questo passaggio, specificata come oggetto Time.
departure_stop
Tipo:  TransitStop
La fermata di partenza di questo passaggio di trasporto pubblico.
departure_time
Tipo:  Time
L'ora di partenza di questo passaggio, specificata come oggetto Time.
headsign
Tipo:  string
La direzione in cui viaggiare su questa linea, indicata sul veicolo o alla fermata di partenza.
headway
Tipo:  number
Il numero di secondi previsto tra veicoli equivalenti in questa fermata.
line
Tipo:  TransitLine
Dettagli sulla linea di trasporto pubblico utilizzata in questo passaggio.
num_stops
Tipo:  number
Il numero di tappe 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 sui cartelli per identificare le corse dei passeggeri, ad esempio per identificare i numeri di treni per le corse ferroviarie dei pendolari. Il testo identifica in modo univoco una corsa entro un giorno di servizio.

Interfaccia di TransitStop

Interfaccia google.maps.TransitStop

Dettagli su una fermata o una stazione di trasporto pubblico.

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

Interfaccia di TransitLine

Interfaccia google.maps.TransitLine

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 comunemente utilizzato nella segnaletica per questa linea di trasporto pubblico, rappresentato da una stringa esadecimale.
icon
Tipo:  string
L'URL di un'icona associata a questa linea.
name
Tipo:  string
Il nome completo di questa linea di trasporto pubblico, ad esempio "8 Avenue Local".
short_name
Tipo:  string
Il nome breve di questa linea di trasporto pubblico, ad esempio "E".
text_color
Tipo:  string
Il colore del testo comunemente utilizzato nella segnaletica per questa linea di trasporto pubblico, rappresentato come una stringa esadecimale.
url
Tipo:  string
L'URL dell'azienda che è specifico per questa linea di trasporto pubblico.
vehicle
Il tipo di veicolo utilizzato, ad esempio treno o autobus.

Interfaccia di TransitAgency

Interfaccia google.maps.TransitAgency

Informazioni su un'azienda 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
L'URL dell'azienda di trasporto pubblico.

Interfaccia TransitVehicle

Interfaccia google.maps.TransitVehicle

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 riga.
local_icon
Tipo:  string
L'URL di 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 veicolo di trasporto pubblico, ad esempio "Treno" o "Autobus".
type
Tipo:  VehicleType
Il tipo di veicolo utilizzato, ad esempio treno, autobus o traghetto.

Costanti di VehicleType

google.maps.VehicleType costanti

Valori possibili per i tipi di veicoli.

Accedi chiamando const {VehicleType} = await google.maps.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.

BUS Autobus.
CABLE_CAR Un veicolo collegato a un cavo, di solito a terra. Le funivie aeree possono essere del tipo GONDOLA_LIFT.
COMMUTER_TRAIN Treno per pendolari.
FERRY Traghetto.
FUNICULAR Un veicolo trainato da un cavo su una ripida pendenza.
GONDOLA_LIFT Una funivia.
HEAVY_RAIL Ferrovia pesante.
HIGH_SPEED_TRAIN Treno ad alta velocità.
INTERCITY_BUS Autobus interurbano.
METRO_RAIL Metropolitana leggera.
MONORAIL Monorotaia.
OTHER Altri veicoli.
RAIL Treno.
SHARE_TAXI Il taxi condiviso è una sorta di trasporto in autobus con la possibilità di far scendere e far salire i passeggeri ovunque lungo il percorso. In genere i taxi condivisi utilizzano minibus.
SUBWAY Metropolitana leggera sotterranea.
TRAM Metropolitana leggera sopra il suolo.
TROLLEYBUS Filobus.

Costanti di UnitSystem

google.maps.UnitSystem costanti

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

Accedi chiamando const {UnitSystem} = await google.maps.importLibrary("core"). Consulta la sezione Librerie nell'API Maps JavaScript.

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

Interfaccia di distanza

Interfaccia google.maps.Distance

Una rappresentazione della distanza sotto forma di valore numerico e stringa di visualizzazione.

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

Interfaccia Durata

Interfaccia google.maps.Duration

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

Interfaccia google.maps.Time

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

text
Tipo:  string
Una stringa che rappresenta il valore dell'ora. L'ora viene visualizzata nel fuso orario della fermata di 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 questa partenza o arrivo, specificata come oggetto Data JavaScript.

Costanti di DirectionsTravelMode

google.maps.DirectionsTravelMode costanti

Costanti di DirectionsUnitSystem

google.maps.DirectionsUnitSystem costanti