Classe DirectionsService
google.maps.DirectionsService
corso
Un servizio per calcolare le 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 un 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
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 Indicazioni stradali 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 , indica al servizio Indicazioni stradali di evitare 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 le altre modalità di viaggio. |
language optional |
Tipo:
string optional Un identificatore 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 tenterà di riordinare i waypoint intermedi forniti per ridurre al minimo il costo complessivo del percorso. Se i waypoint sono ottimizzati, controlla DirectionsRoute.waypoint_order nella risposta per determinare la nuova organizzazione. |
provideRouteAlternatives optional |
Tipo:
boolean optional Se devono essere fornite o meno alternative al 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 di ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune eccezioni notevoli. Ad esempio, il TLD di primo livello 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 le 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 la visualizzazione della distanza. |
waypoints optional |
Tipo:
Array<DirectionsWaypoint> optional Array di waypoint intermedi. Le indicazioni vengono calcolate dall'origine alla destinazione passando per ogni waypoint in questo array. Consulta la guida per gli sviluppatori per conoscere il numero massimo di waypoint consentiti. Le tappe non sono supportate per le indicazioni stradali per il trasporto pubblico. Facoltativo. |
Costanti DirectionsStatus
google.maps.DirectionsStatus
costanti
Lo stato restituito da DirectionsService
al termine di una chiamata a route()
. Specificali in base al 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 |
Nel DirectionsRequest sono stati forniti troppi DirectionsWaypoint . Consulta la guida per gli sviluppatori per conoscere il numero massimo di waypoint consentiti. |
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 |
Non è stato possibile elaborare una richiesta di indicazioni stradali a causa di un errore del server. La richiesta potrebbe andare a buon fine se riprovi. |
ZERO_RESULTS |
Non è stato possibile trovare un percorso tra la stazione di partenza e quella di destinazione. |
Interfaccia DirectionsResult
google.maps.DirectionsResult
interfaccia
La risposta alle indicazioni stradali recuperata dal server di indicazioni stradali. Puoi visualizzarli utilizzando un DirectionsRenderer
o analizzare questo oggetto e visualizzarlo autonomamente. Devi mostrare gli avvisi e i copyright come indicato nei Termini di servizio di Google Maps Platform. Tieni presente che, anche se questo risultato è "simile a JSON", non è strettamente JSON, in quanto include indirettamente oggetti LatLng
.
Proprietà | |
---|---|
request |
Tipo:
DirectionsRequest La richiesta di indicazioni stradali che ha generato questo risultato. |
routes |
Tipo:
Array<DirectionsRoute> Un array di DirectionsRoute , ognuno dei quali contiene informazioni sulle tappe e sui passaggi di cui è composto. Verrà generato 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 restituisce risultati. L'array contiene le modalità di viaggio disponibili nei paesi del determinato insieme di waypoint. Questo campo non viene restituito se uno o più dei waypoint sono "tramite waypoint". |
geocoded_waypoints optional |
Tipo:
Array<DirectionsGeocodedWaypoint> optional Un array di DirectionsGeocodedWaypoint , ognuno dei quali contiene informazioni sul geocoding di partenza, destinazione e waypoint. |
Classe DirectionsRenderer
google.maps.DirectionsRenderer
corso
Mostra le indicazioni stradali ottenute dal 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 anche in un riquadro <div> (come istruzioni testuali). |
Metodi | |
---|---|
getDirections |
getDirections() Parametri: nessuno
Valore restituito:
DirectionsResult Restituisce l'insieme di indicazioni corrente del visualizzatore. |
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 percorso corrente (a partire da zero) in uso da questo oggetto DirectionsRenderer . |
setDirections |
setDirections(directions) Parametri:
Valore restituito:nessuno
Imposta il visualizzatore in modo che utilizzi il risultato di DirectionsService . Se imposti un insieme valido di indicazioni stradali in questo modo, le indicazioni verranno visualizzate sulla mappa e nel riquadro designati dal visualizzatore. |
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
Modificare le impostazioni delle opzioni di questo DirectionsRenderer dopo l'inizializzazione. |
setPanel |
setPanel(panel) Parametri:
Valore restituito:nessuno
Questo metodo mostra le indicazioni stradali in un <div> . Invia null per rimuovere i contenuti dal riquadro. |
setRouteIndex |
setRouteIndex(routeIndex) Parametri:
Valore restituito:nessuno
Imposta l'indice (a partire da 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 le indicazioni stradali visualizzate cambiano, 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 Valore predefinito:
false Questa proprietà indica se il visualizzatore deve fornire un elenco di percorsi selezionabili dall'utente nel riquadro delle indicazioni stradali. |
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 relativa posizione verrà spostata. Se non viene specificata alcuna finestra informativa, DirectionsRenderer ne creerà e utilizzerà una propria. 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 delle 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 Valore 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 viene applicato lo zoom alla casella delimitante 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 Eliminare il rendering di BicyclingLayer quando vengono richieste indicazioni stradali per biciclette. |
suppressInfoWindows optional |
Tipo:
boolean optional Elimina il rendering delle finestre di informazioni. |
suppressMarkers optional |
Tipo:
boolean optional Elimina il rendering degli indicatori. |
suppressPolylines optional |
Tipo:
boolean optional Elimina 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 percorso.
Proprietà | |
---|---|
location optional |
Tipo:
string|LatLng|LatLngLiteral|Place optional Posizione del waypoint. Può essere una stringa di indirizzi, un LatLng o un Place . Facoltativo. |
stopover optional |
Tipo:
boolean optional Valore predefinito:
true Se true , indica che questa fermata è una fermata tra l'origine e la destinazione. Ciò ha l'effetto di suddividere il percorso in due tratti. Se false , indica che il percorso deve essere orientato in modo da passare per questo waypoint, ma non essere suddiviso in due tratti. Questa opzione è utile se vuoi creare un percorso in risposta al trascinamento di 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 Indica se il geocodificatore non ha restituito una corrispondenza esatta per il waypoint originale, anche se è stato in grado di trovare una corrispondenza per parte dell'indirizzo richiesto. |
place_id optional |
Tipo:
string optional L'ID luogo associato al punto di passaggio. 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 di possibili stringhe, consulta la sezione Tipi di componenti dell'indirizzo della Guida per gli sviluppatori. |
Interfaccia DirectionsRoute
google.maps.DirectionsRoute
interfaccia
Un singolo percorso contenente un insieme di tratti in un DirectionsResult
. Tieni presente che, anche se questo oggetto è "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 del copyright da visualizzare per questo percorso. |
legs |
Tipo:
Array<DirectionsLeg> Un array di DirectionsLeg , ognuno dei quali contiene informazioni sui passaggi di cui è composto. Verrà visualizzata una tappa per ogni punto di passaggio o destinazione specificati. 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 rappresenta l'intero percorso di questo itinerario. Il percorso è semplificato per renderlo adatto a contesti in cui è richiesto un numero ridotto di vertici (ad esempio gli URL dell'API Maps Static). |
overview_polyline |
Tipo:
string Una rappresentazione polilinea codificata del percorso in overview_path. Questa polilinea è un percorso approssimativo (appiattito) delle indicazioni stradali risultanti. |
summary |
Tipo:
string Contiene una breve descrizione testuale del percorso, adatta 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 è impostato su true , questo campo conterrà la permutazione riordinata dei waypoint inseriti. Ad esempio, se l'input era:Origine: Los Angeles Punti di passaggio: Dallas, Bangor, Phoenix Destinazione: New York e l'output ottimizzato era ordinato come segue: Origine: Los Angeles Punti di passaggio: 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 per uno dei waypoint inseriti è impostato stopover 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 tragitto. Applicabile solo alle richieste relative ai trasporti pubblici. |
Interfaccia DirectionsLeg
google.maps.DirectionsLeg
interfaccia
Un singolo tratto costituito da una serie di passaggi in un DirectionsResult
. Alcuni campi della tratta potrebbero non essere restituiti per tutte le richieste. Tieni presente che, anche se questo risultato è "simile a JSON", non è strettamente JSON, in quanto include direttamente e indirettamente oggetti LatLng
.
Proprietà | |
---|---|
end_address |
Tipo:
string L'indirizzo della destinazione di questo tratto. Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo formattato tramite programmazione. |
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'ultimo passaggio se, ad esempio, la strada non si trova vicino alla destinazione di questo tratto. |
start_address |
Tipo:
string L'indirizzo dell'origine di questo tratto. Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo formattato tramite programmazione. |
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 si trova vicino all'origine di questo tratto. |
steps |
Tipo:
Array<DirectionsStep> Un array di DirectionsStep , ognuno dei quali contiene informazioni sui singoli passaggi di questo tratto. |
|
Tipo:
Array<?> Informazioni sulla velocità del traffico lungo il tratto. |
via_waypoints |
Un array di waypoint non di sosta lungo questo tratto, specificati nella richiesta originale. Deprecato nei percorsi alternativi. La versione 3.27 sarà l'ultima versione dell'API che aggiunge Quando utilizzi il servizio di indicazioni stradali per implementare indicazioni stradali spostabili, ti consigliamo di disattivare il trascinamento dei 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 Un orario di arrivo stimato per questo tratto. Valido solo per le richieste TRANSIT. |
departure_time optional |
Tipo:
Time optional Un'ora di partenza stimata per questo tratto. Valido solo per le richieste TRANSIT. |
distance optional |
Tipo:
Distance optional La distanza totale coperta da questo tratto. Questa proprietà potrebbe non essere definita perché la distanza potrebbe essere sconosciuta. |
duration optional |
Tipo:
Duration optional La durata totale di questo tratto. Questa proprietà può 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 di traffico indicate dalla proprietà trafficModel . Questa proprietà può essere undefined perché 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, anche se questo oggetto è "simile a JSON", non è strettamente JSON, in quanto include direttamente oggetti LatLng
.
Proprietà | |
---|---|
encoded_lat_lngs |
Tipo:
string Una rappresentazione polilinea codificata del passaggio. Questo è un percorso approssimativo (appiattito) 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. Questo è un percorso approssimativo (appiattito) 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 il corso di questo passaggio. Questo è un percorso approssimativo (appiattito) del passaggio. |
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 da questo passaggio. Questa proprietà può 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 di testo. Questa proprietà può 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. Questo polilinea è un percorso approssimativo (appiattito) del passaggio. |
steps optional |
Tipo:
Array<DirectionsStep> optional Sottopassaggi di questo passaggio. Specificato per le sezioni non di trasporto pubblico dei percorsi di trasporto pubblico. |
transit optional |
Tipo:
TransitDetails optional Dettagli specifici per i trasporti pubblici 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 il polilinea di un DirectionsStep
.
Proprietà | |
---|---|
points |
Tipo:
string Una polilinea codificata. |
Interfaccia Place
google.maps.Place
interfaccia
Contiene le informazioni necessarie per individuare, identificare o descrivere un luogo per un DirectionsRequest
o un DistanceMatrixRequest
. In questo contesto, per "luogo" si intende un'attività, un punto d'interesse o una posizione geografica. Per recuperare le 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 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 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). 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 in base al 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 stradali a piedi. |
Interfaccia DrivingOptions
google.maps.DrivingOptions
interfaccia
Configura DirectionsRequest
quando la modalità di viaggio è impostata su DRIVING
.
Proprietà | |
---|---|
departureTime |
Tipo:
Date L'ora di partenza desiderata per il percorso, specificata come oggetto Date . L'oggetto Date misura il tempo in millisecondi dal 1° gennaio 1970. Questo valore deve essere specificato affinché DrivingOptions sia valido. L'ora di partenza deve essere impostata sull'ora corrente o su un'ora futura. 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
I presupposti da utilizzare per prevedere la durata nel traffico. Specificato come parte di un DirectionsRequest
o DistanceMatrixRequest
. Specificali in base al 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 sul traffico storico 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 fare una stima pessimistica della durata del 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 il percorso, specificata come oggetto Date. L'oggetto Date misura il tempo in millisecondi dal 1° gennaio 1970. Se viene specificata l'ora di arrivo, l'ora di partenza viene ignorata. |
departureTime optional |
Tipo:
Date optional L'ora di partenza desiderata per il percorso, specificata come oggetto Date. L'oggetto Date 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 corrente". |
modes optional |
Tipo:
Array<TransitMode> optional Una o più modalità di trasporto pubblico 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 meno tratti a piedi. 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 autobus, che può essere specificata in un TransitOptions
. Specificali in base al 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 l'autobus come mezzo di trasporto pubblico preferito. |
RAIL |
Specifica il treno 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 percorso di trasporto pubblico valido che può essere specificato in un TransitOptions
. Specificali in base al 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 trasferimenti. |
LESS_WALKING |
Specifica che il percorso calcolato deve preferire tratti a piedi limitati. |
Interfaccia TransitFare
google.maps.TransitFare
interfaccia
Una tariffa di un 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 nell' currency specificato. |
Interfaccia TransitDetails
google.maps.TransitDetails
interfaccia
Dettagli su partenza, arrivo e modalità di trasporto 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 del 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, come indicato 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. Sono incluse la fermata di arrivo, ma non quella di partenza. |
trip_short_name |
Tipo:
string Il testo visualizzato negli orari e nelle insegne per identificare una corsa per i passeggeri, ad esempio per identificare i numeri dei treni per le corse ferroviarie per 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 della fermata. |
name |
Tipo:
string Il nome della fermata di 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. |
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 della 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 stringa esadecimale. |
url |
Tipo:
string L'URL dell'azienda di trasporto pubblico 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 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 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 che corrisponda al tipo di veicolo utilizzato in questa regione anziché all'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
Possibili valori 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 su un cavo, solitamente a terra. Le funivie aeree possono essere di tipo GONDOLA_LIFT . |
COMMUTER_TRAIN |
Treno suburbano. |
FERRY |
Traghetto. |
FUNICULAR |
Un veicolo che viene tirato su una ripida salita da un cavo. |
GONDOLA_LIFT |
Una funivia. |
HEAVY_RAIL |
Treni pesanti. |
HIGH_SPEED_TRAIN |
Treno ad alta velocità. |
INTERCITY_BUS |
Autobus interurbano. |
METRO_RAIL |
Metropolitana leggera. |
MONORAIL |
Monorotaia. |
OTHER |
Altri veicoli. |
RAIL |
Ferrovia. |
SHARE_TAXI |
Il taxi condiviso è una sorta di trasporto pubblico che può far scendere e salire i passeggeri ovunque lungo il percorso. In genere, i taxi condivisi utilizzano veicoli minibus. |
SUBWAY |
Metropolitana leggera sotterranea. |
TRAM |
Metropolitana leggera sopraelevata. |
TROLLEYBUS |
Filobus. |
Costanti UnitSystem
google.maps.UnitSystem
costanti
I sistemi di unità validi che possono essere specificati in un DirectionsRequest
.
Accedi chiamando const {UnitSystem} = await google.maps.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 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 di distanza, che utilizza il parametro UnitSystem specificato nella richiesta. |
value |
Tipo:
number La distanza in metri. |
Interfaccia Durata
google.maps.Duration
interfaccia
Una rappresentazione della durata come valore numerico e stringa di visualizzazione.
Proprietà | |
---|---|
text |
Tipo:
string Una rappresentazione di stringa del valore della durata. |
value |
Tipo:
number La durata in secondi. |
Interfaccia Ora
google.maps.Time
interfaccia
Una rappresentazione del tempo 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 la fermata. Il valore è il nome del fuso orario come 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 Date di JavaScript. |
Costanti DirectionsTravelMode
google.maps.DirectionsTravelMode
costanti
Costanti DirectionsUnitSystem
google.maps.DirectionsUnitSystem
costanti