Esegui la migrazione alla classe Route Matrix

La classe RouteMatrix sostituisce il servizio Distance Matrix, API Maps JavaScript (legacy). Questa pagina spiega le differenze tra il servizio Distance Matrix legacy e la nuova libreria JavaScript e fornisce del codice per il confronto.

API Distance Matrix (legacy) e classe Route Matrix (beta)

La seguente tabella confronta i parametri di richiesta per l'API Distance Matrix precedente e la classe RouteMatrix.

Servizio Distance Matrix (legacy) RouteMatrix (beta)

Parametri obbligatori
origins origins
destinations destinations

Parametri facoltativi
travelMode travelMode
transitOptions transitPreference
arrivalTime arrivalTime
drivingOptions departureTime, trafficModel
unitSystem units
avoidHighways, avoidTolls RouteModifiers

Confronto del codice

Questa sezione confronta due frammenti di codice simili per illustrare le differenze tra l'API Distance Matrix precedente e la nuova classe RouteMatrix. Gli snippet di codice mostrano il codice richiesto su ogni API rispettiva per effettuare una richiesta di indicazioni e visualizzare i risultati.

API Directions (legacy)

Il seguente codice effettua una richiesta di matrice delle distanze utilizzando l'API Distance Matrix legacy. 

// Define the request.
const request = {
  origins: [{lat: 55.93, lng: -3.118}, 'Greenwich, England'],
  destinations: ['Stockholm, Sweden', {lat: 50.087, lng: 14.421}],
  travelMode: 'DRIVING',
  drivingOptions: {
    departureTime: new Date(Date.now()),
    trafficModel: 'optimistic'
  }
};

// Make the request.
service.getDistanceMatrix(request).then((response) => {
  // Display the response.
  document.getElementById("response").textContent = JSON.stringify(
    response,
    null,
    2,
  );
});

Classe Route Matrix (beta)

Il seguente codice effettua una richiesta di matrice delle distanze utilizzando la nuova classe Route Matrix: 

// Define the request.
const request = {
  origins: [{lat: 55.93, lng: -3.118}, 'Greenwich, England'],
  destinations: ['Stockholm, Sweden', {lat: 50.087, lng: 14.421}],
  travelMode: 'DRIVING',
  departureTime: new Date(),
  trafficModel: 'optimistic'
};

// Make the request.
const response = await RouteMatrix.computeRouteMatrix(request);

// Display the response.
document.getElementById("response").setValue(JSON.stringify(response, null, 2,));