Referencia rápida de la API de Distance Matrix

La API de Distance Matrix (heredada) es un servicio web que devuelve la distancia y el tiempo de viaje para una matriz de orígenes y destinos, según la ruta recomendada entre cada par. Puedes establecer el medio de transporte (en automóvil, a pie, en bicicleta o en transporte público), los medios de transporte público, las unidades y la hora de salida para las duraciones basadas en el tráfico. Devuelve JSON o XML.

API de Distance Matrix: Datos clave

  • Producto: API de Distance Matrix
  • También conocida como: API de Distance Matrix (heredada), Distance Matrix (heredada)
  • Categoría: Rutas
  • Plataforma: Servicio web (REST)
  • Se ejecuta en: Servidor (código de backend)
  • Etapa de lanzamiento: GA
  • Ciclo de vida: Heredado
  • Reemplazada por: API de Routes
  • Descripción general: Descripción general de la API de Distance Matrix

Cuándo usar la API de Distance Matrix

Usa la API de Distance Matrix en los siguientes casos:

  • Mantienes un proyecto existente que ya tiene habilitada la API de Distance Matrix (heredada) y llama a /maps/api/distancematrix.
  • Necesitas la distancia y el tiempo de viaje entre cada uno de los distintos orígenes y cada uno de los distintos destinos desde un servidor.
  • Necesitas duraciones en el tráfico para conducir, con departure_time y un traffic_model opcional.

No uses la API de Distance Matrix en los siguientes casos:

  • Estás iniciando un proyecto nuevo de Google Cloud. A partir de octubre de 2026, no se podrá habilitar la API de Distance Matrix (heredada) para proyectos nuevos. En su lugar, usa la API de Routes.
  • Necesitas funciones nuevas o una matriz de rutas de hasta 625 elementos con respuestas transmitidas (computeRouteMatrix). En su lugar, usa la API de Routes.
  • Necesitas una ruta completa con pasos y polilíneas entre puntos, no solo valores de distancia y duración. En su lugar, usa la API de Routes.

API de Distance Matrix: Configuración

API de Distance Matrix: Errores comunes

  • Problema: Cada solicitud del servidor está limitada a 100 elementos (orígenes × destinos) y a 25 orígenes o 25 destinos. Las solicitudes más grandes devuelven MAX_ELEMENTS_EXCEEDED o MAX_DIMENSIONS_EXCEEDED. Solución: Divide la matriz en solicitudes de no más de 100 elementos y 25 orígenes o destinos. Consulta /maps/documentation/distance-matrix/usage-and-billing#usage-limits.
  • Problema: Si no especificas departure_time, la ruta y la duración se basan en el tráfico promedio independientemente del tiempo, y no se devuelve ningún duration_in_traffic. Los resultados pueden variar con el tiempo. Solución: Establece departure_time en now o en una hora futura con mode=driving para obtener duraciones que tengan en cuenta el tráfico. Ten en cuenta que las solicitudes de tráfico se facturan con una tarifa más alta. Consulta /maps/documentation/distance-matrix/distance-matrix.
  • Problema: El parámetro units solo cambia el texto de los campos de distancia. El valor de la distancia siempre se expresa en metros. Corrección: Lee distance.value como metros o usa distance.text para la visualización. Consulta /maps/documentation/distance-matrix/distance-matrix.
  • Problema: Si llamas a la API de Distance Matrix (heredada) desde un proyecto en el que no está habilitada, se devuelve REQUEST_DENIED en status y un error_message que vincula a LegacyApiNotActivatedMapError. Los asistentes de IA suelen generar código de API heredado de forma predeterminada. Solución: Migra a la API de Routes computeRouteMatrix (con el encabezado X-Goog-FieldMask). Activa la API heredada por formulario solo como una medida a corto plazo. Consulta /maps/legacy#LegacyApiNotActivatedMapError.