Route Matrix

Classe RouteMatrix

classe google.maps.routes.RouteMatrix
libreria "routes"

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

const {RouteMatrix} = await google.maps.importLibrary("routes");

Metodi statici

computeRouteMatrix

computeRouteMatrix(request) Parametri: request: ComputeRouteMatrixRequest 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.

Proprietà
rows readonly	Tipo: Array<RouteMatrixRow> 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.

Metodi
Ereditato: toJSON

Classe RouteMatrixRow

classe google.maps.routes.RouteMatrixRow
libreria "routes"

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

const {RouteMatrixRow} = await google.maps.importLibrary("routes");

Proprietà
items readonly	Tipo: Array<RouteMatrixItem> Le informazioni sul percorso per ogni destinazione.

Metodi
Ereditato: toJSON

Classe RouteMatrixItem

classe google.maps.routes.RouteMatrixItem
libreria "routes"

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

const {RouteMatrixItem} = await google.maps.importLibrary("routes");

Proprietà
condition readonly	Tipo: RouteMatrixItemCondition optional Indica se il percorso è stato trovato o meno.
distanceMeters readonly	Tipo: number optional La distanza di percorrenza del percorso in metri.
durationMillis readonly	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 readonly	Tipo: RouteMatrixItemError optional Errore che si è verificato durante il calcolo del percorso.
fallbackInfo readonly	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 readonly	Tipo: RouteMatrixItemLocalizedValues optional Rappresentazioni testuali delle proprietà di RouteMatrixItem.
staticDurationMillis readonly	Tipo: number optional La durata del viaggio lungo il percorso senza tenere conto delle condizioni del traffico. Nota: se la durata supera 2^53 millisecondi, questo valore è Number.POSITIVE_INFINITY.
travelAdvisory readonly	Tipo: RouteTravelAdvisory optional Informazioni aggiuntive sul percorso.

Interfaccia ComputeRouteMatrixRequest

interfaccia google.maps.routes.ComputeRouteMatrixRequest

Richiesta di una matrice di percorsi.

Proprietà
destinations	Tipo: Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint> 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	Tipo: Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint> 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 facoltativo	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 facoltativo	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 facoltativo	Tipo: Iterable<ComputeRouteMatrixExtraComputation> 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.
internalUsageAttributionIds facoltativo	Tipo: Iterable<string> optional Identificatori utilizzati per attribuire le chiamate a pacchetti o librerie OSS specifici.
language facoltativo	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 facoltativo	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 facoltativo	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 facoltativo	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 facoltativo	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 facoltativo	Tipo: TravelMode optional Specifica la modalità di trasporto.
units facoltativo	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

constants google.maps.routes.ComputeRouteMatrixExtraComputation
library "routes"

Calcoli aggiuntivi da eseguire durante il completamento della richiesta. Per saperne di più, consulta la documentazione del servizio web.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo ComputeRouteMatrixExtraComputationString.

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes");

Costanti
TOLLS	Informazioni sui pedaggi per gli elementi della matrice. Per saperne di più, consulta la documentazione del servizio web.

Costanti RouteMatrixItemCondition

constants google.maps.routes.RouteMatrixItemCondition
library "routes"

La condizione del percorso restituito. Per saperne di più, consulta la documentazione del servizio web.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo RouteMatrixItemConditionString.

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes");

Costanti
ROUTE_EXISTS	È stato trovato un percorso e le informazioni corrispondenti sono state inserite per l'elemento. Per saperne di più, consulta la documentazione del servizio web.
ROUTE_NOT_FOUND	Nessun percorso trovato. Per saperne di più, consulta la documentazione del servizio web.

Classe RouteMatrixItemError

class google.maps.routes.RouteMatrixItemError extends Error
library "routes"

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

const {RouteMatrixItemError} = await google.maps.importLibrary("routes");

Metodi
Ereditato: toJSON

Classe RouteMatrixItemLocalizedValues

classe google.maps.routes.RouteMatrixItemLocalizedValues
libreria "routes"

Rappresentazioni testuali di RouteMatrixItem.

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes");

Proprietà
distance readonly	Tipo: string optional Distanza di viaggio dell'elemento della matrice di percorsi in formato testo.
distanceLanguage readonly	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 readonly	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 readonly	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 readonly	Tipo: string optional Durata senza tenere conto delle condizioni del traffico, rappresentata in formato di testo.
staticDurationLanguage readonly	Tipo: string optional Il codice lingua BCP-47 del testo statico della durata, ad esempio "en-US" o "sr-Latn".
transitFare readonly	Tipo: string optional Tariffa del trasporto pubblico, rappresentata in formato di testo.
transitFareLanguage readonly	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.

Metodi
Ereditato: toJSON

Interfaccia RouteMatrixOrigin

interfaccia google.maps.routes.RouteMatrixOrigin

Un'origine singola per un ComputeRouteMatrixRequest.

Proprietà
waypoint	Tipo: string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|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 facoltativo	Tipo: RouteModifiers optional Modificatori per ogni percorso che utilizza questo punto come origine.