Route Matrix

Classe RouteMatrix

Classe google.maps.routes.RouteMatrix

Una matrice di percorsi calcolati per un insieme di coppie di origine/destinazione da RouteMatrix.computeRouteMatrix

Accedi chiamando il numero const {RouteMatrix} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.
computeRouteMatrix
computeRouteMatrix(request)
Parametri: 
Valore restituito:  Promise<{matrix:RouteMatrix}>
Accetta un elenco di origini e destinazioni e restituisce una matrice contenente le informazioni sul percorso per ogni combinazione di origine e destinazione.

Nota: questo metodo richiede di specificare una maschera di campo della risposta nella richiesta impostando la proprietà ComputeRouteMatrixRequest.fields. Il valore è un elenco di percorsi dei campi.

Ad esempio:
  • Maschera di tutti i campi disponibili: fields: ['*']
  • Maschera di campo della durata e della distanza a livello di percorso: fields: ['durationMillis', 'distanceMeters']

L'utilizzo della maschera per il campo di risposta con carattere jolly fields: ['*'] è sconsigliato perché:
  • Selezionando solo i campi necessari, il nostro server risparmia cicli di calcolo, consentendoci di restituirti il risultato con una latenza inferiore.
  • Selezionando solo i campi necessari nel job di produzione, garantisci prestazioni di latenza stabili. In futuro potremmo aggiungere altri campi di risposta, che potrebbero richiedere un tempo di calcolo aggiuntivo. Se selezioni tutti i campi o tutti i campi di primo livello, potresti riscontrare un peggioramento delle prestazioni perché ogni nuovo campo che aggiungiamo verrà incluso automaticamente nella risposta.
  • Selezionando solo i campi necessari, le dimensioni della risposta saranno inferiori e, di conseguenza, il caricamento sulla rete sarà più rapido.
rows
Le righe della matrice. Ogni riga corrisponde a un'origine e contiene un array di RouteMatrixItem, ognuno dei quali rappresenta un percorso verso una destinazione.
toJSON
toJSON()
Parametri: nessuno
Valore restituito:  Object
Converte in un oggetto.

Classe RouteMatrixRow

Classe google.maps.routes.RouteMatrixRow

Corrisponde a un'origine passata a RouteMatrix.computeRouteMatrix. Contiene un elenco di RouteMatrixItem, ognuno dei quali rappresenta un percorso verso una destinazione.

Accedi chiamando il numero const {RouteMatrixRow} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.
items
Le informazioni sul percorso per ogni destinazione.
toJSON
toJSON()
Parametri: nessuno
Valore restituito:  Object
Converte in un oggetto.

Classe RouteMatrixItem

Classe google.maps.routes.RouteMatrixItem

Contiene le informazioni sul percorso calcolate per una coppia di origine/destinazione passata a RouteMatrix.computeRouteMatrix.

Accedi chiamando il numero const {RouteMatrixItem} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.
condition
Tipo:  RouteMatrixItemCondition optional
Indica se il percorso è stato trovato o meno.
distanceMeters
Tipo:  number optional
La distanza di percorrenza del percorso in metri.
durationMillis
Tipo:  number optional
Il tempo necessario per percorrere il percorso in millisecondi. Se imposti ComputeRouteMatrixRequest.routingPreference su TRAFFIC_UNAWARE, questo valore è uguale a RouteMatrixItem.staticDurationMillis. Se imposti ComputeRouteMatrixRequest.routingPreference su TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, questo valore viene calcolato tenendo conto delle condizioni del traffico.

Nota: se la durata supera i 2^53 millisecondi, questo valore è Number.POSITIVE_INFINITY.
error
Tipo:  RouteMatrixItemError optional
Errore che si è verificato durante il calcolo del percorso.
fallbackInfo
Tipo:  FallbackInfo optional
In alcuni casi, quando il server non è in grado di calcolare il percorso con le preferenze specificate per questa particolare coppia di origine/destinazione, potrebbe ricorrere a una modalità di calcolo diversa. Quando viene utilizzato un fallback, questo campo contiene informazioni dettagliate sulla risposta di fallback. In caso contrario, questo campo non è impostato.
localizedValues
Rappresentazioni testuali delle proprietà di RouteMatrixItem.
staticDurationMillis
Tipo:  number optional
La durata del viaggio lungo il percorso senza tenere conto delle condizioni del traffico.

