Esegui la migrazione alla classe Route Matrix

Sviluppatori dello Spazio economico europeo (SEE)

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

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

Servizio Distance Matrix (legacy) RouteMatrix

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 precedente. 

// 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

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,));