DirectionsService
google.maps.DirectionsService
classe
Un servizio per calcolare indicazioni stradali tra due o più luoghi.
Accedi chiamando const {DirectionsService} = await google.maps.importLibrary("routes")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
DirectionsService |
DirectionsService() Parametri: nessuno
Crea una nuova istanza di DirectionsService che invia query sulle indicazioni stradali ai server di Google. |
Metodi | |
---|---|
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
.
Proprietà | |
---|---|
destination |
Tipo:
string|LatLng|Place|LatLngLiteral Località di destinazione. Questa può essere specificata come stringa da geocodificare oppure come LatLng o Place . Obbligatorio. |
origin |
Tipo:
string|LatLng|Place|LatLngLiteral Località di origine. Questa può essere specificata come stringa da geocodificare oppure come LatLng o Place . Obbligatorio. |
travelMode |
Tipo:
TravelMode Tipo di routing richiesto. Obbligatorio. |
avoidFerries optional |
Tipo:
boolean optional Se true , indica al servizio Indicazioni stradali 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, ove possibile. Campo 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 L'identificatore della 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 punti 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 indicare o meno alternative di percorso. Campo facoltativo. |
region optional |
Tipo:
string optional Codice della regione utilizzato come bias per le richieste di geocodifica. Il codice regione accetta un valore di due caratteri per il 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 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à alcun effetto per altre modalità di viaggio. |
unitSystem optional |
Tipo:
UnitSystem optional Predefinita: il sistema di unità utilizzato nel paese di origine.
Sistema di unità preferito da utilizzare per visualizzare la distanza. |
waypoints optional |
Tipo:
Array<DirectionsWaypoint> optional Array di tappe intermedi. Le indicazioni stradali sono calcolate dal punto di partenza alla destinazione utilizzando ogni tappa in questa matrice. Consulta la guida per gli sviluppatori per conoscere il numero massimo di tappe consentite. I Waypoint non sono supportati per le indicazioni di trasporto pubblico. Campo facoltativo. |
costanti DirectionsStatus
google.maps.DirectionsStatus
costanti
Lo stato restituito da DirectionsService
al completamento di una chiamata a route()
. Specificale in base a un 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.
Costanti | |
---|---|
INVALID_REQUEST |
Il DirectionsRequest fornito non è valido. |
MAX_WAYPOINTS_EXCEEDED |
È stato fornito un numero eccessivo di DirectionsWaypoint in DirectionsRequest . Consulta la guida per gli sviluppatori per conoscere il numero massimo di tappe consentite. |
NOT_FOUND |
Non è stato possibile geocodificare almeno uno dei punti di partenza, di destinazione o dei tappe. |
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 di indicazioni stradali. |
UNKNOWN_ERROR |
Impossibile elaborare una richiesta di indicazioni stradali a causa di un errore del server. Se riprovi, la richiesta potrebbe andare a buon fine. |
ZERO_RESULTS |
Impossibile trovare un 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 elemento DirectionsRenderer
oppure 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, anche se il risultato è di tipo "JSON-like", non è strettamente JSON, poiché include indirettamente oggetti LatLng
.
Proprietà | |
---|---|
request |
Tipo:
DirectionsRequest Il valore DirectionsRequest che ha restituito questo risultato. |
routes |
Tipo:
Array<DirectionsRoute> Un array di DirectionsRoute , ciascuno dei quali contiene informazioni sui segmenti e sui passaggi di cui è composto. Ci sarà 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 viaggio disponibili. Questo campo viene restituito quando una richiesta specifica una modalità di viaggio e non riceve risultati. L'array contiene le modalità di viaggio disponibili nei paesi dell'insieme di tappe specificato. Questo campo non viene restituito se uno o più tappe sono "tramite tappe". |
geocoded_waypoints optional |
Tipo:
Array<DirectionsGeocodedWaypoint> optional Un array di DirectionsGeocodedWaypoint , ciascuno dei quali contiene informazioni sulla geocodifica dell'origine, della destinazione e dei tappe. |
DirectionsRenderer
google.maps.DirectionsRenderer
classe
Visualizza le indicazioni ottenute da DirectionsService
.
Questa classe estende
MVCObject
.
Accedi chiamando const {DirectionsRenderer} = await google.maps.importLibrary("routes")
. Consulta la sezione 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 in aggiunta su un riquadro <div> (come istruzioni testuali). |
Metodi | |
---|---|
getDirections |
getDirections() Parametri: nessuno
Valore restituito:
DirectionsResult Restituisce l'insieme corrente di direzioni 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 eseguito il rendering di DirectionsResult . |
getRouteIndex |
getRouteIndex() Parametri: nessuno
Valore restituito:
number Restituisce l'indice di route corrente (in base a zero) in uso per questo oggetto DirectionsRenderer . |
setDirections |
setDirections(directions) Parametri:
Valore restituito: nessuno
Imposta il renderer in modo che utilizzi il risultato di DirectionsService . Se imposti un insieme valido di direzioni in questo modo, le direzioni verranno visualizzate nella 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. Supera null per rimuovere le indicazioni stradali 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 indicazioni stradali in un elemento <div> . Passa null per rimuovere i contenuti dal riquadro. |
setRouteIndex |
setRouteIndex(routeIndex) Parametri:
Valore restituito: nessuno
Imposta l'indice (in base zero) della route nell'oggetto DirectionsResult di cui eseguire il rendering. Per impostazione predefinita, viene visualizzata la prima route nell'array. |
Ereditati:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventi | |
---|---|
directions_changed |
function() Argomenti: nessuno
Questo evento viene attivato quando le indicazioni stradali visualizzate cambiano, quando viene impostato un nuovo elemento DirectionsResult o quando l'utente termina di trascinare una modifica al percorso delle indicazioni stradali. |
Interfaccia DirectionsRendererOptions
Interfaccia google.maps.DirectionsRendererOptions
Questo oggetto definisce le proprietà che possono essere impostate su un oggetto DirectionsRenderer
.
Proprietà | |
---|---|
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 da questo DirectionsRenderer . |
hideRouteList optional |
Tipo:
boolean optional Valore predefinito:
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 InfoWindow in cui visualizzare le informazioni di testo quando viene fatto clic su un indicatore. I contenuti esistenti della finestra informativa verranno sovrascritti e la relativa 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 Valore predefinito:
false Se questa opzione è impostata su true o se il centro della mappa e lo zoom non sono mai stati impostati, la mappa di input viene centrata e ingrandita fino al riquadro di delimitazione di questo insieme di indicazioni stradali. |
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 Sopprime il rendering delle finestre informative. |
suppressMarkers optional |
Tipo:
boolean optional Elimina la visualizzazione degli indicatori. |
suppressPolylines optional |
Tipo:
boolean optional Elimina la visualizzazione delle polilinee. |
Interfaccia DirectionsWaypoint
Interfaccia google.maps.DirectionsWaypoint
Un DirectionsWaypoint
rappresenta una località compresa tra l'origine e la destinazione attraverso la quale deve essere instradato la corsa.
Proprietà | |
---|---|
location optional |
Tipo:
string|LatLng|LatLngLiteral|Place optional Posizione del Waypoint. Può essere una stringa di indirizzo, un LatLng o un Place . Campo facoltativo. |
stopover optional |
Tipo:
boolean optional Valore predefinito:
true Se true , indica che questo tappe è una fermata tra il luogo di partenza e la destinazione. Questo ha l'effetto di dividere il percorso in due tratti. Se false , indica che il percorso non deve essere diviso in due tratti, ma non deve essere diviso in due tratti. Questa operazione è utile se vuoi creare un percorso in risposta all'utente che trascina i punti su una mappa. |
Interfaccia DirectionsGeocodedWaypoint
Interfaccia google.maps.DirectionsGeocodedWaypoint
Un singolo Waypoint geocodificato.
Proprietà | |
---|---|
partial_match optional |
Tipo:
boolean optional Indica se il geocodificatore non ha restituito una corrispondenza esatta per il Waypoint originale, anche se è riuscita a far corrispondere una parte dell'indirizzo richiesto. |
place_id optional |
Tipo:
string optional L'ID luogo associato al percorso. 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 per gli indirizzi della Guida per gli sviluppatori. |
Interfaccia di DirectionsRoute
Interfaccia google.maps.DirectionsRoute
Un singolo percorso contenente una serie di tappe in un DirectionsResult
. Tieni presente che, sebbene l'oggetto sia di tipo "JSON-like", non è strettamente JSON, poiché include direttamente e indirettamente oggetti LatLng
.
Proprietà | |
---|---|
bounds |
Tipo:
LatLngBounds I limiti di questo percorso. |
copyrights |
Tipo:
string Testo copyright da visualizzare per questo percorso. |
legs |
Tipo:
Array<DirectionsLeg> Un array di DirectionsLeg , ciascuno 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 tappe con tappe conterrà un DirectionsLeg e un percorso con un tappeto di sosta ne conterrà due. |
overview_path |
Un array di LatLng che rappresenta l'intero percorso di questa route. 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 del percorso in overview_path. Questa polilinea è un percorso approssimativo (attenuato) delle direzioni risultanti. |
summary |
Tipo:
string Contiene una breve descrizione testuale del percorso, utile per assegnargli un nome e distinguerlo dalle alternative. |
warnings |
Tipo:
Array<string> Avvisi da visualizzare quando vengono mostrate queste indicazioni stradali. |
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 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à una Array con i valori [2], 0, 1 Tieni presente che la numerazione delle tappe è in base zero.Se per uno dei Waypoint di input è stato impostato il valore stopover 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 viaggio con il trasporto pubblico. Applicabile solo alle richieste di trasporto pubblico. |
Interfaccia DirectionsLeg
Interfaccia google.maps.DirectionsLeg
Una singola gamba composta da una serie di passi in un DirectionsResult
. Alcuni campi nella gamba potrebbero non essere restituiti per tutte le richieste. Tieni presente che, anche se questo risultato è di tipo "JSON-like", non è strettamente JSON, poiché include direttamente e indirettamente oggetti LatLng
.
Proprietà | |
---|---|
end_address |
Tipo:
string L'indirizzo della destinazione di questa tratta. Questi contenuti sono pensati per 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) nelle posizioni di partenza e di arrivo. end_location indica la destinazione effettiva 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 gamba. Questi contenuti sono pensati per 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) nelle 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 si trova vicino all'origine del tratto. |
steps |
Tipo:
Array<DirectionsStep> Un array di DirectionsStep , ciascuno dei quali contiene informazioni sui singoli passaggi di questa sezione. |
|
Tipo:
Array<?> Informazioni sulla velocità del traffico lungo il tratto. |
via_waypoints |
Un array di tappe senza scali lungo questo tratto, specificati nella richiesta originale. Deprecato in percorsi alternativi. La versione 3.27 sarà l'ultima versione dell'API che aggiunge Quando utilizzi il servizio Indicazioni stradali per implementare direzioni trascinabili, ti consigliamo di disattivare il trascinamento di percorsi alternativi. Solo il percorso principale deve essere trascinabile. Gli utenti possono trascinare il percorso principale finché non corrisponde a un percorso alternativo. |
arrival_time optional |
Tipo:
Time optional L'ora di arrivo prevista per questa tratta. Applicabile solo per le richieste TRANSIT. |
departure_time optional |
Tipo:
Time optional L'orario di partenza stimato per questa tratta. Applicabile solo per le richieste TRANSIT. |
distance optional |
Tipo:
Distance optional La distanza totale percorsa 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 questo tratto, tenendo conto delle condizioni del traffico indicate dalla proprietà trafficModel . Questa proprietà potrebbe essere undefined perché la durata potrebbe essere sconosciuta. |
Interfaccia di DirectionsStep
Interfaccia google.maps.DirectionsStep
Un singolo DirectionsStep
in un DirectionsResult
. Alcuni campi potrebbero essere undefined
. Tieni presente che, anche se l'oggetto è di tipo "JSON-like", non è strettamente JSON, in quanto include direttamente gli oggetti LatLng
.
Proprietà | |
---|---|
encoded_lat_lngs |
Tipo:
string Una rappresentazione della polilinea codificata del passaggio. Questo è un percorso approssimativo (attenuato) del passaggio. |
end_location |
Tipo:
LatLng La posizione finale di questo passaggio. |
|
Tipo:
LatLng La posizione finale di questo passaggio. |
instructions |
Tipo:
string Istruzioni per questo passaggio. |
|
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 potrebbero essere introdotti nuovi valori senza preavviso. |
path |
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. |
|
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 in 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 in formato testo. Questa proprietà potrebbe essere undefined perché la durata potrebbe essere sconosciuta. |
|
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 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 specifici per il trasporto pubblico su questo passaggio. Questa proprietà non verrà 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 una DirectionsStep
.
Proprietà | |
---|---|
points |
Tipo:
string Una polilinea codificata. |
Interfaccia Place
Interfaccia google.maps.Place
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à commerciale, un punto d'interesse o una posizione geografica. Per recuperare le informazioni su un luogo, vedi PlacesService
.
Proprietà | |
---|---|
location optional |
Tipo:
LatLng|LatLngLiteral optional Il valore 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 è 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 anziché query . L'ID luogo può essere recuperato da qualsiasi richiesta all'API Places, ad esempio da 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é query . L'API non garantisce l'accuratezza della risoluzione della stringa di query in una posizione. Se vengono forniti sia placeId che query , si verifica un errore. |
TravelMode, costanti
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
. Specificale in base a un 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.
Costanti | |
---|---|
BICYCLING |
Specifica una richiesta di indicazioni stradali in bicicletta. |
DRIVING |
Specifica una richiesta di indicazioni stradali. |
TRANSIT |
Specifica una richiesta di indicazioni per il trasporto pubblico. |
WALKING |
Specifica una richiesta di indicazioni a piedi. |
Interfaccia DrivingOptions
Interfaccia google.maps.DrivingOptions
Consente di configurare DirectionsRequest
quando la modalità di viaggio è impostata su DRIVING
.
Proprietà | |
---|---|
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. È necessario specificare questo valore affinché un DrivingOptions sia valido. L'orario di partenza deve essere impostato sull'ora corrente o su un orario 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. Specificato come parte di DirectionsRequest
o DistanceMatrixRequest
. Specificale in base a un 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.
Costanti | |
---|---|
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 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.
Proprietà | |
---|---|
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 viene specificato un orario di arrivo, quello di partenza viene ignorato. |
departureTime optional |
Tipo:
Date optional L'orario di partenza desiderato per il percorso, specificato come oggetto Date. L'oggetto Data misura il tempo in millisecondi dal 1° gennaio 1970. Se non vengono specificati né l'orario di partenza né quello 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 specificata 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 specificata alcuna preferenza, l'API restituisce la route migliore predefinita. |
Costanti TransitMode
google.maps.TransitMode
costanti
La modalità di trasporto pubblico valida, ad esempio bus, che può essere specificata in una TransitOptions
. Specificale in base a un 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.
Costanti | |
---|---|
BUS |
Specifica il bus come modalità di trasporto pubblico preferita. |
RAIL |
Specifica la ferrovia come modalità di trasporto pubblico preferita. |
SUBWAY |
Specifica la metropolitana come mezzo di trasporto pubblico preferito. |
TRAIN |
Specifica il treno come modalità di trasporto pubblico preferita. |
TRAM |
Specifica il tram come mezzo di trasporto pubblico preferito. |
Costanti TransitRoutePreference
google.maps.TransitRoutePreference
costanti
Il tipo di percorso di trasporto pubblico valido che può essere specificato in una TransitOptions
. Specificale in base a un 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.
Costanti | |
---|---|
FEWER_TRANSFERS |
Specifica che il percorso calcolato deve preferire un numero limitato di cambi. |
LESS_WALKING |
Specifica che il percorso calcolato deve preferire tratti a piedi limitati. |
Interfaccia TransitFare
Interfaccia google.maps.TransitFare
Tariffa di DirectionsRoute
, composta da valore e valuta.
Proprietà | |
---|---|
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 utilizzate in questo passaggio.
Proprietà | |
---|---|
arrival_stop |
Tipo:
TransitStop 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 |
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 fermate in questo passaggio. Include la fermata di arrivo, ma non quella di partenza. |
trip_short_name |
Tipo:
string Il testo visualizzato negli orari e sui cartelli per identificare una corsa con il trasporto pubblico per i passeggeri, ad esempio per identificare i numeri di treno per le corse ferroviarie pendolari. Il testo identifica in modo univoco una corsa all'interno di un giorno di servizio. |
Interfaccia di TransitStop
Interfaccia google.maps.TransitStop
Dettagli su una fermata o stazione di trasporto pubblico.
Proprietà | |
---|---|
location |
Tipo:
LatLng La posizione di questa fermata. |
name |
Tipo:
string Il nome di questa fermata del trasporto pubblico. |
Interfaccia di TransitLine
Interfaccia google.maps.TransitLine
Informazioni sulla linea di trasporto pubblico che gestisce questo passaggio.
Proprietà | |
---|---|
agencies |
Tipo:
Array<TransitAgency> 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 come 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 della 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, specifico per questa linea di trasporto pubblico. |
vehicle |
Tipo:
TransitVehicle 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.
Proprietà | |
---|---|
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 Transit Vehicle
Interfaccia google.maps.TransitVehicle
Informazioni sul veicolo su una linea di trasporto pubblico.
Proprietà | |
---|---|
icon |
Tipo:
string L'URL di un'icona corrispondente 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 Mezzo di trasporto, ad esempio "Treno" o "Bus". |
type |
Tipo:
VehicleType Il tipo di veicolo utilizzato, ad esempio treno, autobus o traghetto. |
VehicleType costanti
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.
Costanti | |
---|---|
BUS |
Autobus. |
CABLE_CAR |
Un veicolo che funziona tramite cavo, solitamente a terra. Le funivie aeree possono essere del tipo GONDOLA_LIFT . |
COMMUTER_TRAIN |
Ferrovia suburbana. |
FERRY |
Traghetto. |
FUNICULAR |
Veicolo trainato da un cavo su una ripida pendenza. |
GONDOLA_LIFT |
Una funivia. |
HEAVY_RAIL |
Treno pesante. |
HIGH_SPEED_TRAIN |
Treno ad alta velocità. |
INTERCITY_BUS |
Autolinee regionali e nazionali. |
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 scendere e far salire a bordo passeggeri in qualsiasi punto del percorso. In genere i taxi condivisi utilizzano minibus. |
SUBWAY |
Metropolitana leggera sotterranea. |
TRAM |
Metropolitana leggera sopra il suolo. |
TROLLEYBUS |
Filobus. |
Costanti 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.
Costanti | |
---|---|
IMPERIAL |
Specifica che le distanze nell'elemento DirectionsResult devono essere espresse in unità imperiali. |
METRIC |
Specifica che le distanze in DirectionsResult devono essere espresse in unità metriche. |
Interfaccia Distanza
Interfaccia google.maps.Distance
Una rappresentazione della distanza sotto forma di valore numerico e stringa di visualizzazione.
Proprietà | |
---|---|
text |
Tipo:
string Una rappresentazione stringa del valore della distanza, utilizzando 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.
Proprietà | |
---|---|
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.
Proprietà | |
---|---|
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 Data JavaScript. |
costanti DirectionsTravelMode
google.maps.DirectionsTravelMode
costanti
Costanti DirectionsUnitSystem
google.maps.DirectionsUnitSystem
costanti