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 ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventi | |
---|---|
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
.
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 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.
Proprietà | |
---|---|
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.
Proprietà | |
---|---|
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
.
Proprietà | |
---|---|
bounds |
Tipo:
LatLngBounds I limiti di questo percorso. |
copyrights |
Tipo:
string Testo dei diritti d'autore da visualizzare per questo percorso. |
legs |
Tipo:
Array<DirectionsLeg> 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 |
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
.
Proprietà | |
---|---|
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 |
Tipo:
Array<DirectionsStep> Un array di DirectionsStep , ognuno dei quali contiene informazioni sui singoli passaggi di questa tratta. |
|
Tipo:
Array<?> Informazioni sulla velocità del traffico lungo la tappa. |
via_waypoints |
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 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
.
Proprietà | |
---|---|
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. |
|
Tipo:
LatLng La posizione finale di questo passaggio. |
instructions |
Tipo:
string Istruzioni per questo passaggio. |
|
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 |
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. |
|
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. |
|
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
.
Proprietà | |
---|---|
points |
Tipo:
string Una polilinea codificata. |
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
.
Proprietà | |
---|---|
location optional |
Tipo:
LatLng|LatLngLiteral optional Il LatLng dell'entità descritta da questo luogo. |
placeId optional |
Tipo:
string optional L'ID luogo del luogo (ad esempio un'attività 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 . Un ID luogo può essere recuperato da qualsiasi richiesta all'API Places, ad esempio una TextSearch. Gli ID luogo possono essere recuperati anche dalle richieste all'API Geocoding. Per saperne di più, consulta la panoramica degli ID luogo. |
query optional |
Tipo:
string optional Una query di ricerca che descrive il luogo (ad esempio un'attività o un punto d'interesse). Un esempio di query è "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 un luogo. Se vengono forniti sia placeId che query , si verifica un errore. |
Costanti TravelMode
google.maps.TravelMode
costanti
Le modalità di viaggio valide che possono essere specificate in un DirectionsRequest
, nonché le modalità di viaggio restituite in un DirectionsStep
. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'BICYCLING'
o google.maps.TravelMode.BICYCLING
.
Accesso chiamando il numero const {TravelMode} = await google.maps.importLibrary("routes")
.
Consulta 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
google.maps.DrivingOptions
interfaccia
Configura DirectionsRequest
quando la modalità viaggio è impostata su DRIVING
.
Proprietà | |
---|---|
departureTime |
Tipo:
Date L'orario di partenza desiderato per l'itinerario, specificato come oggetto Date . L'oggetto Date misura il tempo in millisecondi a partire dal 1° gennaio 1970. Questo valore deve essere specificato per la validità di un DrivingOptions . L'ora di partenza deve essere impostata sull'ora corrente o su un'ora futura. Non può essere antecedente alla data corrente. |
trafficModel optional |
Tipo:
TrafficModel optional L'ipotesi preferita da utilizzare per prevedere la durata nel traffico. Il valore predefinito è BEST_GUESS . |
TrafficModel costanti
google.maps.TrafficModel
costanti
I presupposti da utilizzare per prevedere la durata nel traffico. Specificato come parte di un DirectionsRequest
o DistanceMatrixRequest
. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'bestguess'
o google.maps.TrafficModel.BEST_GUESS
.
Accesso chiamando il numero const {TrafficModel} = await google.maps.importLibrary("routes")
.
Consulta 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 viaggio nel traffico. |
PESSIMISTIC |
Utilizza i dati storici sul traffico per fare una stima pessimistica della durata nel traffico. |
Interfaccia TransitOptions
google.maps.TransitOptions
interfaccia
L'oggetto TransitOptions da includere in un DirectionsRequest
quando la modalità di viaggio è impostata su TRANSIT.
Proprietà | |
---|---|
arrivalTime optional |
Tipo:
Date optional L'ora di arrivo desiderata per l'itinerario, specificata come oggetto Date. L'oggetto Date misura il tempo in millisecondi a partire dal 1° gennaio 1970. Se viene specificato l'orario di arrivo, l'orario di partenza viene ignorato. |
departureTime optional |
Tipo:
Date optional L'ora di partenza desiderata per l'itinerario, specificata come oggetto Date. L'oggetto Date misura il tempo in millisecondi a partire dal 1° gennaio 1970. Se non viene specificato né l'orario di partenza né quello di arrivo, si presume che l'orario 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 il percorso migliore predefinito. |
routingPreference optional |
Tipo:
TransitRoutePreference optional Una preferenza che può influenzare la scelta del percorso con il trasporto pubblico, ad esempio camminare di meno. Se non viene specificata alcuna preferenza, l'API restituisce il percorso migliore predefinito. |
Costanti TransitMode
google.maps.TransitMode
costanti
La modalità di trasporto valida, ad esempio l'autobus, che può essere specificata in un TransitOptions
. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'BUS'
o google.maps.TransitMode.BUS
.
Accesso chiamando il numero const {TransitMode} = await google.maps.importLibrary("routes")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
BUS |
Specifica l'autobus come mezzo di trasporto pubblico preferito. |
RAIL |
Specifica la ferrovia come modalità di trasporto pubblico preferita. |
SUBWAY |
Specifica la metropolitana come modalità di trasporto pubblico preferita. |
TRAIN |
Specifica il treno come modalità di trasporto pubblico preferita. |
TRAM |
Specifica il tram come modalità di trasporto pubblico preferita. |
Costanti TransitRoutePreference
google.maps.TransitRoutePreference
costanti
Il tipo di itinerario di transito valido che può essere specificato in un TransitOptions
. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'LESS_WALKING'
o google.maps.TransitRoutePreference.LESS_WALKING
.
Accesso chiamando il numero const {TransitRoutePreference} = await google.maps.importLibrary("routes")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
FEWER_TRANSFERS |
Specifica che l'itinerario calcolato deve preferire un numero limitato di trasferimenti. |
LESS_WALKING |
Specifica che il percorso calcolato deve preferire tratti a piedi limitati. |
Interfaccia TransitFare
google.maps.TransitFare
interfaccia
Una tariffa di DirectionsRoute
composta da valore e valuta.
Proprietà | |
---|---|
currency |
Tipo:
string Un codice valuta ISO 4217 che indica la valuta in cui è espressa la tariffa. |
text |
Tipo:
string Il valore della tariffa, espresso nella currency specificata, come stringa. |
value |
Tipo:
number Il valore numerico della tariffa, espresso nella currency indicata. |
Interfaccia TransitDetails
google.maps.TransitDetails
interfaccia
Dettagli sulla partenza, sull'arrivo e sul mezzo di trasporto utilizzato 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 del trasporto pubblico. |
departure_time |
Tipo:
Time L'orario di partenza di questo passaggio, specificato come oggetto Time. |
headsign |
Tipo:
string La direzione in cui viaggiare su questa linea, come indicato sul veicolo o alla fermata di partenza. |
headway |
Tipo:
number Il numero previsto di secondi tra veicoli equivalenti a 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 nei tabelloni per identificare un viaggio di transito per i passeggeri, ad esempio per identificare i numeri dei treni per i viaggi in treno pendolari. Il testo identifica in modo univoco una corsa all'interno di un giorno di servizio. |
Interfaccia TransitStop
google.maps.TransitStop
interfaccia
Dettagli su una fermata o una 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 TransitLine
google.maps.TransitLine
interfaccia
Informazioni sulla linea di trasporto pubblico che opera 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 stringa esadecimale. |
icon |
Tipo:
string L'URL di un'icona associata a questa riga. |
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 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 TransitAgency
google.maps.TransitAgency
interfaccia
Informazioni su un'azienda che gestisce una linea di trasporto pubblico.
Proprietà | |
---|---|
name |
Tipo:
string Il nome di questa 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
google.maps.TransitVehicle
interfaccia
Informazioni sul veicolo che opera su una linea di trasporto pubblico.
Proprietà | |
---|---|
icon |
Tipo:
string Un URL per un'icona che corrisponde al tipo di veicolo utilizzato su questa linea. |
local_icon |
Tipo:
string Un URL per un'icona corrispondente al tipo di veicolo utilizzato in questa regione anziché l'icona più generica. |
name |
Tipo:
string Un nome per questo tipo di TransitVehicle, ad esempio "Treno" o "Autobus". |
type |
Tipo:
VehicleType Il tipo di veicolo utilizzato, ad esempio treno, autobus o traghetto. |
Costanti VehicleType
google.maps.VehicleType
costanti
Valori possibili per i tipi di veicolo.
Accesso chiamando il numero const {VehicleType} = await google.maps.importLibrary("routes")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
BUS |
Autobus. |
CABLE_CAR |
Un veicolo che funziona con un cavo, di solito a terra. Le funivie possono essere di tipo GONDOLA_LIFT . |
COMMUTER_TRAIN |
Ferrovia suburbana. |
FERRY |
Traghetto. |
FUNICULAR |
Un veicolo che viene tirato su una ripida salita da un cavo. |
GONDOLA_LIFT |
Una funivia. |
HEAVY_RAIL |
Ferrovia pesante. |
HIGH_SPEED_TRAIN |
Treno ad alta velocità. |
INTERCITY_BUS |
Autobus interurbano. |
METRO_RAIL |
Metropolitana leggera. |
MONORAIL |
Monorail. |
OTHER |
Altri veicoli. |
RAIL |
Ferrovia. |
SHARE_TAXI |
Il taxi condiviso è una sorta di trasporto in autobus con la possibilità di far salire e scendere i passeggeri ovunque lungo il percorso. In genere, i taxi condivisi utilizzano minibus. |
SUBWAY |
Metropolitana leggera sotterranea. |
TRAM |
Metropolitana leggera di superficie. |
TROLLEYBUS |
Filobus. |
Costanti UnitSystem
google.maps.UnitSystem
costanti
I sistemi di unità validi che possono essere specificati in un DirectionsRequest
.
Accesso chiamando il numero const {UnitSystem} = await google.maps.importLibrary("core")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
IMPERIAL |
Specifica che le distanze in DirectionsResult devono essere espresse in unità imperiali. |
METRIC |
Specifica che le distanze in DirectionsResult devono essere espresse in unità metriche. |
Interfaccia Distanza
google.maps.Distance
interfaccia
Una rappresentazione della distanza come valore numerico e stringa di visualizzazione.
Proprietà | |
---|---|
text |
Tipo:
string Una rappresentazione stringa del valore della distanza, utilizzando UnitSystem specificato nella richiesta. |
value |
Tipo:
number La distanza in metri. |
Durata interfaccia
google.maps.Duration
interfaccia
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
google.maps.Time
interfaccia
Una rappresentazione dell'ora come oggetto Date, una stringa localizzata e un 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 questa 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 JavaScript Date. |
Costanti DirectionsTravelMode
google.maps.DirectionsTravelMode
costanti
Costanti DirectionsUnitSystem
google.maps.DirectionsUnitSystem
costanti