Route Matrix (beta)

Classe RouteMatrix

google.maps.routes.RouteMatrix classe

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

Accesso 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 del campo di risposta nella richiesta impostando la proprietà ComputeRouteMatrixRequest.fields. Il valore è un elenco di percorsi dei campi.

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

L'utilizzo della maschera per il campo della risposta con carattere jolly fields: ['*'] è sconsigliato perché:
  • Se selezioni solo i campi di cui hai bisogno, il nostro server risparmia cicli di calcolo, il che ci consente di restituirti il risultato con una latenza inferiore.
  • Selezionando solo i campi necessari nel job di produzione, si garantisce una latenza stabile. In futuro potremmo aggiungere altri campi di risposta e questi nuovi campi potrebbero richiedere tempi di calcolo aggiuntivi. Se selezioni tutti i campi o tutti i campi a livello principale, potresti riscontrare un peggioramento delle prestazioni perché qualsiasi nuovo campo che aggiungiamo verrà incluso automaticamente nella risposta.
  • Se selezioni solo i campi di cui hai bisogno, le dimensioni della risposta saranno inferiori e 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

google.maps.routes.RouteMatrixRow classe

Corrisponde a un'origine passata a RouteMatrix.computeRouteMatrix. Contiene un elenco di RouteMatrixItem, ogni elemento rappresenta un percorso verso una destinazione.

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

RouteMatrixItem class

google.maps.routes.RouteMatrixItem classe

Contiene le informazioni sull'itinerario calcolate per una coppia di origine/destinazione passata a RouteMatrix.computeRouteMatrix.

Accesso chiamando il numero const {RouteMatrixItem} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.
condition
Tipo:  RouteMatrixItemCondition optional
Indica se l'itinerario è stato trovato o meno.
distanceMeters
Tipo:  number optional
La distanza di percorrenza dell'itinerario in metri.
durationMillis
Tipo:  number optional
Il tempo necessario per percorrere l'itinerario 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 2^53 millisecondi, questo valore è Number.POSITIVE_INFINITY.
error
Tipo:  RouteMatrixItemError optional
Errore verificatosi durante il calcolo del percorso.
fallbackInfo
Tipo:  FallbackInfo optional
In alcuni casi, quando il server non è in grado di calcolare l'itinerario con le preferenze specificate per questa particolare coppia origine/destinazione, potrebbe ricorrere a una modalità di calcolo diversa. Quando viene utilizzata una risposta di riserva, questo campo contiene informazioni dettagliate sulla risposta di riserva. 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 prendere in considerazione le condizioni del traffico.

Nota: se la durata supera 2^53 millisecondi, questo valore è Number.POSITIVE_INFINITY.
travelAdvisory
Tipo:  RouteTravelAdvisory optional
Informazioni aggiuntive sull'itinerario.

Interfaccia ComputeRouteMatrixRequest

google.maps.routes.ComputeRouteMatrixRequest interfaccia

Richiesta di una matrice di itinerari.
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 il nome di una 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 il nome di una risorsa Place. I valori di altitudine non vengono presi in considerazione.

Alla cardinalità di origini e destinazioni si applicano diverse limitazioni di 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. I viaggi con il trasporto pubblico sono disponibili fino a 7 giorni nel passato o 100 giorni nel futuro.
departureTime optional
Tipo:  Date optional
L'orario di partenza. Se non imposti questo valore, il valore predefinito è l'ora in cui hai effettuato la richiesta.

Nota: puoi specificare un orario nel passato solo quando ComputeRouteMatrixRequest.travelMode è impostato su TRANSIT. I viaggi con il trasporto pubblico sono disponibili fino a 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 extra 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 ulteriori informazioni, consulta Identificatore di località Unicode. Consulta la sezione Supporto delle lingue per l'elenco delle lingue supportate. Se non fornisci questo valore, la lingua viene dedotta dalle impostazioni di localizzazione dell'API Google Maps JavaScript. In caso contrario, la lingua viene dedotta dalla posizione della prima origine.
region optional
Tipo:  string optional
Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Per ulteriori informazioni, vedi Domini di primo livello nazionali. Se non fornisci questo valore, la regione viene dedotta dalle impostazioni di localizzazione dell'API Google 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 rotte. 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 i presupposti da utilizzare per il calcolo del tempo nel traffico. Questa impostazione influisce sul valore restituito in RouteMatrixItem.durationMillis, che contiene il tempo previsto nel traffico in base alle medie storiche. ComputeRouteMatrixRequest.trafficModel è disponibile solo per le richieste in cui ComputeRouteMatrixRequest.routingPreference è impostato su TRAFFIC_AWARE_OPTIMAL e ComputeRouteMatrixRequest.travelMode su DRIVING. Il valore predefinito è BEST_GUESS.
transitPreference optional
Tipo:  TransitPreference optional
Specifica le preferenze che influenzano il 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

google.maps.routes.ComputeRouteMatrixExtraComputation costanti

Calcoli aggiuntivi da eseguire per una richiesta RouteMatrix.computeRouteMatrix.

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

Costanti RouteMatrixItemCondition

google.maps.routes.RouteMatrixItemCondition costanti

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

Accesso 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.

RouteMatrixItemError class

google.maps.routes.RouteMatrixItemError classe

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

Questo corso si estende Error.

Accesso 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

google.maps.routes.RouteMatrixItemLocalizedValues classe

Rappresentazioni testuali di RouteMatrixItem.

Accesso 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 itinerari in formato di testo.
distanceLanguage
Tipo:  string optional
Il codice lingua BCP-47 del testo della distanza, ad esempio "en-US" o "sr-Latn".

Per ulteriori informazioni, visita la pagina http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Tipo:  string optional
Durata, rappresentata in formato di testo e localizzata nella regione della query. Prende in considerazione le condizioni del traffico.

Nota: se non hai richiesto informazioni sul traffico, questo valore è uguale 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, visita 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 della durata statica, 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 del trasporto pubblico, ad esempio "en-US" o "sr-Latn".

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

RouteMatrixOrigin

google.maps.routes.RouteMatrixOrigin interfaccia

Una singola origine per un ComputeRouteMatrixRequest.
waypoint
La posizione 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 lo utilizza come origine.