Directions

DirectionsService class

google.maps.DirectionsService classe

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

Accesso chiamando il numero const {DirectionsService} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.

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

Interfaccia DirectionsRequest

google.maps.DirectionsRequest interfaccia

Una query di indicazioni stradali da inviare a DirectionsService.

destination
Tipo:  string|LatLng|Place|LatLngLiteral
Posizione della destinazione. Può essere specificato come stringa da geocodificare, come LatLng o come Place. Obbligatorio.
origin
Tipo:  string|LatLng|Place|LatLngLiteral
Luogo di origine. Può essere specificato come stringa da geocodificare, come LatLng o come Place. Obbligatorio.
travelMode
Tipo:  TravelMode
Tipo di routing richiesto. Obbligatorio.
avoidFerries optional
Tipo:  boolean optional
Se true, il servizio Indicazioni stradali indica di evitare i traghetti, se possibile. (Facoltativo)
avoidHighways optional
Tipo:  boolean optional
Se true, indica al servizio Indicazioni stradali di evitare le autostrade, se possibile. (Facoltativo)
avoidTolls optional
Tipo:  boolean optional
Se true, il servizio Indicazioni stradali evita le 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à alcun effetto per altre modalità di viaggio.
language optional
Tipo:  string optional
Un identificatore di lingua per la 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 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 devono essere fornite o meno alternative di percorso. (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 ("dominio di primo livello"). La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il TLD nazionale del Regno Unito è "uk " (.co.uk), mentre il suo 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à alcun effetto per altre modalità di viaggio.
unitSystem optional
Tipo:  UnitSystem optional
Predefinito:il sistema di unità utilizzato nel paese di origine.
Il sistema di unità di misura preferito da utilizzare per visualizzare la distanza.
waypoints optional
Tipo:  Array<DirectionsWaypoint> optional
Array di tappe intermedie. Le indicazioni vengono calcolate dall'origine alla destinazione passando per ogni waypoint di questo array. Per il numero massimo di tappe consentite, consulta la guida per gli sviluppatori. Le tappe intermedie non sono supportate per le indicazioni stradali con il trasporto pubblico. (Facoltativo)

Costanti DirectionsStatus

google.maps.DirectionsStatus costanti

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

Accesso chiamando il numero const {DirectionsStatus} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.

INVALID_REQUEST Il DirectionsRequest fornito non era valido.
MAX_WAYPOINTS_EXCEEDED Sono stati forniti troppi DirectionsWaypoint in DirectionsRequest. Per il numero massimo di tappe consentite, consulta la guida per gli sviluppatori.
NOT_FOUND Non è stato possibile geocodificare almeno uno dei punti di partenza, di destinazione o intermedi.
OK La risposta contiene un 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 di indicazioni stradali.
UNKNOWN_ERROR Una richiesta di indicazioni stradali non è stata elaborata a causa di un errore del server. Se riprovi, la richiesta potrebbe andare a buon fine.
ZERO_RESULTS Non è stato possibile trovare un percorso tra l'origine e la destinazione.

Interfaccia DirectionsResult

google.maps.DirectionsResult interfaccia

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

request
La DirectionsRequest che ha generato questo risultato.
routes
Un array di DirectionsRoute, ognuno dei quali contiene informazioni sulle tratte e sui passaggi di cui è composto. Verrà visualizzato un solo percorso, a meno che DirectionsRequest non sia stato creato con provideRouteAlternatives impostato su true.
available_travel_modes optional
Tipo:  Array<TravelMode> optional
Contiene una serie di modalità di trasporto disponibili. Questo campo viene restituito quando una richiesta specifica una modalità di viaggio e non vengono restituiti risultati. L'array contiene le modalità di viaggio disponibili nei paesi dell'insieme specificato di waypoint. Questo campo non viene restituito se uno o più waypoint sono "waypoint intermedi".
geocoded_waypoints optional
Un array di DirectionsGeocodedWaypoint, ognuno dei quali contiene informazioni sul geocoding di origine, destinazione e waypoint.

DirectionsRenderer class

google.maps.DirectionsRenderer classe

Visualizza le indicazioni stradali ottenute da DirectionsService.

Questo corso si estende MVCObject.

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

Interfaccia 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 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 delle route visualizzate da questo DirectionsRenderer.
hideRouteList optional
Tipo:  boolean optional
Predefinito: false
Questa proprietà indica se il renderer deve fornire un elenco di percorsi selezionabili dall'utente nel riquadro delle indicazioni.
infoWindow optional
Tipo:  InfoWindow optional
Il InfoWindow in cui visualizzare le informazioni di testo 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 i marcatori. Tutti i marcatori visualizzati da DirectionsRenderer utilizzeranno queste opzioni.
panel optional
Tipo:  HTMLElement optional
Il <div> in cui visualizzare i passaggi delle indicazioni.
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 se il centro e lo zoom della mappa non sono mai stati impostati, la mappa di input viene centrata e lo zoom viene impostato sul rettangolo di selezione di questo insieme di indicazioni.
routeIndex optional
Tipo:  number optional
L'indice della rotta all'interno dell'oggetto DirectionsResult. Il valore predefinito è 0.
suppressBicyclingLayer optional
Tipo:  boolean optional
Elimina il rendering di BicyclingLayer quando vengono richieste indicazioni stradali per biciclette.
suppressInfoWindows optional
Tipo:  boolean optional
Sopprimi il rendering delle finestre informative.
suppressMarkers optional
Tipo:  boolean optional
Elimina il rendering dei marcatori.
suppressPolylines optional
Tipo:  boolean optional
Sopprimi il rendering delle polilinee.

Interfaccia DirectionsWaypoint

google.maps.DirectionsWaypoint interfaccia

Un DirectionsWaypoint rappresenta una località tra l'origine e la destinazione attraverso la quale deve passare il viaggio.

location optional
Tipo:  string|LatLng|LatLngLiteral|Place optional
Posizione del waypoint. Può essere una stringa di indirizzo, un LatLng o un Place. (Facoltativo)
stopover optional
Tipo:  boolean optional
Predefinito: true
Se true, indica che questa tappa è una fermata tra l'origine e la destinazione. In questo modo, il percorso viene suddiviso in due tappe. Se false, indica che il percorso deve essere orientato a passare per questo waypoint, ma non deve essere suddiviso in due tappe. Ciò è utile se vuoi creare un percorso in risposta al trascinamento dei waypoint da parte dell'utente su una mappa.

Interfaccia DirectionsGeocodedWaypoint

google.maps.DirectionsGeocodedWaypoint interfaccia

Un singolo waypoint geocodificato.

partial_match optional
Tipo:  boolean optional
Se il geocodificatore non ha restituito una corrispondenza esatta per il waypoint originale, anche se è riuscito a trovare una corrispondenza per 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 di elemento geocodificato restituito. Per un elenco delle possibili stringhe, consulta la sezione Tipi di componenti di indirizzo della Guida per gli sviluppatori.

DirectionsRoute

google.maps.DirectionsRoute interfaccia

Un singolo itinerario contenente un insieme di tappe in un DirectionsResult. Tieni presente che, sebbene questo oggetto sia "simile a JSON", non è strettamente JSON, in quanto include direttamente e indirettamente oggetti LatLng.

bounds
Tipo:  LatLngBounds
I limiti di questo percorso.
copyrights
Tipo:  string
Testo dei diritti d'autore da visualizzare 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 intermedia o destinazione specificata. Pertanto, un itinerario senza waypoint di sosta conterrà un DirectionsLeg e un itinerario con un waypoint di sosta ne conterrà due.
overview_path
Tipo:  Array<LatLng>
Un array di LatLng che rappresentano l'intero percorso di questa rotta. Il percorso è semplificato per renderlo adatto a contesti in cui è richiesto un numero ridotto di vertici (ad esempio gli URL dell'API Static Maps).
overview_polyline
Tipo:  string
Una rappresentazione di polilinea codificata del percorso in overview_path. Questa polilinea è un percorso approssimativo (uniforme) delle indicazioni stradali risultanti.
summary
Tipo:  string
Contiene una breve descrizione testuale dell'itinerario, adatta per denominare e distinguere l'itinerario dalle alternative.
warnings
Tipo:  Array<string>
Avvisi da visualizzare quando vengono mostrate queste indicazioni.
waypoint_order
Tipo:  Array<number>
Se optimizeWaypoints è stato impostato su true, questo campo conterrà la permutazione riordinata dei waypoint di input. Ad esempio, se l'input era:
  Origine: Los Angeles
  Tappe intermedie: Dallas, Bangor, Phoenix
  Destinazione: New York
