Distance Matrix

DistanceMatrixService class

google.maps.DistanceMatrixService classe

Un servizio per calcolare le distanze tra più origini e destinazioni.

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

Interfaccia DistanceMatrixRequest

google.maps.DistanceMatrixRequest interfaccia

Una query della matrice delle distanze inviata da DistanceMatrixService contenente array di località di partenza e destinazione e varie opzioni per il calcolo delle metriche.
destinations
Un array contenente stringhe di indirizzi di destinazione, oggetti LatLng o Place, per i quali calcolare la distanza e il tempo. Obbligatorio.
origins
Un array contenente stringhe di indirizzi di origine, 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 altre modalità di viaggio.
language optional
Tipo:  string optional
Un identificatore di lingua per la 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 ("dominio di primo livello"). La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il TLD nazionale del Regno Unito è "uk " (.co.uk), mentre il suo 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 altre modalità di viaggio.
unitSystem optional
Tipo:  UnitSystem optional
Il sistema di unità di misura preferito da utilizzare per visualizzare la distanza. Facoltativo; il valore predefinito è Metrico.

Interfaccia DistanceMatrixResponse

google.maps.DistanceMatrixResponse interfaccia

La risposta a una richiesta DistanceMatrixService, costituita dagli indirizzi di origine e 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.

DistanceMatrixResponseRow interfaccia

google.maps.DistanceMatrixResponseRow interfaccia

Una riga della risposta a una richiesta DistanceMatrixService, costituita da una sequenza di DistanceMatrixResponseElement, 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, che contiene la durata e la distanza da un'origine a una destinazione.
distance
Tipo:  Distance
La distanza per questa coppia origine-destinazione. Questa proprietà potrebbe non essere definita perché la distanza potrebbe essere sconosciuta.
duration
Tipo:  Duration
La durata di questa coppia origine-destinazione. Questa proprietà potrebbe non essere definita perché la durata potrebbe essere sconosciuta.
duration_in_traffic
Tipo:  Duration
La durata di questa coppia origine-destinazione, tenendo conto delle condizioni del traffico indicate dalla proprietà trafficModel. Questa proprietà potrebbe essere undefined in quanto 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 origine-destinazione. Valido solo per le richieste di trasporto pubblico.
status
Lo stato di questa particolare coppia 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 di matrice delle distanze. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'OK' o google.maps.DistanceMatrixStatus.OK

Accesso chiamando il numero const {DistanceMatrixStatus} = await google.maps.importLibrary("routes").
Consulta 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 Una richiesta Distance Matrix non può essere elaborata a causa di un errore del server. Se riprovi, la richiesta potrebbe andare a buon fine.

Costanti DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus costanti

Lo stato a livello di elemento di un particolare accoppiamento origine-destinazione restituito da DistanceMatrixService al termine di una richiesta di matrice delle distanze. Questi valori sono specificati come stringhe, ad esempio 'OK'.

Accesso chiamando il numero const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes").
Consulta Librerie nell'API Maps JavaScript.
NOT_FOUND L'origine e/o la destinazione di questo accoppiamento non è stato possibile geocodificarle.
OK La risposta contiene un risultato valido.
ZERO_RESULTS Non è stato possibile trovare un percorso tra l'origine e la destinazione.