Distance Matrix

Classe DistanceMatrixService

lezione google.maps.DistanceMatrixService

Un servizio per il calcolo delle distanze tra più origini e destinazioni.

Accedi chiamando const {DistanceMatrixService} = await google.maps.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.
DistanceMatrixService
DistanceMatrixService()
Parametri: nessuno
Crea una nuova istanza di un elemento DistanceMatrixService che invia query sulla matrice delle distanze ai server di Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parametri: 
Valore restituito:  Promise<DistanceMatrixResponse>
Emette una richiesta di matrice di distanza.

Interfaccia DistanceMatrixRequest

google.maps.DistanceMatrixRequest interfaccia

Una query sulla matrice delle distanze inviata da DistanceMatrixService contenente array di posizioni di origine e di destinazione e varie opzioni per le metriche di computing.
destinations
Una matrice contenente stringhe di indirizzi di destinazione o oggetti LatLng o Place in cui calcolare distanza e tempo. Obbligatorio.
origins
Un array contenente le stringhe degli indirizzi di origine, o oggetti LatLng, o Place, da cui calcolare distanza e tempo. Obbligatorio.
travelMode
Tipo:  TravelMode
Tipo di routing richiesto. Obbligatorio.
avoidFerries optional
Tipo:  boolean optional
Se true, indica al servizio Distance Matrix di evitare i traghetti, ove possibile. Campo facoltativo.
avoidHighways optional
Tipo:  boolean optional
Se true, indica al servizio Distance Matrix di evitare le autostrade, se possibile. Campo facoltativo.
avoidTolls optional
Tipo:  boolean optional
Se true, indica al servizio Distance Matrix di evitare le strade a pedaggio, se possibile. Campo facoltativo.
drivingOptions optional
Tipo:  DrivingOptions optional
Impostazioni che si applicano solo alle richieste in cui travelMode è DRIVING. Questo oggetto non avrà effetto per le altre modalità di viaggio.
language optional
Tipo:  string optional
L'identificatore della lingua della lingua in cui devono essere restituiti i risultati, se possibile. Consulta l'elenco delle lingue supportate.
region optional
Tipo:  string optional
Codice regione utilizzato come bias per le richieste di geocodifica. Il codice regione accetta un valore di due caratteri ccTLD ("primo livello dominio"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune notevoli eccezioni. Ad esempio, il ccTLD del Regno Unito è "uk " (.co.uk) mentre il codice ISO 3166-1 è"gb " (tecnicamente per l'entità del "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à effetto per le altre modalità di viaggio.
unitSystem optional
Tipo:  UnitSystem optional
Sistema di unità preferito da usare per la visualizzazione della distanza. Facoltativo; il valore predefinito è la metrica.

Interfaccia DistanceMatrixResponse

google.maps.DistanceMatrixResponse interfaccia

La risposta a una richiesta DistanceMatrixService, composta dagli indirizzi di origine e di destinazione formattati e una sequenza di DistanceMatrixResponseRow s, uno per ogni indirizzo di origine corrispondente.
destinationAddresses
Tipo:  Array<string>
Gli indirizzi di destinazione formattati.
originAddresses
Tipo:  Array<string>
Gli indirizzi di origine formattati.
rows
Le righe della matrice, corrispondenti agli indirizzi di origine.

Interfaccia DistanceMatrixResponseRow

google.maps.DistanceMatrixResponseRow interfaccia

Una riga della risposta a una richiesta DistanceMatrixService, composta da una sequenza di DistanceMatrixResponseElements, una per ogni indirizzo di destinazione corrispondente.
elements
Gli elementi della riga, corrispondenti agli indirizzi di destinazione.

Interfaccia DistanceMatrixResponseElement

google.maps.DistanceMatrixResponseElement interfaccia

Un singolo elemento di una risposta a una richiesta DistanceMatrixService, contenente la durata e la distanza da un'origine a una destinazione.
distance
Tipo:  Distance
La distanza per questa associazione tra origine e destinazione. Questa proprietà potrebbe non essere definita perché la distanza potrebbe essere sconosciuta.
duration
Tipo:  Duration
La durata di questa associazione tra origine e destinazione. Questa proprietà potrebbe non essere definita perché la durata potrebbe essere sconosciuta.
duration_in_traffic
Tipo:  Duration
La durata di questa associazione tra origine e destinazione, tenendo conto delle condizioni del traffico indicate dalla proprietà trafficModel. Questa proprietà potrebbe essere undefined perché la durata potrebbe essere sconosciuta. Disponibile per i clienti con piano Premium solo quando viene definito drivingOptions al momento della richiesta.
fare
Tipo:  TransitFare
La tariffa totale per questa associazione tra origine e destinazione. Valido solo per le richieste di trasporto pubblico.
status
Lo stato di questa particolare associazione tra origine e destinazione.

Costanti di DistanceMatrixStatus

google.maps.DistanceMatrixStatus costanti

Lo stato di primo livello della richiesta in generale restituito da DistanceMatrixService dopo il completamento di una richiesta di matrice di distanza. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'OK' o google.maps.DistanceMatrixStatus.OK.

Accedi chiamando const {DistanceMatrixStatus} = await google.maps.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.
INVALID_REQUEST La richiesta fornita non è valida.
MAX_DIMENSIONS_EXCEEDED La richiesta contiene più di 25 origini o più di 25 destinazioni.
MAX_ELEMENTS_EXCEEDED Il prodotto delle origini e delle destinazioni supera il limite per query.
OK La risposta contiene un risultato valido.
OVER_QUERY_LIMIT Sono stati richiesti troppi elementi nel periodo di tempo consentito. La richiesta dovrebbe andare a buon fine se continui a riprovare dopo un po' di tempo.
REQUEST_DENIED Il servizio ha negato l'uso del servizio Distance Matrix dalla pagina web.
UNKNOWN_ERROR Impossibile elaborare una richiesta Distance Matrix a causa di un errore del server. Se riprovi, la richiesta potrebbe avere esito positivo.

Costanti di DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus costanti

Lo stato a livello di elemento per una determinata associazione origine-destinazione restituita da DistanceMatrixService al termine di una richiesta di matrice di distanza. Questi valori sono specificati come stringhe, ad esempio 'OK'.

Accedi chiamando const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes"). Consulta la sezione Librerie nell'API Maps JavaScript.
NOT_FOUND Non è stato possibile geocodificare l'origine e/o la destinazione di questa associazione.
OK La risposta contiene un risultato valido.
ZERO_RESULTS Nessun percorso trovato tra l'origine e la destinazione.