Migrer vers la classe Route Matrix

Développeurs de l'Espace économique européen (EEE)

La classe RouteMatrix remplace le service Matrice des distances de l'API Maps JavaScript (ancien). Cette page explique les différences entre l'ancien service Matrice des distances et la nouvelle bibliothèque JavaScript, et fournit du code à des fins de comparaison.

API Distance Matrix (ancienne) et classe Route Matrix

Le tableau suivant compare les paramètres de requête de l'ancienne API Distance Matrix (ancienne) et de la classe RouteMatrix.

Service Matrice des distances, API Maps JavaScript (ancienne version) RouteMatrix Obligatoire ou facultatif
origins origins Obligatoire
destinations destinations Obligatoire
travelMode travelMode Facultatif
transitOptions transitPreference Facultatif
arrivalTime arrivalTime Facultatif
drivingOptions departureTime, trafficModel Facultatif
unitSystem units Facultatif
avoidHighways, avoidTolls RouteModifiers Facultatif

Comparaison de code

Cette section compare deux extraits de code similaires pour illustrer les différences entre l'API Distance Matrix (ancienne) et la nouvelle classe RouteMatrix. Les extraits de code montrent le code requis sur chaque API respective pour envoyer une requête d'itinéraire et afficher les résultats.

API Distance Matrix (ancienne)

Le code suivant effectue une requête de matrice des distances à l'aide de l'API Distance Matrix (ancienne version). 

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

Le code suivant envoie une requête de matrice des distances à l'aide de la nouvelle 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,));