Distance Matrix

Classe DistanceMatrixService

google.maps.DistanceMatrixService corso

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

Interfaccia DistanceMatrixRequest

google.maps.DistanceMatrixRequest interfaccia

Una query della matrice di distanza inviata da DistanceMatrixService contenente array di località di partenza 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 per i quali calcolare la distanza e il tempo. Obbligatorio.
origins
Una matrice contenente stringhe di indirizzi di partenza 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, se possibile. Facoltativo.
avoidHighways optional
Tipo:  boolean optional
Se true, indica al servizio Distance Matrix di evitare le autostrade, se possibile. Facoltativo.
avoidTolls optional
Tipo:  boolean optional
Se true, indica al servizio Distance Matrix di evitare le strade a pedaggio, se possibile. Facoltativo.
drivingOptions optional
Tipo:  DrivingOptions optional
Impostazioni che si applicano solo alle richieste in cui travelMode è DRIVING. Questo oggetto non avrà alcun effetto per le altre modalità di viaggio.
language optional
Tipo:  string optional
Un identificatore 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 di ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune eccezioni notevoli. Ad esempio, il TLD di primo livello 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à alcun effetto per le altre modalità di viaggio.
unitSystem optional
Tipo:  UnitSystem optional
Il sistema di unità di misura preferito da utilizzare per la visualizzazione della distanza. Facoltativo. Il valore predefinito è metrico.

Interfaccia DistanceMatrixResponse

google.maps.DistanceMatrixResponse interfaccia

La risposta a una richiesta DistanceMatrixService, costituita dagli indirizzi di origine e di destinazione formattati e da una sequenza di DistanceMatrixResponseRow, 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, costituita da una sequenza di DistanceMatrixResponseElement, uno 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, che contiene la durata e la distanza da un'origine a una destinazione.
distance
Tipo:  Distance
La distanza per questa coppia di origine-destinazione. Questa proprietà potrebbe non essere definita perché la distanza potrebbe essere sconosciuta.
duration
Tipo:  Duration
La durata di questa coppia di origine-destinazione. Questa proprietà potrebbe non essere definita perché la durata potrebbe essere sconosciuta.
duration_in_traffic
Tipo:  Duration
La durata di questa coppia di origine-destinazione, tenendo conto delle condizioni di traffico indicate dalla proprietà trafficModel. Questa proprietà può essere undefined perché la durata potrebbe essere sconosciuta. Disponibile solo per i clienti con piano Premium quando drivingOptions è definito al momento della richiesta.
fare
Tipo:  TransitFare
La tariffa totale per questa coppia di origine-destinazione. Applicabile solo alle richieste relative ai trasporti pubblici.
status
Lo stato di questa specifica coppia di origine-destinazione.

Costanti DistanceMatrixStatus

google.maps.DistanceMatrixStatus costanti

Lo stato di primo livello della richiesta in generale restituito da DistanceMatrixService al termine 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 di origini e 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 riprovi dopo un po' di tempo.
REQUEST_DENIED Il servizio ha negato l'utilizzo del servizio Distance Matrix da parte della tua pagina web.
UNKNOWN_ERROR Non è stato possibile elaborare una richiesta di matrice di distanza a causa di un errore del server. La richiesta potrebbe andare a buon fine se riprovi.

Costanti DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus costanti

Lo stato a livello di elemento relativo a una determinata accoppiata origine-destinazione restituito da DistanceMatrixService al termine di una richiesta di matrice di distanza. Questi valori vengono 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 accoppiata.
OK La risposta contiene un risultato valido.
ZERO_RESULTS Non è stato possibile trovare un percorso tra la stazione di partenza e quella di destinazione.