Migra a la clase Route Matrix

La clase RouteMatrix reemplaza al servicio Distance Matrix, API de Maps JavaScript (legacy). En esta página, se explican las diferencias entre el servicio Distance Matrix heredado y la nueva biblioteca de JavaScript, y se proporciona código para compararlos.

Comparación entre la API de Distance Matrix (heredada) y la clase Route Matrix (beta)

En la siguiente tabla, se comparan los parámetros de solicitud de la API de Distance Matrix heredada y la clase RouteMatrix.

Servicio Distance Matrix (heredado) RouteMatrix (beta)

Parámetros obligatorios
origins origins
destinations destinations

Parámetros opcionales
travelMode travelMode
transitOptions transitPreference
arrivalTime arrivalTime
drivingOptions departureTime, trafficModel
unitSystem units
avoidHighways, avoidTolls RouteModifiers

Comparación de código

En esta sección, se comparan dos fragmentos de código similares para ilustrar las diferencias entre la API de Distance Matrix heredada y la nueva clase RouteMatrix. Los fragmentos de código muestran el código requerido en cada API respectiva para realizar una solicitud de direcciones y ver los resultados.

API de Directions (heredada)

El siguiente código realiza una solicitud de matriz de distancias con la API de Distance Matrix heredada. 

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

Clase Route Matrix (beta)

El siguiente código realiza una solicitud de matriz de distancias con la nueva clase 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,));