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_timey untraffic_modelopcional.
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
- Servicio que se habilitará:
distance-matrix-backend.googleapis.com - Autenticación: Clave de API
- Comienza a usar la API de Distance Matrix: Configura la API de Distance Matrix
- Referencia: Referencia de la API de Distance Matrix
- Precios: Uso y facturación de la API de Distance Matrix
- Políticas: Políticas de la API de Distance Matrix
- Notas de la versión: Notas de la versión de la API de Distance Matrix
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_EXCEEDEDoMAX_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únduration_in_traffic. Los resultados pueden variar con el tiempo. Solución: Establecedeparture_timeennowo en una hora futura conmode=drivingpara 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
unitssolo cambia el texto de los campos de distancia. El valor de la distancia siempre se expresa en metros. Corrección: Leedistance.valuecomo metros o usadistance.textpara 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_DENIEDenstatusy unerror_messageque vincula aLegacyApiNotActivatedMapError. Los asistentes de IA suelen generar código de API heredado de forma predeterminada. Solución: Migra a la API de RoutescomputeRouteMatrix(con el encabezadoX-Goog-FieldMask). Activa la API heredada por formulario solo como una medida a corto plazo. Consulta /maps/legacy#LegacyApiNotActivatedMapError.