Migrar para a classe RouteMatrix

A classe RouteMatrix substitui o serviço Distance Matrix da API Maps JavaScript (legado). Esta página explica as diferenças entre o serviço Distance Matrix legado e a nova biblioteca JavaScript, além de fornecer alguns códigos para comparação.

API Distance Matrix (legada) x classe Route Matrix (Beta)

A tabela a seguir compara os parâmetros de solicitação da API Distance Matrix legada e da classe RouteMatrix.

Serviço Distance Matrix (legado)	RouteMatrix (Beta)
Parâmetros obrigatórios
origins	origins
destinations	destinations
Parâmetros opcionais
travelMode	travelMode
transitOptions	transitPreference
arrivalTime	arrivalTime
drivingOptions	departureTime, trafficModel
unitSystem	units
avoidHighways, avoidTolls	RouteModifiers

Comparação de código

Esta seção compara dois trechos de código semelhantes para ilustrar as diferenças entre a API Distance Matrix legada e a nova classe RouteMatrix. Os snippets de código mostram o código necessário em cada API para fazer uma solicitação de rotas e ver os resultados.

API Directions (legada)

O código a seguir faz uma solicitação de matriz de distâncias usando a API Distance Matrix legada.

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

O código a seguir faz uma solicitação de matriz de distância usando a nova classe RouteMatrix:

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