Distance Matrix

Classe DistanceMatrixService

google.maps.DistanceMatrixService classe

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 oggetto DistanceMatrixService che invia query sulla matrice di distanza ai server di Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parametri: 
Valore restituito:  Promise<DistanceMatrixResponse>
Emette una richiesta della matrice di distanza.

Interfaccia DistanceMatrixRequest

Interfaccia google.maps.DistanceMatrixRequest

Una query sulla matrice di distanza inviata da DistanceMatrixService contenente array di località di origine e di destinazione e varie opzioni per il calcolo delle metriche.
destinations
Un array contenente stringhe di indirizzi di destinazione, o oggetti LatLng, o Place, con cui calcolare la distanza e il tempo. obbligatorio.
origins
Un array contenente stringhe indirizzo di origine, o oggetti LatLng, o Place, da cui calcolare la distanza e il 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, ove possibile. Campo facoltativo.
avoidTolls optional
Tipo:  boolean optional
Se true, indica al servizio Distance Matrix di evitare le strade a pedaggio, ove 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 altre modalità di viaggio.
language optional
Tipo:  string optional
Un identificatore della lingua per la lingua in cui restituire 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 ccTLD ("dominio di primo livello") a due caratteri. La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD del Regno Unito è "uk " (.co.uk), mentre il codice ISO 3166-1 è"gb " (tecnicamente per l'entità "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 altre modalità di viaggio.
unitSystem optional
Tipo:  UnitSystem optional
Sistema di unità preferito da utilizzare per la visualizzazione della distanza. Facoltativo; il valore predefinito è Metrica.

Interfaccia DistanceMatrixResponse

Interfaccia google.maps.DistanceMatrixResponse

La risposta a una richiesta DistanceMatrixService, composta da indirizzi di origine e destinazione formattati e una sequenza di DistanceMatrixResponseRow, una 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

Interfaccia google.maps.DistanceMatrixResponseRow

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

Interfaccia DistanceMatrixResponseElement

Interfaccia google.maps.DistanceMatrixResponseElement

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

Costanti di DistanceMatrixStatus

google.maps.DistanceMatrixStatus costanti

Lo stato di primo livello relativo alla richiesta in generale restituito da DistanceMatrixService al completamento di una richiesta della matrice di distanza. Specificali 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 avere esito positivo se riprovi più tardi.
REQUEST_DENIED Il servizio ha negato l'uso del servizio Distance Matrix da parte della tua pagina web.
UNKNOWN_ERROR Impossibile elaborare una richiesta Distance Matrix a causa di un errore del server. Se riprovi, la richiesta potrebbe riuscire.

Costanti di DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus costanti

Lo stato a livello di elemento relativo a una determinata associazione origine-destinazione restituito da DistanceMatrixService al completamento di una richiesta della 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 Non è stato trovato alcun percorso tra l'origine e la destinazione.