Migra a la clase Route Matrix

Desarrolladores del Espacio Económico Europeo (EEE)

Si tu dirección de facturación se encuentra en el Espacio Económico Europeo, a partir del 8 de julio de 2025, se aplicarán las Condiciones del Servicio de Google Maps Platform para el EEE al uso que hagas de los Servicios. La funcionalidad varía según la región. Obtén más información.

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

API de Distance Matrix (heredada) frente a la clase Route Matrix

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, API de Maps JavaScript (heredada)	RouteMatrix	Obligatorio u opcional
origins	origins	Obligatorio
destinations	destinations	Obligatorio
travelMode	travelMode	Opcional
transitOptions	transitPreference	Opcional
arrivalTime	arrivalTime	Opcional
drivingOptions	departureTime, trafficModel	Opcional
unitSystem	units	Opcional
avoidHighways, avoidTolls	RouteModifiers	Opcional

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. En los fragmentos de código, se muestra el código necesario en cada API respectiva para realizar una solicitud de instrucciones sobre cómo llegar y ver los resultados.

API de Distance Matrix (heredada)

En el siguiente código, se realiza una solicitud de matriz de distancia 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

En el siguiente código, se realiza una solicitud de matriz de distancia 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,));