e l'output ottimizzato è stato ordinato nel seguente modo:
  Origine: Los Angeles
  Tappe intermedie: 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 uno dei waypoint di input ha stopover impostato su false, questo campo sarà vuoto, poiché l'ottimizzazione del percorso non è disponibile per queste query.
fare optional
Tipo:  TransitFare optional
La tariffa totale per l'intero viaggio con il trasporto pubblico. Valido solo per le richieste di trasporto pubblico.

Interfaccia DirectionsLeg

google.maps.DirectionsLeg interfaccia

Un singolo segmento costituito da un insieme di passaggi in un DirectionsResult. Alcuni campi della tratta potrebbero non essere restituiti per tutte le richieste. Tieni presente che, sebbene questo risultato sia "simile a JSON", non è strettamente JSON, in quanto include direttamente e indirettamente oggetti LatLng.

end_address
Tipo:  string
L'indirizzo della destinazione di questa 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 le località utilizzando l'opzione di trasporto più vicina (di solito una strada) nelle località di partenza e di arrivo. end_location indica la destinazione geocodificata effettiva, che potrebbe essere diversa da end_location dell'ultima tappa se, ad esempio, la strada non è vicina alla destinazione di questa tratta.
start_address
Tipo:  string
L'indirizzo dell'origine di questa tratta. 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 le località utilizzando l'opzione di trasporto più vicina (di solito una strada) nelle località di partenza e di arrivo. start_location indica l'origine geocodificata effettiva, che potrebbe essere diversa da start_location del primo passaggio se, ad esempio, la strada non è vicina all'origine di questa tratta.
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 tappa.
via_waypoints
Tipo:  Array<LatLng>
Un array di tappe intermedie senza sosta lungo questa tratta, specificate nella richiesta originale.