Nota: se la durata supera i 2^53 millisecondi, questo valore è Number.POSITIVE_INFINITY.
travelAdvisory
Tipo:  RouteTravelAdvisory optional
Informazioni aggiuntive sul percorso.
toJSON
toJSON()
Parametri: nessuno
Valore restituito:  Object
Converte in un oggetto.

Interfaccia ComputeRouteMatrixRequest

Interfaccia google.maps.routes.ComputeRouteMatrixRequest

Richiesta di una matrice di percorsi.
destinations
Array di destinazioni, che determina le colonne della matrice di risposta. Un valore passato come stringa può essere un indirizzo, un Plus Code o un nome della risorsa Place. I valori di altitudine non vengono presi in considerazione.
fields
Tipo:  Iterable<string>
Raccolta di campi da recuperare. Specifica ["*"] per tutti i campi.
origins
Array di origini, che determina le righe della matrice di risposta. Un valore passato come stringa può essere un indirizzo, un Plus Code o un nome della risorsa Place. I valori di altitudine non vengono presi in considerazione.

Alla cardinalità di origini e destinazioni si applicano diverse limitazioni relative alle dimensioni:
  • Il numero totale di origini e destinazioni specificate come string o Place non deve essere superiore a 50.
  • Il prodotto del numero di origini e del numero di destinazioni non deve essere superiore a 625.
  • Il prodotto del numero di origini e destinazioni non deve essere superiore a 100 se ComputeRouteMatrixRequest.routingPreference è impostato su TRAFFIC_AWARE_OPTIMAL.
  • Il prodotto del numero di origini e destinazioni non deve essere superiore a 100 se ComputeRouteMatrixRequest.travelMode è impostato su TRANSIT.
arrivalTime optional
Tipo:  Date optional
L'ora di arrivo.

Nota: può essere impostato solo quando ComputeRouteMatrixRequest.travelMode è impostato su TRANSIT. Puoi specificare ComputeRouteMatrixRequest.departureTime o ComputeRouteMatrixRequest.arrivalTime, ma non entrambi. Le corse con il trasporto pubblico sono disponibili per un massimo di 7 giorni nel passato o 100 giorni nel futuro.
departureTime optional
Tipo:  Date optional
L'ora di partenza. Se non imposti questo valore, il valore predefinito corrisponde all'ora in cui hai effettuato la richiesta.

Nota: puoi specificare un'ora nel passato solo quando ComputeRouteMatrixRequest.travelMode è impostato su TRANSIT. Le corse con il trasporto pubblico sono disponibili per un massimo di 7 giorni nel passato o 100 giorni nel futuro.
extraComputations optional
Un elenco di calcoli aggiuntivi che possono essere utilizzati per completare la richiesta.

Nota: questi calcoli aggiuntivi potrebbero restituire campi aggiuntivi nella risposta. Questi campi aggiuntivi devono essere specificati anche in ComputeRouteMatrixRequest.fields per essere restituiti nella risposta.
language optional
Tipo:  string optional
Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per saperne di più, consulta Identificatore di impostazioni internazionali Unicode. Consulta Supporto delle lingue per l'elenco delle lingue supportate. Se non fornisci questo valore, la lingua viene dedotta dalle impostazioni di localizzazione dell'API Maps JavaScript di Google. In caso contrario, la lingua viene dedotta dalla località della prima origine.
region optional
Tipo:  string optional
Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Per saperne di più, consulta Domini di primo livello nazionali. Se non fornisci questo valore, la regione viene dedotta dalle impostazioni di localizzazione dell'API Maps JavaScript. In caso contrario, la regione viene dedotta dalla posizione della prima origine.
routingPreference optional
Tipo:  RoutingPreference optional
Specifica come calcolare la matrice delle route. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare la matrice delle route. Se la preferenza di routing genera un errore o una latenza molto lunga, viene restituito un errore. Puoi specificare questa opzione solo quando ComputeRouteMatrixRequest.travelMode è DRIVING o TWO_WHEELER, altrimenti la richiesta non va a buon fine.
trafficModel optional
Tipo:  TrafficModel optional
Specifica le ipotesi da utilizzare per il calcolo del tempo nel traffico. Questa impostazione influisce sul valore restituito in RouteMatrixItem.durationMillis, che contiene il tempo di percorrenza previsto in base alle medie storiche. ComputeRouteMatrixRequest.trafficModel è disponibile solo per le richieste che hanno impostato ComputeRouteMatrixRequest.routingPreference su TRAFFIC_AWARE_OPTIMAL e ComputeRouteMatrixRequest.travelMode su DRIVING. Il valore predefinito è BEST_GUESS.
transitPreference optional
Tipo:  TransitPreference optional
Specifica le preferenze che influiscono sul percorso restituito per i percorsi TRANSIT.

