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 alcuni esempi di codice per il confronto.

API Distance Matrix (legacy) e classe Route Matrix

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

Servizio Distance Matrix, API Maps JavaScript (legacy) RouteMatrix Obbligatorio o facoltativo
origins origins Obbligatorio
destinations destinations Obbligatorio
travelMode travelMode Facoltativo
transitOptions transitPreference Facoltativo
arrivalTime arrivalTime Facoltativo
drivingOptions departureTime, trafficModel Facoltativo
unitSystem units Facoltativo
avoidHighways, avoidTolls RouteModifiers Facoltativo

Confronto del codice

Questa sezione mette a confronto due porzioni di codice simili per illustrare le differenze tra l'API Distance Matrix (Legacy) e la nuova classe RouteMatrix. Gli snippet di codice mostrano il codice richiesto su ogni rispettiva API per effettuare una richiesta di indicazioni stradali e visualizzare i risultati.

API Distance Matrix (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

Il seguente codice effettua una richiesta di Distance Matrix 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,));