Classe DirectionsService
google.maps.DirectionsService
libreria di
classi "routes"
const {DirectionsService} = await google.maps.importLibrary("routes");
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
Interfaccia google.maps.DirectionsRequest
Una query di indicazioni stradali da inviare a DirectionsService.
Proprietà | |
|---|---|
destination |
Tipo:
string|LatLng|Place|LatLngLiteralLocalità di destinazione. Può essere specificato come stringa da geocodificare, LatLng o Place. Obbligatorio. |
origin |
Tipo:
string|LatLng|Place|LatLngLiteralLocalità di origine. Può essere specificato come stringa da geocodificare, LatLng o Place. Obbligatorio. |
travelMode |
Tipo:
TravelModeTipo di routing richiesto. Obbligatorio. |
avoidFerries
facoltativo |
Tipo:
boolean optionalSe true, indica al servizio Directions di evitare i traghetti, se possibile. Facoltativo. |
avoidHighways
facoltativo |
Tipo:
boolean optionalSe true, indica al servizio Directions di evitare le autostrade, se possibile. Facoltativo. |
avoidTolls
facoltativo |
Tipo:
boolean optionalSe impostato su true, indica al servizio Directions di evitare le strade a pedaggio, se possibile. Facoltativo. |
drivingOptions
facoltativo |
Tipo:
DrivingOptions optionalImpostazioni che si applicano solo alle richieste in cui travelMode è DRIVING. Questo oggetto non avrà alcun effetto per altre modalità di viaggio. |
language
facoltativo |
Tipo:
string optionalUn identificatore della lingua in cui devono essere restituiti i risultati, se possibile. Consulta l'elenco delle lingue supportate. |
optimizeWaypoints
facoltativo |
Tipo:
boolean optionalSe 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 il nuovo ordine. |
provideRouteAlternatives
facoltativo |
Tipo:
boolean optionalIndica se devono essere forniti percorsi alternativi. Facoltativo. |
region
facoltativo |
Tipo:
string optionalCodice 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 è identica ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD 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
facoltativo |
Tipo:
TransitOptions optionalImpostazioni che si applicano solo alle richieste in cui travelMode è TRANSIT. Questo oggetto non avrà alcun effetto per altre modalità di viaggio. |
unitSystem
facoltativo |
Tipo:
UnitSystem optionalValore predefinito: il sistema di unità di misura utilizzato nel paese di origine.
Sistema di unità di misura preferito da utilizzare per la visualizzazione della distanza. |
waypoints
facoltativo |
Tipo:
Array<DirectionsWaypoint> optionalArray di tappe intermedie. Le indicazioni stradali 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 tappe consentite. I waypoint non sono supportati per le indicazioni per il trasporto pubblico. Facoltativo. |
Costanti DirectionsStatus
google.maps.DirectionsStatus
libreria di costanti
"routes"
Lo stato restituito da DirectionsService al completamento di una chiamata a route(). Specifica questi valori in base al valore o utilizzando il nome della costante. Ad esempio: 'OK' o google.maps.DirectionsStatus.OK.
Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo DirectionsStatusString.
const {DirectionsStatus} = await google.maps.importLibrary("routes");
Costanti | |
|---|---|
INVALID_REQUEST |
Il valore DirectionsRequest fornito non era valido. |
MAX_WAYPOINTS_EXCEEDED |
Sono stati forniti troppi DirectionsWaypoint in DirectionsRequest. Consulta la guida per gli sviluppatori per conoscere il numero massimo di tappe consentite. |
NOT_FOUND |
Non è stato possibile geocodificare almeno uno dei punti di partenza, di arrivo o di passaggio. |
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 l'origine e la destinazione. |
Interfaccia DirectionsResult
Interfaccia google.maps.DirectionsResult
La risposta con le indicazioni stradali recuperata dal server delle indicazioni stradali. Puoi eseguire il rendering di questi elementi utilizzando un DirectionsRenderer o analizzare questo oggetto ed eseguirne il rendering in autonomia. 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:
DirectionsRequestLa DirectionsRequest 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. Esisterà un solo percorso, a meno che DirectionsRequest non sia stato creato con provideRouteAlternatives impostato su true. |
available_travel_modes
facoltativo |
Tipo:
Array<TravelMode> optionalContiene un array di modalità di viaggio disponibili. Questo campo viene restituito quando una richiesta specifica una modalità di viaggio e non ottiene risultati. L'array contiene le modalità di viaggio disponibili nei paesi dell'insieme di tappe specificato. Questo campo non viene restituito se uno o più waypoint sono "waypoint intermedi". |
geocoded_waypoints
facoltativo |
Tipo:
Array<DirectionsGeocodedWaypoint> optionalUn array di DirectionsGeocodedWaypoint, ognuno dei quali contiene informazioni sulla geocodifica di origine, destinazione e tappe. |
Classe DirectionsRenderer
google.maps.DirectionsRenderer
class
extends MVCObject
library "routes"
const {DirectionsRenderer} = await google.maps.importLibrary("routes");
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|nullRestituisce l'insieme corrente di indicazioni stradali del visualizzatore. |
getMap |
getMap()Parametri: nessuno
Valore restituito:
Map|nullRestituisce la mappa su cui viene eseguito il rendering di DirectionsResult. |
getPanel |
getPanel()Parametri: nessuno
Valore restituito:
HTMLElement|nullRestituisce il riquadro <div> in cui viene visualizzato DirectionsResult. |
getRouteIndex |
getRouteIndex()Parametri: nessuno
Valore restituito:
numberRestituisce l'indice del 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. Se imposti un insieme valido di indicazioni stradali in questo modo, queste verranno visualizzate sulla mappa e sul 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 (in base zero) del percorso nell'oggetto DirectionsResult di cui eseguire il rendering. Per impostazione predefinita, verrà eseguito il rendering del primo percorso nell'array. |
Ereditate:
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
Interfaccia google.maps.DirectionsRendererOptions
Questo oggetto definisce le proprietà che possono essere impostate su un oggetto DirectionsRenderer.
Proprietà | |
|---|---|
directions
facoltativo |
Tipo:
DirectionsResult optionalLe indicazioni stradali da visualizzare sulla mappa e/o in un riquadro <div>, recuperate come oggetto DirectionsResult da DirectionsService. |
draggable
facoltativo |
Tipo:
boolean optionalSe impostato su true, consente all'utente di trascinare e modificare i percorsi degli itinerari visualizzati da questo DirectionsRenderer. |
hideRouteList
facoltativo |
Tipo:
boolean optionalValore predefinito:
falseQuesta proprietà indica se il renderer deve fornire un elenco di percorsi selezionabili dall'utente mostrato nel riquadro delle indicazioni stradali. |
infoWindow
facoltativo |
Tipo:
InfoWindow optionalL'elemento InfoWindow in cui eseguire il rendering delle informazioni di testo quando si fa clic su un indicatore. I contenuti esistenti della finestra informativa verranno sovrascritti e la sua posizione verrà spostata. Se non viene specificata alcuna finestra informativa, DirectionsRenderer ne creerà e utilizzerà una propria. Questa proprietà verrà ignorata se suppressInfoWindows è impostata su true. |
map
facoltativo |
Tipo:
Map optionalMappa su cui visualizzare le indicazioni stradali. |
markerOptions
facoltativo |
Tipo:
MarkerOptions optionalOpzioni per gli indicatori. Tutti gli indicatori visualizzati da DirectionsRenderer utilizzeranno queste opzioni. |
panel
facoltativo |
Tipo:
HTMLElement optionalL'elemento <div> in cui visualizzare i passaggi delle indicazioni stradali. |
polylineOptions
facoltativo |
Tipo:
PolylineOptions optionalOpzioni per le polilinee. Tutte le polilinee visualizzate da DirectionsRenderer utilizzeranno queste opzioni. |
preserveViewport
facoltativo |
Tipo:
boolean optionalValore predefinito:
falseSe 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 ingrandita in base al riquadro di delimitazione di questo insieme di indicazioni stradali. |
routeIndex
facoltativo |
Tipo:
number optionalL'indice del percorso all'interno dell'oggetto DirectionsResult. Il valore predefinito è 0. |
suppressBicyclingLayer
facoltativo |
Tipo:
boolean optionalElimina il rendering di BicyclingLayer quando vengono richieste le indicazioni in bicicletta. |
suppressInfoWindows
facoltativo |
Tipo:
boolean optionalElimina il rendering delle finestre informative. |
suppressMarkers
facoltativo |
Tipo:
boolean optionalElimina il rendering degli indicatori. |
suppressPolylines
facoltativo |
Tipo:
boolean optionalElimina il rendering delle polilinee. |
Interfaccia DirectionsWaypoint
Interfaccia google.maps.DirectionsWaypoint
Un DirectionsWaypoint rappresenta una località tra l'origine e la destinazione attraverso la quale deve essere instradato il percorso.
Proprietà | |
|---|---|
location
facoltativo |
Tipo:
string|LatLng|LatLngLiteral|Place optionalPosizione del waypoint. Può essere una stringa di indirizzo, un LatLng o un Place. Facoltativo. |
stopover
facoltativo |
Tipo:
boolean optionalValore predefinito:
trueSe true, indica che questo waypoint è 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 in modo da passare attraverso questo waypoint, ma non deve essere suddiviso in due tappe. Questa opzione è utile se vuoi creare un percorso in risposta al trascinamento dei waypoint su una mappa da parte dell'utente. |
Interfaccia DirectionsGeocodedWaypoint
Interfaccia google.maps.DirectionsGeocodedWaypoint
Un singolo waypoint geocodificato.
Proprietà | |
|---|---|
partial_match
facoltativo |
Tipo:
boolean optionalIndica 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
facoltativo |
Tipo:
string optionalL'ID luogo associato al waypoint. Gli ID luogo identificano in modo unico 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
facoltativo |
Tipo:
Array<string> optionalUn array di stringhe che indica 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
Interfaccia google.maps.DirectionsRoute
Un singolo percorso 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:
LatLngBoundsI limiti di questo percorso. |
copyrights |
Tipo:
stringTesto dei 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à generata una tappa per ogni waypoint di sosta o destinazione specificati. Pertanto, un percorso senza tappe intermedie conterrà un DirectionsLeg e un percorso con una tappa intermedia ne conterrà due. |
overview_path |
Un array di LatLng che rappresenta l'intero percorso di questo itinerario. Il percorso viene 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:
stringUna rappresentazione di polilinea codificata del percorso in overview_path. Questa polilinea è un percorso approssimativo (smussato) delle indicazioni stradali risultanti. |
summary |
Tipo:
stringContiene una breve descrizione testuale del percorso, adatta per assegnare un nome e distinguere il percorso dalle alternative. |
warnings |
Tipo:
Array<string>Avvisi da visualizzare quando vengono mostrate queste indicazioni stradali. |
waypoint_order |
Tipo:
Array<number>Se optimizeWaypoints è stato impostato su true, questo campo conterrà la permutazione riordinata dei waypoint di input. Ad esempio, se l'input era:Origine: Los Angeles Waypoint: Dallas, Bangor, Phoenix Destinazione: New York e l'output ottimizzato era ordinato come segue: Origine: Los Angeles Waypoint: 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 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
facoltativo |
Tipo:
TransitFare optionalLa tariffa totale per l'intero percorso con il trasporto pubblico. Applicabile solo alle richieste di trasporto pubblico. |
Interfaccia DirectionsLeg
Interfaccia google.maps.DirectionsLeg
Un singolo tratto 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:
stringL'indirizzo della destinazione di questa tappa. Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo formattato in modo programmatico. |
end_location |
Tipo:
LatLngL' 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 effettiva geocodificata, che potrebbe essere diversa dal end_location dell'ultimo passaggio se, ad esempio, la strada non è vicina alla destinazione di questa tappa. |
start_address |
Tipo:
stringL'indirizzo di origine di questa tappa. Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo formattato in modo programmatico. |
start_location |
Tipo:
LatLngL' 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 tappa. |
steps |
Tipo:
Array<DirectionsStep>Un array di DirectionsStep, ognuno dei quali contiene informazioni sui singoli passaggi di questa tappa. |
|
Tipo:
Array<*>Informazioni sulla velocità del traffico lungo la tappa. |
via_waypoints |
Un array di tappe senza sosta lungo questa tratta, specificate nella richiesta originale. Deprecato nei percorsi alternativi. La versione 3.27 sarà l'ultima versione dell'API che aggiunge Quando utilizzi il servizio Directions per implementare le indicazioni stradali trascinabili, ti consigliamo di disattivare il trascinamento dei percorsi alternativi. Solo il percorso principale deve essere trascinabile. Gli utenti possono trascinare il percorso principale fino a farlo corrispondere a un percorso alternativo. |
arrival_time
facoltativo |
Tipo:
Time optionalUn'ora di arrivo stimata per questa tappa. Applicabile solo alle richieste TRANSIT. |
departure_time
facoltativo |
Tipo:
Time optionalUn orario di partenza stimato per questa tappa. Applicabile solo alle richieste TRANSIT. |
distance
facoltativo |
Tipo:
Distance optionalLa distanza totale coperta da questa tappa. Questa proprietà potrebbe non essere definita, in quanto la distanza potrebbe essere sconosciuta. |
duration
facoltativo |
Tipo:
Duration optionalLa durata totale di questa tappa. Questa proprietà potrebbe essere undefined perché la durata potrebbe essere sconosciuta. |
duration_in_traffic
facoltativo |
Tipo:
Duration optionalLa durata totale di questa tappa, tenendo conto delle condizioni del traffico indicate dalla proprietà trafficModel. Questa proprietà potrebbe essere undefined perché la durata potrebbe essere sconosciuta. |
Interfaccia DirectionsStep
Interfaccia google.maps.DirectionsStep
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:
stringUna rappresentazione di polilinea codificata del passaggio. Questo è un percorso approssimativo (smussato) del passaggio. |
end_location |
Tipo:
LatLngLa località di arrivo di questo passaggio. |
|
Tipo:
LatLngLa località di arrivo di questo passaggio. |
instructions |
Tipo:
stringIstruzioni per questo passaggio. |
|
Una sequenza di LatLng che descrive il percorso di questo passaggio. Questo è un percorso approssimativo (smussato) del passaggio. |
maneuver |
Tipo:
stringContiene 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 descrive il percorso di questo passaggio. Questo è un percorso approssimativo (smussato) del passaggio. |
start_location |
Tipo:
LatLngLa posizione di partenza di questo passaggio. |
|
Tipo:
LatLngLa posizione di partenza di questo passaggio. |
travel_mode |
Tipo:
TravelModeLa modalità di viaggio utilizzata in questo passaggio. |
distance
facoltativo |
Tipo:
Distance optionalLa distanza coperta da questo passaggio. Questa proprietà potrebbe essere undefined perché la distanza potrebbe essere sconosciuta. |
duration
facoltativo |
Tipo:
Duration optionalIl tempo tipico richiesto per eseguire questo passaggio in secondi e sotto forma di testo. Questa proprietà potrebbe essere undefined perché la durata potrebbe essere sconosciuta. |
facoltativo |
Tipo:
DirectionsPolyline optionalContiene un oggetto con una singola proprietà, "points", che contiene una rappresentazione della polyline codificata del passaggio. Questa polilinea è un percorso approssimativo (smussato) del passaggio. |
steps
facoltativo |
Tipo:
Array<DirectionsStep> optionalSottopassaggi di questo passaggio. Specificato per le sezioni non di transito delle route di transito. |
transit
facoltativo |
Tipo:
TransitDetails optionalDettagli specifici del 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
facoltativo |
Tipo:
TransitDetails optionalDettagli relativi a questo passaggio se la modalità di viaggio è TRANSIT. |
Interfaccia DirectionsPolyline
Interfaccia google.maps.DirectionsPolyline
Un oggetto contenente una proprietà points per descrivere la polilinea di un DirectionsStep.
Proprietà | |
|---|---|
points |
Tipo:
stringUna polilinea codificata. |
Interfaccia Place
Interfaccia google.maps.Place
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, consulta PlacesService.
Proprietà | |
|---|---|
location
facoltativo |
Tipo:
LatLng|LatLngLiteral optionalLa proprietà LatLng dell'entità descritta da questo luogo. |
placeId
facoltativo |
Tipo:
string optionalL'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 TextSearch. Gli ID luogo possono essere recuperati anche dalle richieste all'API Geocoding. Per saperne di più, consulta la panoramica degli ID luogo. |
query
facoltativo |
Tipo:
string optionalUna 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
libreria di costanti
"routes"
Le modalità di viaggio valide che possono essere specificate in un DirectionsRequest, nonché le modalità di viaggio restituite in un DirectionsStep. Specifica questi valori in base al valore o utilizzando il nome della costante. Ad esempio: 'BICYCLING' o google.maps.TravelMode.BICYCLING.
Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo TravelModeString.
const {TravelMode} = await google.maps.importLibrary("routes");
Costanti | |
|---|---|
BICYCLING |
Specifica una richiesta di indicazioni in bicicletta. |
DRIVING |
Specifica una richiesta di indicazioni stradali. |
TRANSIT |
Specifica una richiesta di indicazioni per il trasporto pubblico. |
|
Specifica una richiesta di indicazioni stradali per motocicli. |
WALKING |
Specifica una richiesta di indicazioni a piedi. |
Interfaccia DrivingOptions
Interfaccia google.maps.DrivingOptions
Configura DirectionsRequest quando la modalità di viaggio è impostata su DRIVING.
Proprietà | |
|---|---|
departureTime |
Tipo:
DateL'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é DrivingOptions sia valido. L'orario di partenza deve essere impostato sull'ora corrente o su un'ora futura. Non può essere nel passato. |
trafficModel
facoltativo |
Tipo:
TrafficModel optionalL'ipotesi preferita da utilizzare per prevedere la durata nel traffico. Il valore predefinito è BEST_GUESS. |
Costanti TrafficModel
google.maps.TrafficModel
libreria di costanti
"routes"
Le ipotesi da utilizzare per prevedere la durata nel traffico. Specificato come parte di un DirectionsRequest o DistanceMatrixRequest. Specifica questi valori in base al valore o utilizzando il nome della costante. Ad esempio: 'bestguess' o google.maps.TrafficModel.BEST_GUESS.
Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo TrafficModelString.
const {TrafficModel} = await google.maps.importLibrary("routes");
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 nel traffico. |
PESSIMISTIC |
Utilizza i dati storici sul traffico per fare una stima pessimistica della durata nel traffico. |
Interfaccia TransitOptions
Interfaccia google.maps.TransitOptions
L'oggetto TransitOptions da includere in un DirectionsRequest quando la modalità di viaggio è impostata su TRANSIT.
Proprietà | |
|---|---|
arrivalTime
facoltativo |
Tipo:
Date optionalL'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
facoltativo |
Tipo:
Date optionalL'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 vengono specificate né l'ora di partenza né l'ora di arrivo, l'ora viene considerata "adesso". |
modes
facoltativo |
Tipo:
Array<TransitMode> optionalUno o più mezzi di trasporto pubblico preferiti, ad esempio autobus o treno. Se non viene specificata alcuna preferenza, l'API restituisce il percorso migliore predefinito. |
routingPreference
facoltativo |
Tipo:
TransitRoutePreference optionalUna 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
libreria di costanti
"routes"
La modalità Mezzi pubblici valida, ad esempio l'autobus, che può essere specificata in un TransitOptions. Specifica questi valori in base al valore o utilizzando il nome della costante. Ad esempio: 'BUS' o google.maps.TransitMode.BUS.
Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo TransitModeString.
const {TransitMode} = await google.maps.importLibrary("routes");
Costanti | |
|---|---|
BUS |
Specifica l'autobus come mezzo di trasporto pubblico preferito. |
|
Specifica la metropolitana leggera come modalità di trasporto pubblico preferita. |
RAIL |
Specifica la ferrovia come modalità di trasporto preferita. |
SUBWAY |
Specifica la metropolitana come modalità di trasporto pubblico preferita. |
TRAIN |
Specifica il treno come modalità di trasporto preferita. |
TRAM |
Specifica il tram come modalità di trasporto preferita. |
Costanti TransitRoutePreference
google.maps.TransitRoutePreference
libreria di costanti
"routes"
Il tipo di percorso di routing transitivo valido che può essere specificato in un TransitOptions. Specifica questi valori in base al valore o utilizzando il nome della costante. Ad esempio: 'LESS_WALKING' o google.maps.TransitRoutePreference.LESS_WALKING.
Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo TransitRoutePreferenceString.
const {TransitRoutePreference} = await google.maps.importLibrary("routes");
Costanti | |
|---|---|
FEWER_TRANSFERS |
Specifica che il percorso calcolato deve preferire un numero limitato di cambi. |
LESS_WALKING |
Specifica che il percorso calcolato deve preferire quantità limitate di camminata. |
Interfaccia TransitFare
Interfaccia google.maps.TransitFare
Una tariffa di un DirectionsRoute composta da valore e valuta.
Proprietà | |
|---|---|
currency |
Tipo:
stringUn codice valuta ISO 4217 che indica la valuta in cui è espressa la tariffa. |
text |
Tipo:
stringIl valore della tariffa, espresso nella valuta currency specificata, come stringa. |
value |
Tipo:
numberIl valore numerico della tariffa, espresso nella valuta currency specificata. |
Interfaccia TransitDetails
Interfaccia google.maps.TransitDetails
Dettagli sulla partenza, sull'arrivo e sulla modalità di transito utilizzata in questo passaggio.
Proprietà | |
|---|---|
arrival_stop |
Tipo:
TransitStopLa fermata di arrivo di questo passaggio del trasporto pubblico. |
arrival_time |
Tipo:
TimeL'ora di arrivo di questo passaggio, specificata come oggetto Time. |
departure_stop |
Tipo:
TransitStopLa fermata di partenza di questo passaggio del trasporto pubblico. |
departure_time |
Tipo:
TimeL'orario di partenza di questo passaggio, specificato come oggetto Time. |
headsign |
Tipo:
stringLa direzione di viaggio su questa linea, come indicato sul veicolo o alla fermata di partenza. |
headway |
Tipo:
numberIl numero previsto di secondi tra veicoli equivalenti in questa fermata. |
line |
Tipo:
TransitLineDettagli sulla linea di trasporto pubblico utilizzata in questo passaggio. |
num_stops |
Tipo:
numberIl numero di fermate in questo passaggio. Include la fermata di arrivo, ma non quella di partenza. |
trip_short_name |
Tipo:
stringIl testo che appare negli orari e nei cartelli per identificare una corsa di trasporto pubblico per i passeggeri, ad esempio per identificare i numeri dei treni per le corse dei treni per pendolari. Il testo identifica in modo univoco una corsa nell'ambito di un giorno di servizio. |
Interfaccia TransitStop
Interfaccia google.maps.TransitStop
Dettagli su una fermata o una stazione di trasporto pubblico.
Proprietà | |
|---|---|
location |
Tipo:
LatLngLa posizione di questa fermata. |
name |
Tipo:
stringIl nome della fermata di trasporto pubblico. |
Interfaccia TransitLine
Interfaccia google.maps.TransitLine
Informazioni sulla linea di trasporto pubblico che gestisce questa fase del percorso.
Proprietà | |
|---|---|
agencies |
Tipo:
Array<TransitAgency>L'azienda di trasporto pubblico che gestisce questa linea di trasporto pubblico. |
color |
Tipo:
stringIl colore di uso comune nella segnaletica per questa linea di trasporto pubblico, rappresentato come stringa esadecimale. |
icon |
Tipo:
stringL'URL di un'icona associata a questa linea. |
name |
Tipo:
stringIl nome completo della linea di trasporto pubblico, ad esempio "8 Avenue Local". |
short_name |
Tipo:
stringIl nome breve di questa linea di trasporto pubblico, ad esempio "E". |
text_color |
Tipo:
stringIl colore del testo di uso comune nella segnaletica per questa linea di trasporto pubblico, rappresentato come stringa esadecimale. |
url |
Tipo:
stringL'URL dell'agenzia specifico per questa linea di trasporto pubblico. |
vehicle |
Tipo:
TransitVehicleIl tipo di veicolo utilizzato, ad esempio treno o autobus. |
Interfaccia TransitAgency
Interfaccia google.maps.TransitAgency
Informazioni su un'azienda che gestisce una linea di trasporto pubblico.
Proprietà | |
|---|---|
name |
Tipo:
stringIl nome di questa azienda di trasporto pubblico. |
phone |
Tipo:
stringIl numero di telefono dell'azienda di trasporto pubblico. |
url |
Tipo:
stringL'URL dell'azienda di trasporto pubblico. |
Interfaccia TransitVehicle
Interfaccia google.maps.TransitVehicle
Informazioni sul veicolo che opera su una linea di trasporto pubblico.
Proprietà | |
|---|---|
icon |
Tipo:
stringUn URL per un'icona che corrisponde al tipo di veicolo utilizzato su questa linea. |
local_icon |
Tipo:
stringUn URL per un'icona che corrisponde al tipo di veicolo utilizzato in questa regione anziché all'icona più generica. |
name |
Tipo:
stringUn nome per questo tipo di TransitVehicle, ad esempio "Treno" o "Autobus". |
type |
Tipo:
VehicleTypeIl tipo di veicolo utilizzato, ad esempio treno, autobus o traghetto. |
Costanti VehicleType
google.maps.VehicleType
libreria di costanti
"routes"
Possibili valori per i tipi di veicolo.
Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo VehicleTypeString.
const {VehicleType} = await google.maps.importLibrary("routes");
Costanti | |
|---|---|
BUS |
Bus. |
CABLE_CAR |
Un veicolo che funziona su un cavo, di solito a terra. Le funivie possono essere del tipo GONDOLA_LIFT. |
COMMUTER_TRAIN |
Treno pendolare. |
FERRY |
Traghetto. |
FUNICULAR |
Un veicolo che viene trainato su un pendio ripido 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 |
Monorotaia. |
OTHER |
Altri veicoli. |
RAIL |
Treno. |
SHARE_TAXI |
Il taxi condiviso è una sorta di trasporto in autobus con la possibilità di far scendere e salire i passeggeri in qualsiasi punto del percorso. In genere, i taxi condivisi utilizzano minibus. |
SUBWAY |
Metropolitana leggera sotterranea. |
TRAM |
Metropolitana leggera in superficie. |
TROLLEYBUS |
Filobus. |
Costanti UnitSystem
google.maps.UnitSystem
libreria di costanti
"core"
I sistemi di unità validi che possono essere specificati in un DirectionsRequest.
const {UnitSystem} = await google.maps.importLibrary("core");
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à di misura metriche. |
Interfaccia Distanza
Interfaccia google.maps.Distance
Una rappresentazione della distanza come valore numerico e stringa di visualizzazione.
Proprietà | |
|---|---|
text |
Tipo:
stringUna rappresentazione di stringa del valore della distanza, utilizzando l'unità UnitSystem specificata nella richiesta. |
value |
Tipo:
numberLa distanza in metri. |
Interfaccia Durata
Interfaccia google.maps.Duration
Una rappresentazione della durata come valore numerico e stringa di visualizzazione.
Proprietà | |
|---|---|
text |
Tipo:
stringUna rappresentazione di stringa del valore della durata. |
value |
Tipo:
numberLa durata in secondi. |
Interfaccia Time
Interfaccia google.maps.Time
Una rappresentazione dell'ora come oggetto Date, una stringa localizzata e un fuso orario.
Proprietà | |
|---|---|
text |
Tipo:
stringUna stringa che rappresenta il valore dell'ora. L'orario viene visualizzato nel fuso orario della fermata dei mezzi pubblici. |
time_zone |
Tipo:
stringIl 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:
DateL'ora di questa partenza o di questo arrivo, specificata come oggetto Date di JavaScript. |