Classe DirectionsService
lezione google.maps.DirectionsService
Un servizio per il calcolo di indicazioni stradali tra due o più luoghi.
Quando usi v=beta
, puoi accedervi chiamando const {DirectionsService} = await google.map.importLibrary("routes")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
DirectionsService |
DirectionsService() Parametri: nessuno
Crea una nuova istanza di DirectionsService che invia query di indicazioni stradali ai server di Google. |
Metodi | |
---|---|
route |
route(request[, callback]) Parametri:
Valore restituito:
Promise<DirectionsResult> Invia una richiesta di ricerca delle indicazioni stradali. |
Interfaccia di DirectionsRequest
google.maps.DirectionsRequest
interfaccia
Una query di indicazioni stradali da inviare a DirectionsService
.
Proprietà | |
---|---|
destination |
Tipo:
string|LatLng|Place|LatLngLiteral Località di destinazione. Può essere specificato come stringa da geocodificare, LatLng o Place . Obbligatorio. |
origin |
Tipo:
string|LatLng|Place|LatLngLiteral Località di origine. Può essere specificato come stringa da geocodificare, LatLng o Place . Obbligatorio. |
travelMode |
Tipo:
TravelMode Tipo di routing richiesto. Obbligatorio. |
avoidFerries optional |
Tipo:
boolean optional Se true , indica al servizio Directions di evitare i traghetti, ove possibile. (Facoltativo) |
avoidHighways optional |
Tipo:
boolean optional Se true , indica al servizio Directions di evitare le autostrade, se possibile. (Facoltativo) |
avoidTolls optional |
Tipo:
boolean optional Se true , indica al servizio Indicazioni stradali di evitare 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à effetto per le altre modalità di viaggio. |
language optional |
Tipo:
string optional L'identificatore della lingua della 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 proverà a riordinare i punti intermedi 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. (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 ("primo livello dominio"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune notevoli eccezioni. Ad esempio, il ccTLD del Regno Unito è "uk" ( .co.uk ) mentre il codice ISO 3166-1 è "gb" (tecnicamente per l'entità del "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à effetto per le altre modalità di viaggio. |
unitSystem optional |
Tipo:
UnitSystem optional Predefinito: il sistema di unità utilizzato nel paese di origine.
Sistema di unità preferito da usare per la visualizzazione della distanza. |
waypoints optional |
Tipo:
Array<DirectionsWaypoint> optional Array di tappe intermedie. Le indicazioni stradali vengono calcolate dall'origine alla destinazione in base a ciascun punto di via in questo array. Per il numero massimo di tappe consentiti, consulta la guida per gli sviluppatori. I Waypoint non sono supportati per le indicazioni stradali di trasporto pubblico. (Facoltativo) |
Costanti di DirectionsStatus
google.maps.DirectionsStatus
costanti
Lo stato restituito da DirectionsService
al termine di una chiamata al numero route()
. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'OK'
o google.maps.DirectionsStatus.OK
.
Quando usi v=beta
, puoi accedervi chiamando const {DirectionsStatus} = await google.map.importLibrary("routes")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
INVALID_REQUEST |
Il campo DirectionsRequest fornito non era valido. |
MAX_WAYPOINTS_EXCEEDED |
Sono stati forniti troppi DirectionsWaypoint nella DirectionsRequest . Per il numero massimo di tappe consentiti, consulta la guida per gli sviluppatori. |
NOT_FOUND |
Non è stato possibile geocodificare almeno uno dei punti di origine, di destinazione o di tappe. |
OK |
La risposta contiene un elemento 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 indicazioni stradali. |
UNKNOWN_ERROR |
Impossibile elaborare una richiesta di indicazioni stradali a causa di un errore del server. Se riprovi, la richiesta potrebbe avere esito positivo. |
ZERO_RESULTS |
Nessun percorso trovato tra l'origine e la destinazione. |
Interfaccia DirectionsResult
google.maps.DirectionsResult
interfaccia
La risposta delle indicazioni stradali recuperata dal server delle indicazioni stradali. Puoi eseguire il rendering utilizzando un DirectionsRenderer
o analizzare questo oggetto ed eseguirne il rendering. Devi mostrare gli avvisi e il copyright come specificato nei Termini di servizio di Google Maps Platform. Tieni presente che, sebbene questo risultato sia "simile a JSON", non è strettamente JSON, poiché include indirettamente LatLng
oggetti.
Proprietà | |
---|---|
routes |
Tipo:
Array<DirectionsRoute> Un array di DirectionsRoute , ognuno dei quali contiene informazioni sulle gambe e sui passaggi che lo compongono. Sarà presente un solo percorso a meno che DirectionsRequest non sia stato impostato 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 restituisce risultati. L'array contiene le modalità di viaggio disponibili nei paesi di un determinato insieme di tappe. Questo campo non viene restituito se uno o più tappe sono "tramite Waypoint". |
geocoded_waypoints optional |
Tipo:
Array<DirectionsGeocodedWaypoint> optional Un array di DirectionsGeocodedWaypoint , ognuno dei quali contiene informazioni sulla geocodifica di origine, destinazione e tappe. |
Classe DirectionsRenderer
lezione google.maps.DirectionsRenderer
Visualizza le indicazioni stradali ottenute da DirectionsService
.
Questo corso estende
MVCObject
.
Quando usi v=beta
, puoi accedervi chiamando const {DirectionsRenderer} = await google.map.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 anche su un riquadro <div> (come istruzioni testuali). |
Metodi | |
---|---|
getDirections |
getDirections() Parametri: nessuno
Valore restituito:
DirectionsResult Restituisce l'insieme di indicazioni stradali attuali del renderer. |
getMap |
getMap() Parametri: nessuno
Valore restituito:
Map Restituisce la mappa su cui viene eseguito il rendering di 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 della route corrente (basato su zero) utilizzato da questo oggetto DirectionsRenderer . |
setDirections |
setDirections(directions) Parametri:
Valore di restituzione: nessuno
Imposta il renderer in modo che utilizzi il risultato di DirectionsService . Se imposti un insieme di indicazioni valide in questo modo, verranno mostrate le indicazioni sulla mappa e sul riquadro del renderer. |
setMap |
setMap(map) Parametri:
Valore di restituzione: 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 di restituzione: nessuno
Modifica le impostazioni delle opzioni di questo DirectionsRenderer dopo l'inizializzazione. |
setPanel |
setPanel(panel) Parametri:
Valore di restituzione: 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 di restituzione: nessuno
Imposta l'indice (basato su zero) della route nell'oggetto DirectionsResult di cui eseguire il rendering. Per impostazione predefinita, viene visualizzato il primo percorso dell'array. |
Ereditata:
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 impostata una nuova DirectionsResult o quando l'utente completa il trascinamento di una modifica alle indicazioni stradali. |
Interfaccia di 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 per visualizzare la mappa e/o in un riquadro <div> , recuperate come un 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 route selezionabili dall'utente mostrato nel riquadro delle indicazioni stradali. |
infoWindow optional |
Tipo:
InfoWindow optional InfoWindow in cui visualizzare le informazioni testuali 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 gli indicatori. Tutti gli indicatori visualizzati da DirectionsRenderer utilizzeranno queste opzioni. |
panel optional |
Tipo:
HTMLElement optional Il <div> in cui visualizzare i passaggi per le indicazioni stradali. |
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 non è mai stata impostata il centro della mappa e lo zoom non è mai stato impostato, la mappa di input viene centrata e ingrandita sul riquadro di delimitazione di queste indicazioni stradali. |
routeIndex optional |
Tipo:
number optional L'indice del percorso all'interno dell'oggetto DirectionsResult . Il valore predefinito è 0. |
suppressBicyclingLayer optional |
Tipo:
boolean optional Disattiva la visualizzazione di BicyclingLayer quando vengono richieste indicazioni stradali per le biciclette. |
suppressInfoWindows optional |
Tipo:
boolean optional Disattiva il rendering delle finestre informative. |
suppressMarkers optional |
Tipo:
boolean optional Elimina il rendering degli indicatori. |
suppressPolylines optional |
Tipo:
boolean optional Elimina il rendering delle polilinee. |
Interfaccia di DirectionsWaypoint
google.maps.DirectionsWaypoint
interfaccia
DirectionsWaypoint
rappresenta una località tra l'origine e la destinazione attraverso la quale deve essere effettuata la corsa.
Proprietà | |
---|---|
location optional |
Tipo:
string|LatLng|LatLngLiteral|Place optional Posizione del punto di accesso. Può essere una stringa indirizzo, un LatLng o un Place . (Facoltativo) |
stopover optional |
Tipo:
boolean optional Predefinito:
true Se true , indica che questo waypoint è una fermata tra l'origine e la destinazione. In questo modo si divide il percorso in due giri. Se false , indica che la strada deve essere limitata in modo da seguire questo punto di passaggio, ma non suddivisa in due parti. Questo è utile se vuoi creare un percorso in risposta all'utente che trascina i tappe su una mappa. |
Interfaccia DirectionsGeocodedWaypoint
google.maps.DirectionsGeocodedWaypoint
interfaccia
Un unico waypoint geocodificato.
Proprietà | |
---|---|
partial_match optional |
Tipo:
boolean optional Indica se il geocodificatore non ha restituito una corrispondenza esatta per il punto di partenza originale, sebbene sia riuscito a far corrispondere parte dell'indirizzo richiesto. |
place_id optional |
Tipo:
string optional L'ID del luogo associato al punto di accesso. 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 indicano il tipo di elemento geocodificato restituito. Per un elenco delle possibili stringhe, consulta la sezione Tipi di componenti degli indirizzi della Guida per gli sviluppatori. |
Interfaccia DirectionsRoute
google.maps.DirectionsRoute
interfaccia
Un unico percorso contenente un insieme di gambe in DirectionsResult
. Tieni presente che, sebbene questo oggetto sia di tipo "JSON", non è strettamente JSON, in quanto include direttamente e indirettamente oggetti LatLng
.
Proprietà | |
---|---|
bounds |
Tipo:
LatLngBounds I limiti per questo percorso. |
copyrights |
Tipo:
string Testo del copyright da visualizzare per questo percorso. |
legs |
Tipo:
Array<DirectionsLeg> Un array di DirectionsLeg , ciascuno dei quali contiene informazioni sui passaggi che lo compongono. Sarà presente una sola gamba per ogni tappa o destinazione specificata per la tappa. Una route con tappe non può contenere solo DirectionsLeg , mentre una con due tappe. |
overview_path |
Un array di LatLng che rappresentano l'intero percorso di questa route. Il percorso è semplificato per renderlo adatto a contesti in cui è richiesto un numero limitato di vertici (ad esempio gli URL dell'API Static Maps). |
overview_polyline |
Tipo:
string Una rappresentazione polilinea codificata del percorso in panoramiche_path. Questa polilinea è un percorso approssimativo (superficiale) delle indicazioni stradali risultanti. |
summary |
Tipo:
string Contiene una breve descrizione testuale del percorso, adatta per denominare il percorso e distinguerlo dalle alternative. |
warnings |
Tipo:
Array<string> Avvisi da visualizzare durante la visualizzazione di queste indicazioni stradali. |
waypoint_order |
Tipo:
Array<number> Se il criterio optimizeWaypoints è stato impostato su true , questo campo conterrà la permutazione riordinata dei Waypoint di input. Ad esempio, se l'input fosse:Origine: Los Angeles Waypoints: Dallas, Bangor, Phoenix Destinazione: New York e l'output ottimizzato è stato ordinato come segue: Origine: Los Angeles Waypoints: Phoenix, Dallas, Bangor Destinazione: New York , questo campo sarà un Array contenente i valori [2, 0, 1] Tieni presente che la numerazione dei Waypoint è basata su zero.Se in uno dei punti di immissione il valore stopover è impostato su false , questo campo sarà vuoto perché l'ottimizzazione del percorso non è disponibile per queste query. |
fare optional |
Tipo:
TransitFare optional La tariffa totale dell'intero viaggio con il trasporto pubblico. Valido solo per le richieste di trasporto pubblico. |
Interfaccia di DirectionsLeg
google.maps.DirectionsLeg
interfaccia
Una gamba composta da un insieme di passi in DirectionsResult
. Alcuni campi della gamba potrebbero non essere restituiti per tutte le richieste. Tieni presente che, anche se il risultato è di tipo "JSON", non è rigorosamente JSON, poiché include direttamente e indirettamente LatLng
oggetti.
Proprietà | |
---|---|
end_address |
Tipo:
string L'indirizzo della destinazione della 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 località utilizzando l'opzione di trasporto più vicina (di solito una strada) nelle posizioni di partenza e di arrivo. end_location indica la destinazione geocodificata effettiva, che potrebbe essere diversa dalla end_location dell'ultimo passaggio se, ad esempio, la strada non è vicina alla destinazione di questa tratta. |
start_address |
Tipo:
string L'indirizzo dell'origine della gamba. 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 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 e potrebbe essere diversa da start_location del primo passaggio se, ad esempio, la strada non si trova vicino all'origine di questa gamba. |
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 tratta. |
via_waypoints |
Un array di tappe non di tappa lungo questa tratta, che sono stati specificati nella richiesta originale. Deprecato in percorsi alternativi. La versione 3.27 sarà l'ultima versione dell'API che aggiungerà ulteriori Quando utilizzi il servizio Directions per implementare indicazioni stradali trascinabili, ti consigliamo di disattivare il trascinamento dei percorsi alternativi. Deve essere trascinabile solo il percorso principale. Gli utenti possono trascinare il percorso principale finché non corrisponde a un percorso alternativo. |
arrival_time optional |
Tipo:
Time optional Un orario di arrivo stimato per questa tratta. Valido solo per le richieste di TRANSIT. |
departure_time optional |
Tipo:
Time optional Un orario di partenza stimato per questa tratta. Valido solo per le richieste di TRANSIT. |
distance optional |
Tipo:
Distance optional La distanza totale coperta 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 questa tratta, tenendo conto delle condizioni del traffico indicate dalla proprietà trafficModel . Questa proprietà potrebbe essere undefined perché la durata potrebbe essere sconosciuta. |
Interfaccia di DirectionsStep
google.maps.DirectionsStep
interfaccia
Un solo DirectionsStep
in DirectionsResult
. Alcuni campi potrebbero essere undefined
. Tieni presente che, sebbene questo oggetto sia di tipo "JSON", non è rigorosamente JSON, in quanto include direttamente oggetti LatLng
.
Proprietà | |
---|---|
encoded_lat_lngs |
Tipo:
string Una rappresentazione polilinea codificata del passaggio. Si tratta di un percorso approssimativo 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 il corso di questo passaggio. Si tratta di un percorso approssimativo 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 i nuovi valori potrebbero essere introdotti senza preavviso. |
path |
Una sequenza di LatLng che descrive il corso di questo passaggio. Si tratta di un percorso approssimativo 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 da 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 sotto forma di 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 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 su questo passaggio specifici per il trasporto pubblico. 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 di 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 di Place
google.maps.Place
interfaccia
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à, un punto d'interesse o una posizione geografica. Per informazioni su un luogo, consulta PlacesService
.
Proprietà | |
---|---|
location optional |
Tipo:
LatLng|LatLngLiteral optional Il LatLng dell'entità descritta da questo luogo. |
placeId optional |
Tipo:
string optional L'ID del luogo (ad es. 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 invece di query . Un ID luogo può essere recuperato da qualsiasi richiesta all'API Places, come TextSearch. Gli ID luogo possono essere recuperati anche 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à 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 invece di query . L'API non garantisce l'accuratezza della risoluzione della stringa di query in una determinata posizione. Se sono presenti sia placeId che query , si verifica un errore. |
Costanti TravelMode
google.maps.TravelMode
costanti
Le modalità di viaggio valide che possono essere specificate in DirectionsRequest
e le modalità di viaggio restituite in un DirectionsStep
. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'BICYCLING'
o google.maps.TravelMode.BICYCLING
.
Quando usi v=beta
, puoi accedervi chiamando const {TravelMode} = await google.map.importLibrary("routes")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
BICYCLING |
Specifica una richiesta di indicazioni stradali per le biciclette. |
DRIVING |
Specifica una richiesta di indicazioni stradali. |
TRANSIT |
Specifica una richiesta di indicazioni stradali per il trasporto pubblico. |
WALKING |
Specifica una richiesta di indicazioni a piedi. |
Interfaccia di DriveOptions
google.maps.DrivingOptions
interfaccia
Configura 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. Questo valore deve essere specificato affinché un elemento DrivingOptions sia valido. L'orario di partenza deve essere impostato sull'ora attuale o su una data futura. Non può essere nel passato. |
trafficModel optional |
Tipo:
TrafficModel optional Il presupposto preferito per prevedere la durata del traffico. Il valore predefinito è BEST_GUESS . |
Costanti TrafficModel
google.maps.TrafficModel
costanti
Le ipotesi da utilizzare quando si prevede la durata del traffico. Specificato come parte di DirectionsRequest
o DistanceMatrixRequest
. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'bestguess'
o google.maps.TrafficModel.BEST_GUESS
.
Quando usi v=beta
, puoi accedervi chiamando const {TrafficModel} = await google.map.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 stimare in modo ottimistico la durata del traffico. |
PESSIMISTIC |
Utilizza i dati storici sul traffico per fare una stima pessimistica della durata del traffico. |
Interfaccia TransitOptions
google.maps.TransitOptions
interfaccia
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 Date. L'oggetto Date misura il tempo in millisecondi dal 1° gennaio 1970. Se viene specificato l'ora di arrivo, l'orario di partenza viene ignorato. |
departureTime optional |
Tipo:
Date optional L'orario di partenza desiderato per il percorso, specificato come oggetto Date. L'oggetto Date misura il tempo in millisecondi 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 pubblico preferite, ad esempio autobus o treno. Se non viene data 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 una minore camminata. Se non viene data alcuna preferenza, l'API restituisce il percorso migliore predefinito. |
Costanti di TransitMode
google.maps.TransitMode
costanti
La modalità di trasporto pubblico valida, ad esempio l'autobus che può essere specificato in una TransitOptions
. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'BUS'
o google.maps.TransitMode.BUS
.
Quando usi v=beta
, puoi accedervi chiamando const {TransitMode} = await google.map.importLibrary("routes")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
BUS |
Specifica l'autobus come mezzo di trasporto preferito. |
RAIL |
Specifica la ferrovia come mezzo di trasporto preferito. |
SUBWAY |
Specifica la metropolitana come mezzo di trasporto preferito. |
TRAIN |
Specifica il treno come modalità di trasporto pubblico preferita. |
TRAM |
Specifica il tram come mezzo di trasporto preferito. |
Costanti TransitRoutePreferenza
google.maps.TransitRoutePreference
costanti
Il tipo di percorso di trasporto pubblico valido che può essere specificato in una TransitOptions
. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'LESS_WALKING'
o google.maps.TransitRoutePreference.LESS_WALKING
.
Quando usi v=beta
, puoi accedervi chiamando const {TransitRoutePreference} = await google.map.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 dovrebbe preferire una quantità limitata di tratti di camminata. |
Interfaccia TransitTariffa
google.maps.TransitFare
interfaccia
Una tariffa per DirectionsRoute
composta da valore e valuta.
Proprietà | |
---|---|
currency |
Tipo:
string Un codice valuta ISO 4217 che indica la valuta in cui è espressa la tariffa. |
value |
Tipo:
number Il valore numerico della tariffa, espresso in currency . |
Interfaccia TransitDetails
google.maps.TransitDetails
interfaccia
Dettagli su partenza, arrivo e modalità di trasporto pubblico utilizzati 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 per il trasporto pubblico. |
departure_time |
Tipo:
Time L'ora di partenza di questo passaggio, specificata come oggetto time. |
headsign |
Tipo:
string La direzione di viaggio su questa linea, indicata sul veicolo o alla fermata. |
headway |
Tipo:
number Il numero di secondi previsto tra i veicoli equivalenti a questa fermata. |
line |
Tipo:
TransitLine Dettagli sulla linea di trasporto pubblico utilizzati in questo passaggio. |
num_stops |
Tipo:
number Il numero di fermate in questo passaggio. Include la fermata di arrivo, ma non la fermata di partenza. |
trip_short_name |
Tipo:
string Il testo visualizzato negli orari e nei cartelloni per identificare un viaggio in transito ai passeggeri, ad esempio, per identificare i numeri dei treni per le corse ferroviarie di pendolari. Il testo identifica in modo univoco una corsa in un giorno di servizio. |
Interfaccia TransitStop
google.maps.TransitStop
interfaccia
Dettagli su una fermata o una stazione di transito.
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 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 di uso comune della segnaletica, per questa linea di trasporto pubblico, rappresentata da una stringa esagonale. |
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 "Via Verdi 8". |
short_name |
Tipo:
string Il nome breve di questa linea di trasporto pubblico, ad esempio "E". |
text_color |
Tipo:
string Il colore del testo di uso comune nella segnaletica per questa linea di transito, rappresentato come una stringa esadecimale. |
url |
Tipo:
string L'URL dell'azienda di trasporto 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 di trasporto pubblico 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 URL dell'azienda di trasporto pubblico. |
Interfaccia Transit Vehicle
google.maps.TransitVehicle
interfaccia
Informazioni sul veicolo che opera su una linea di trasporto pubblico.
Proprietà | |
---|---|
icon |
Tipo:
string L'URL di un'icona che corrisponde al tipo di veicolo utilizzato su questa linea. |
local_icon |
Tipo:
string Un URL per 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 TransitTransport, ad esempio "Treno" o "Pullman". |
type |
Tipo:
VehicleType Il tipo di veicolo utilizzato, ad esempio treno, autobus o traghetto. |
Costanti VehicleType
google.maps.VehicleType
costanti
I valori possibili per i tipi di veicoli.
Quando usi v=beta
, puoi accedervi chiamando const {VehicleType} = await google.map.importLibrary("routes")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
BUS |
Autobus. |
CABLE_CAR |
Un veicolo che funziona su un cavo, solitamente a terra. Le funicolari per auto possono essere del tipo GONDOLA_LIFT . |
COMMUTER_TRAIN |
Ferrovia per pendolari. |
FERRY |
Traghetto. |
FUNICULAR |
Un veicolo che sale su una ripida pendenza da un cavo. |
GONDOLA_LIFT |
Una funivia. |
HEAVY_RAIL |
Ferrovia pesante. |
HIGH_SPEED_TRAIN |
Treno ad alta velocità. |
INTERCITY_BUS |
Autolinee regionali e nazionali. |
METRO_RAIL |
Metropolitana leggera. |
MONORAIL |
Monorotaia. |
OTHER |
Altri veicoli. |
RAIL |
Ferrovia. |
SHARE_TAXI |
Il taxi condiviso è una sorta di trasporto in autobus che consente di scendere e prendere passeggeri ovunque lungo il percorso. Di solito il taxi è condiviso con i minibus. |
SUBWAY |
Metropolitana leggera. |
TRAM |
Metropolitana leggera su terra. |
TROLLEYBUS |
Tram. |
Costanti di UnitSystem
google.maps.UnitSystem
costanti
I sistemi di unità validi che possono essere specificati in una DirectionsRequest
.
Quando usi v=beta
, puoi accedervi chiamando const {UnitSystem} = await google.map.importLibrary("core")
. Consulta la sezione 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 a 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 dell'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 della data, 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 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 della data JavaScript. |
Costanti DirectionsTravelMode
google.maps.DirectionsTravelMode
costanti
Costanti DirectionsUnitSystem
google.maps.DirectionsUnitSystem
costanti