Distance Matrix (deprecated)

Classe DistanceMatrixService

google.maps.DistanceMatrixService libreria di
classi "routes" 

const {DistanceMatrixService} = await google.maps.importLibrary("routes");
DistanceMatrixService
DistanceMatrixService()
Parametri: nessuno
Crea una nuova istanza di un DistanceMatrixService che invia query Distance Matrix ai server Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parametri:
Valore restituito: Promise<DistanceMatrixResponse>
Invia una richiesta di Distance Matrix.

Interfaccia DistanceMatrixRequest

Interfaccia google.maps.DistanceMatrixRequest

Una query Distance Matrix 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
Un array contenente stringhe di indirizzi di origine o oggetti LatLng o Place da cui calcolare la distanza e il tempo. Obbligatorio.
travelMode
Tipo di routing richiesto. Obbligatorio.
avoidFerries
facoltativo
Tipo: boolean optional
Se impostato su true, indica al servizio Distance Matrix di evitare i traghetti, se possibile. Facoltativo.
avoidHighways
facoltativo
Tipo: boolean optional
Se true, indica al servizio Distance Matrix di evitare le autostrade, se possibile. Facoltativo.
avoidTolls
facoltativo
Tipo: boolean optional
Se impostato su true, indica al servizio Distance Matrix di evitare le strade a pedaggio, se possibile. Facoltativo.
drivingOptions
facoltativo
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
facoltativo
Tipo: string optional
Un identificatore della lingua in cui devono essere restituiti i risultati, se possibile. Consulta l'elenco delle lingue supportate.
region
facoltativo
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 è identica ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD 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
facoltativo
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
facoltativo
Tipo: UnitSystem optional
Sistema di unità di misura preferito da utilizzare per la visualizzazione della distanza. Facoltativo; il valore predefinito è metric.

Interfaccia DistanceMatrixResponse

Interfaccia google.maps.DistanceMatrixResponse

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

Interfaccia google.maps.DistanceMatrixResponseRow

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

Interfaccia google.maps.DistanceMatrixResponseElement

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 e destinazione. Questa proprietà potrebbe non essere definita, in quanto la distanza potrebbe essere sconosciuta.
duration
Tipo: Duration
La durata di questo accoppiamento origine-destinazione. Questa proprietà potrebbe non essere definita, in quanto la durata potrebbe essere sconosciuta.
duration_in_traffic
Tipo: Duration
La durata di questa coppia di 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 solo per i clienti con piano Premium quando drivingOptions viene definito al momento della richiesta.
fare
La tariffa totale per questa coppia di origine e destinazione. Applicabile solo alle richieste di trasporto pubblico.
status
Lo stato di questa particolare coppia origine-destinazione.

Costanti DistanceMatrixStatus

google.maps.DistanceMatrixStatus libreria di costanti
"routes"

Lo stato di primo livello della richiesta in generale restituito da DistanceMatrixService al completamento di una richiesta di Distance Matrix. Specifica questi valori in base al valore o utilizzando il nome della costante. Ad esempio, 'OK' o google.maps.DistanceMatrixStatus.OK

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

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes");
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 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 Distance Matrix a causa di un errore del server. La richiesta potrebbe andare a buon fine se riprovi.

Costanti DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus libreria di costanti
"routes"

Lo stato a livello di elemento relativo a una particolare coppia di origine e destinazione restituita da DistanceMatrixService al completamento di una richiesta di Distance Matrix. Questi valori sono specificati come stringhe, ad esempio 'OK'.

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

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes");
NOT_FOUND Non è stato possibile geocodificare l'origine e/o la destinazione di questo accoppiamento.
OK La risposta contiene un risultato valido.
ZERO_RESULTS Non è stato possibile trovare un percorso tra l'origine e la destinazione.