Deprecata negli itinerari alternativi. La versione 3.27 sarà l'ultima versione dell'API che aggiunge via_waypoints extra nei percorsi alternativi.

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

arrival_time optional
Tipo:  Time optional
Un orario di arrivo stimato per questa tratta. Valido solo per le richieste TRANSIT.
departure_time optional
Tipo:  Time optional
Un orario di partenza stimato per questa tratta. Valido solo per le richieste TRANSIT.
distance optional
Tipo:  Distance optional
La distanza totale percorsa in questa tratta. Questa proprietà potrebbe non essere definita perché la distanza potrebbe essere sconosciuta.
duration optional
Tipo:  Duration optional
La durata totale di questa tratta. Questa proprietà potrebbe essere undefined in quanto 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 in quanto la durata potrebbe essere sconosciuta.

Interfaccia DirectionsStep

google.maps.DirectionsStep interfaccia

Un singolo DirectionsStep in un DirectionsResult. Alcuni campi potrebbero essere undefined. Tieni presente che, sebbene questo oggetto sia "simile a JSON", non è strettamente JSON, in quanto include direttamente oggetti LatLng.

encoded_lat_lngs
Tipo:  string
Una rappresentazione di polilinea codificata del passaggio. Questo è il percorso approssimativo (uniforme) del passo.
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 descrivono il corso di questo passaggio. Questo è il percorso approssimativo (uniforme) del passo.
maneuver
Tipo:  string
Contiene l'azione da intraprendere per il passaggio corrente (turn-left, merge, straight e così via). I valori sono soggetti a modifiche e potrebbero essere introdotti nuovi valori senza preavviso.
path
Tipo:  Array<LatLng>
Una sequenza di LatLng che descrivono il corso di questo passaggio. Questo è il percorso approssimativo (uniforme) del passo.
start_location
Tipo:  LatLng
La posizione di partenza di questo passaggio.
start_point
Tipo:  LatLng
La posizione di partenza di questo passaggio.
travel_mode
Tipo:  TravelMode
La modalità di viaggio utilizzata in questo passaggio.
distance optional
Tipo:  Distance optional
La distanza percorsa in questo passo. Questa proprietà potrebbe essere undefined in quanto la distanza potrebbe essere sconosciuta.
duration optional
Tipo:  Duration optional
Il tempo tipico necessario per eseguire questo passaggio, espresso in secondi e sotto forma di testo. Questa proprietà potrebbe essere undefined in quanto la durata potrebbe essere sconosciuta.
polyline optional
Tipo:  DirectionsPolyline optional
Contiene un oggetto con una singola proprietà, "points", che contiene una rappresentazione della tappa come polilinea codificata. Questa polilinea è un percorso approssimativo (uniforme) del passo.
steps optional
Tipo:  Array<DirectionsStep> optional
Sottopassaggi di questo passaggio. Specificato per le sezioni non di trasporto pubblico delle linee di trasporto pubblico.
transit optional
Tipo:  TransitDetails optional
Dettagli specifici per il 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

google.maps.DirectionsPolyline interfaccia

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

points
Tipo:  string

Interfaccia Luogo

google.maps.Place interfaccia

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

location optional
Tipo:  LatLng|