La API de Directions (heredada) es un servicio web que calcula instrucciones sobre cómo llegar entre ubicaciones en auto, a pie, en bicicleta y en transporte público, incluidas las rutas de varias partes con puntos de referencia, y devuelve rutas, tramos y pasos en formato JSON o XML. Está en estado heredado: a partir de octubre de 2026, no se podrá habilitar para proyectos nuevos de Google Cloud. Migra a la API de Routes.
API de Directions: Datos clave
- Producto: API de Directions
- También conocida como: API de Directions (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 Directions
- Disponibilidad regional: Global. La cobertura varía según la región y el medio de transporte (el transporte público depende de los datos de los proveedores de transporte público). (detalles de la cobertura)
API de Directions: Cuándo usarla
Usa la API de Directions en los siguientes casos:
- Mantienes un proyecto de Google Cloud existente que ya tiene habilitada la API de Directions (heredada) y llama a
maps/api/directions. - Necesitas instrucciones sobre cómo llegar en automóvil, a pie, en bicicleta o en transporte público (puntos de referencia solo para medios de transporte que no sean públicos) del servidor, en formato JSON o XML, en un proyecto existente.
No uses la API de Directions en los siguientes casos:
- Estás iniciando un nuevo proyecto de Google Cloud. A partir de octubre de 2026, no se podrá habilitar la API de Directions (heredada) para proyectos nuevos. En su lugar, usa la API de Routes.
- Necesitas nuevas funciones de enrutamiento y un mejor rendimiento. En su lugar, usa la API de Routes.
- Necesitas la duración del viaje y las distancias para muchos orígenes y destinos en una sola solicitud. En su lugar, usa la API de Routes.
API de Directions: Configuración
- Servicio que se habilitará:
directions-backend.googleapis.com - Autenticación: Clave de API
- Comienza a usar la API de Directions: Configura la API de Directions
- Referencia: Referencia de la API de Directions
- Precios: Uso y facturación de la API de Directions
- Políticas: Políticas de la API de Directions
- Notas de la versión: Notas de la versión de la API de Directions
API de Directions: Errores comunes
- Problema: Las solicitudes a la API de Directions (heredada) desde un proyecto en el que no está habilitada la API heredada fallan con
LegacyApiNotActivatedMapError. Solución: Si eres el propietario de la app, migra a la API de Routes. Como solución a corto plazo mientras migras o esperas una actualización de la app, puedes activar la API heredada completando el formulario de activación de la API heredada. Consulta /maps/legacy. - Problema: El uso del prefijo
via:en los puntos de referencia los convierte en puntos de paso estrictos, lo que puede causar desvíos graves o un estadoZERO_RESULTS. Solución: Usa puntos de referencia de parada (sin el prefijovia:), a menos que se requiera un punto de paso estricto. Consulta /maps/documentation/directions/get-directions. - Problema: Las solicitudes con entre 11 y 25 puntos de referencia,
optimize:true, duraciones que tienen en cuenta el tráfico (duration_in_traffic) o los modificadores de ubicaciónside_of_roadoheadingse facturan con el SKU Directions Advanced (Pro), que es más costoso. Solución: Usa estas funciones solo cuando las necesites. Mantén los puntos de referencia en 10 o menos, y omiteoptimize:true,departure_time(para conducir),side_of_roadyheadingpara permanecer en el SKU Essentials. Consulta /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku. - Problema: Para conducir,
departure_timeno puede ser en el pasado (la solicitud falla conINVALID_REQUEST). Sindeparture_time, la ruta y la duración usan el tráfico promedio independiente del tiempo, y no se devuelveduration_in_traffic. Solución: Establecedeparture_timeennowo en una hora futura conmode=drivingpara obtenerduration_in_traffic. Las solicitudes que devuelvenduration_in_trafficse facturan con el SKU de Directions Advanced (Pro). Consulta /maps/documentation/directions/get-directions.