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.
Costruttore | |
---|---|
DirectionsService |
DirectionsService() Parametri: nessuno
Crea una nuova istanza di un DirectionsService che invia query di indicazioni stradali ai server di Google. |
Metodi | |
---|---|
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
.
Proprietà | |
---|---|
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.
Costanti | |
---|---|
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
.
Proprietà | |
---|---|
request |
Tipo:
DirectionsRequest La DirectionsRequest che ha generato questo risultato. |
routes |
Tipo:
Array<DirectionsRoute> 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 |
Tipo:
Array<DirectionsGeocodedWaypoint> 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.
Costruttore | |
---|---|
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). |
Metodi | |
---|---|
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:
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 ,
|