Nota: può essere specificato solo quando ComputeRouteMatrixRequest.travelMode è impostato su TRANSIT.
travelMode optional
Tipo:  TravelMode optional
Specifica la modalità di trasporto.
units optional
Tipo:  UnitSystem optional
Specifica le unità di misura per i campi di visualizzazione. Se non fornisci questo valore, le unità di visualizzazione vengono dedotte dalla posizione della prima origine.

Costanti ComputeRouteMatrixExtraComputation

Costanti google.maps.routes.ComputeRouteMatrixExtraComputation

Calcoli aggiuntivi da eseguire per una richiesta RouteMatrix.computeRouteMatrix.

Accedi chiamando il numero const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.
TOLLS Informazioni sui pedaggi per gli elementi della matrice.

Costanti RouteMatrixItemCondition

Costanti google.maps.routes.RouteMatrixItemCondition

La condizione di un percorso per una determinata coppia di origine/destinazione.

Accedi chiamando il numero const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.
ROUTE_EXISTS È stato trovato un percorso.
ROUTE_NOT_FOUND Nessun percorso trovato.

Classe RouteMatrixItemError

Classe google.maps.routes.RouteMatrixItemError

Un errore che si è verificato durante RouteMatrix.computeRouteMatrix per una coppia di origine/destinazione specifica.

Questa classe estende Error.

Accedi chiamando il numero const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.
toJSON
toJSON()
Parametri: nessuno
Valore restituito:  Object
Converte in un oggetto.

Classe RouteMatrixItemLocalizedValues

Classe google.maps.routes.RouteMatrixItemLocalizedValues

Rappresentazioni testuali di RouteMatrixItem.

Accedi chiamando il numero const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.
distance
Tipo:  string optional
Distanza di viaggio dell'elemento della matrice di percorsi in formato testo.
distanceLanguage
Tipo:  string optional
Il codice lingua BCP-47 del testo della distanza, ad esempio "en-US" o "sr-Latn".

Per ulteriori informazioni, consulta la pagina http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Tipo:  string optional
Durata, rappresentata in formato di testo e localizzata in base alla regione della query. Tiene conto delle condizioni del traffico.

Nota: se non hai richiesto informazioni sul traffico, questo valore corrisponde a RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage
Tipo:  string optional
Il codice lingua BCP-47 del testo della durata, ad esempio "en-US" o "sr-Latn".

Per ulteriori informazioni, consulta la pagina http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Tipo:  string optional
Durata senza tenere conto delle condizioni del traffico, rappresentata in formato di testo.
staticDurationLanguage
Tipo:  string optional
Il codice lingua BCP-47 del testo statico della durata, ad esempio "en-US" o "sr-Latn".
transitFare
Tipo:  string optional
Tariffa del trasporto pubblico, rappresentata in formato di testo.
transitFareLanguage
Tipo:  string optional
Il codice lingua BCP-47 del testo della tariffa di trasporto pubblico, ad esempio "en-US" o "sr-Latn".

Per ulteriori informazioni, consulta la pagina http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
toJSON
toJSON()
Parametri: nessuno
Valore restituito:  Object
Converte in un oggetto.

Interfaccia RouteMatrixOrigin

Interfaccia google.maps.routes.RouteMatrixOrigin

Un'origine singola per un ComputeRouteMatrixRequest.
waypoint
La località dell'origine. Un valore passato come stringa può essere un indirizzo o un Plus Code. I valori di altitudine non vengono presi in considerazione.
routeModifiers optional
Tipo:  RouteModifiers optional
Modificatori per ogni percorso che utilizza questo punto come origine.