Referencia rápida de la API de Directions

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

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 estado ZERO_RESULTS. Solución: Usa puntos de referencia de parada (sin el prefijo via:), 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ón side_of_road o heading se 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 omite optimize:true, departure_time (para conducir), side_of_road y heading para permanecer en el SKU Essentials. Consulta /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku.
  • Problema: Para conducir, departure_time no puede ser en el pasado (la solicitud falla con INVALID_REQUEST). Sin departure_time, la ruta y la duración usan el tráfico promedio independiente del tiempo, y no se devuelve duration_in_traffic. Solución: Establece departure_time en now o en una hora futura con mode=driving para obtener duration_in_traffic. Las solicitudes que devuelven duration_in_traffic se facturan con el SKU de Directions Advanced (Pro). Consulta /maps/documentation/directions/get-directions.