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,