Cómo usar la API de datos de Waze

Tu equipo necesita datos de navegación en tiempo real en producción esta semana: atascos, incidentes y opciones de ruta en las que puedes confiar. Al final de esta guía, podrás autenticarte, llamar a los puntos finales de navegación de la API de datos de Waze desde Zyla API Hub y analizar los campos que realmente necesitas para enviar un mapa, ETA o función de enrutamiento.

Lo que puedes construir con la API de datos de Waze

La API de datos de Waze proporciona alertas y atascos en tiempo real en un área geográfica y direcciones de conducción entre dos coordenadas, incluyendo alertas a lo largo de cada ruta. Esto es útil para:

Ilustración: Cómo usar la API de datos de Waze

Superposiciones de tráfico en la aplicación (accidentes, cierres de carreteras, peligros, policía, atascos).
Funciones de enrutamiento/ETA que muestran alertas a lo largo del camino.
Tableros de despacho y logística que observan un rectángulo en vivo alrededor de una ciudad o corredor.

La API se encuentra en Zyla API Hub, un mercado con más de 10,000 APIs públicas detrás de un modelo de suscripción y una clave.

Comenzando en Zyla API Hub

Abre la página de la API de datos de Waze y suscríbete para obtener tu clave. La primera API en Zyla incluye una prueba de 7 días o 50 solicitudes; la facturación es suscripción + cuota (no pago por llamada). No hay Plan Gratuito. Consulta la página de la API para las opciones de acceso y precios actuales.

Ve a: Iniciar prueba de 7 días en la API de datos de Waze
Haz clic en Suscribirse o Iniciar Prueba Gratuita (cuando esté disponible).
Copia tu clave de API.

Todas las solicitudes utilizan el encabezado Authorization: Bearer YOUR_API_KEY. El host base es proporcionado por Zyla; utiliza las URL exactas del Hub que se muestran a continuación.

Puntos finales que usarás para Navegación

1) Alertas y Atascos

Método: GET

URL: https://zylalabs.com/api/4814/waze-data-api/6003/alerts-and-jams

Descripción: Obtén alertas y atascos en tiempo real dentro de un rectángulo delimitador (latitud, longitud de la esquina inferior izquierda y de la esquina superior derecha).

Parámetros:

bottom_left (string, requerido): 51.2800,-0.5100
top_right (string, requerido): 51.5000,-0.0800
max_alerts (string, opcional): 100
max_jams (string, opcional): 0

2) Direcciones de Conducción

Método: GET

URL: https://zylalabs.com/api/4814/waze-data-api/6004/driving-directions

Descripción: Obtén rutas/direcciones de conducción entre dos coordenadas. La respuesta incluye metadatos de la ruta y alertas encontradas a lo largo de las posibles rutas. Soporta establecer la hora de llegada deseada.

Parámetros:

source_coordinates (string, requerido): 32.0852999,34.78176759999999
destination_coordinates (string, requerido): 32.7940463,34.989571

Haz tu primera llamada: Alertas y Atascos

Copia y pega el curl oficial a continuación. Reemplaza YOUR_API_KEY con tu clave. Mantén la URL y los parámetros exactamente como se muestran.

curl -s -X GET "https://zylalabs.com/api/4814/waze-data-api/6003/alerts-and-jams?bottom_left=51.2800%2C-0.5100&top_right=51.5000%2C-0.0800&max_alerts=100&max_jams=0" \
-H "Authorization: Bearer YOUR_API_KEY"

Respuesta de muestra oficial:

{
"status": "OK",
"request_id": "86b7f40f-b386-4aee-af95-274974d93184",
"parameters": {
"bottom_left": [
"51.2800",
"-0.5100"
],
"top_right": [
"51.5000",
"-0.0800"
],
"max_alerts": 100,
"max_jams": 0
},
"data": {
"alerts": [
{
"alert_id": "alert-1851823848/7b5e52cb-9549-4955-a117-ce19dd01fe9b",
"type": "HAZARD",
"subtype": "HAZARD_ON_ROAD_CONSTRUCTION",
"reported_by": "Causeway one.network",
"description": ".",
"image": null,
"publish_datetime_utc": "2026-07-22T08:30:00.000Z",
"country": "GB",
"city": "Mole Valley",
"street": null,
"latitude": 51.281508,
"longitude": -0.369863,
"num_thumbs_up": 7,
"alert_reliability": 0,
"alert_confidence": 0,
"near_by": null,
"provider": "Elgin (Road works)",
"provider_id": "151505923",
"comments": [],
"num_comments": 0
},
{
"alert_id": "alert-1191763163/60f6957d-0668-49d6-b43f-710177584187",
"type": "HAZARD",
"subtype": "HAZARD_ON_ROAD_CONSTRUCTION",
"reported_by": "Causeway one.network",
"description": ".",
"image": null,
"publish_datetime_utc": "2026-05-15T13:00:00.000Z",
"country": "GB",
"city": "Mole Valley",
"street": "Durleston Park Dr",
"latitude": 51.280691,
"longitude": -0.365612,
"num_thumbs_up": 39,
"alert_reliability": 0,
"alert_confidence": 0,
"near_by": null,
"provider": "Elgin (Road works)",
"provider_id": "149944301",
"comments": [],
"num_comments": 0
},
{
"alert_id": "alert-1618880859/60722796-8030-486e-913c-4e683837b754",
"type": "ROAD_CLOSED",
"subtype": null,
"reported_by": "ClosureMonitor",
"description": "Cerrado hasta el 31 de julio por obras en la carretera. Ref #151583431",
"image": null,
"publish_…

Campos clave que típicamente usarás:

data.alerts[].type y .subtype: categoría y subtipo (por ejemplo, HAZARD_ON_ROAD_CONSTRUCTION, ROAD_CLOSED).
latitude, longitude: punto a colocar en tu mapa.
publish_datetime_utc: marca de tiempo UTC para verificaciones de actualidad y decisiones de TTL.
city, street, country: etiquetas opcionales para la interfaz de usuario.
num_thumbs_up: señal rápida de popularidad/validación.

Ejemplo en Python: obtener y mostrar peligros en un rectángulo

Este ejemplo llama al mismo punto final de Alertas y Atascos, filtra por ROAD_CLOSED y HAZARD, y imprime una línea compacta que puedes registrar o enviar a una superposición de mapa.

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/4814/waze-data-api/6003/alerts-and-jams"

params = {
"bottom_left": "51.2800,-0.5100",
"top_right": "51.5000,-0.0800",
"max_alerts": "100",
"max_jams": "0",
}

headers = {
"Authorization": f"Bearer {API_KEY}",
}

resp = requests.get(url, headers=headers, params=params, timeout=20)
resp.raise_for_status()
payload = resp.json()

alerts = (payload.get("data") or {}).get("alerts") or []
for a in alerts:
a_type = a.get("type")
if a_type in ("ROAD_CLOSED", "HAZARD"):
print(
f"{a.get('publish_datetime_utc')} | {a_type} | "
f"{a.get('subtype')} | {a.get('city')} | "
f"{a.get('latitude')},{a.get('longitude')}"
)

Notas:

Authorization: Bearer YOUR_API_KEY es requerido.
Las coordenadas son grados decimales. El rectángulo está definido por pares de esquina inferior izquierda y esquina superior derecha.
Las marcas de tiempo devueltas en publish_datetime_utc son UTC. Almacena y compara en UTC para evitar deslizamientos de TZ.

Direcciones de conducción con alertas a lo largo de la ruta

Usa este punto final para obtener rutas candidatas y las alertas en ellas. Puedes elegir la más rápida, marcar peajes y resaltar atascos a lo largo del camino en tu interfaz de usuario. Los parámetros son source_coordinates y destination_coordinates, ambos como cadenas de latitud, longitud.

Método: GET

URL: https://zylalabs.com/api/4814/waze-data-api/6004/driving-directions

Parámetros:

source_coordinates (string, requerido): 32.0852999,34.78176759999999
destination_coordinates (string, requerido): 32.7940463,34.989571

Ejemplos de campos que puedes consumir de la respuesta incluyen:

route_name: etiqueta para la ruta.
length_meters: longitud de la ruta en metros.
duration_seconds: duración de la ruta en segundos.
is_toll, is_hov, is_fastest: banderas para selección de UI y heurísticas.
alerts[]: alertas por ruta con tipo, subtipo, latitud, longitud.

Para una llamada en vivo y respuesta de ejemplo, consulta el punto final en la página de la API. Usa el mismo encabezado de Authorization mencionado anteriormente.

Casos de uso de navegación en el mundo real

Superposiciones de mapa: consulta el rectángulo de Alertas y Atascos alrededor de tu área de servicio cada N segundos, elimina duplicados por alert_id, expira por publish_datetime_utc.
ETAs con contexto: obtén Direcciones de Conducción, elige la ruta más rápida (is_fastest) y muestra las 3 alertas principales por proximidad al conductor.
Notificaciones geocercadas: cuando un conductor entra en un cuadro delimitador, activa una consulta y notifica si hay algún ROAD_CLOSED adelante.
Tableros de operaciones: establece max_jams=0 si solo deseas marcadores de incidentes para reducir el tamaño de la carga útil.

Notas de implementación que ahorran tiempo

Unidades: length_meters son metros; duration_seconds son segundos; las marcas de tiempo son UTC.
Cajas delimitadoras: rectángulos grandes devuelven más alertas; ajusta max_alerts para mantener las cargas útiles pequeñas para móviles.
Caché: una caché a corto plazo (30–60s) suele ser suficiente para un mapa fluido sin agotar tu cuota.
Manejo de errores: verifica el estado y request_id para diagnósticos; registra ambos para rastreo.
Cuotas: el uso es suscripción + cuota. La primera API en Zyla incluye una prueba de 7 días o 50 solicitudes; monitorea el consumo en tu tablero de Zyla. Para los términos actuales, consulta la página de la API.

Llama a la API de datos de Waze desde un agente de IA a través de MCP

Puedes conectar esta API a herramientas y agentes de desarrollador compatibles con MCP. Dirige tu cliente al punto final de MCP y pasa tu clave de Zyla como se describe en la documentación de esos clientes. Consulta los conceptos básicos de MCP aquí:

MCP

En la definición de herramienta MCP de tu agente, llama a las mismas URL del Hub que se muestran arriba e incluye el encabezado Authorization: Bearer YOUR_API_KEY. Mantén los nombres de los parámetros de consulta idénticos a las especificaciones del punto final.

Lista de verificación de producción

Política de reintentos: 5xx transitorios con retroceso aleatorio; evita tormentas de reintentos en rectángulos grandes.
Idempotencia: usa alert_id para eliminar duplicados de eventos. Almacena marcas de tiempo de última vista por rectángulo.
Privacidad: no registres PII; la API devuelve metadatos de incidentes adecuados para uso operativo.
Observabilidad: adjunta request_id a registros y tableros para trazabilidad por llamada.
Despliegue: valida las duraciones de ruta contra tus ETAs históricos antes de reemplazar tu estimador principal.

Dónde explorar y suscribirse

Navega por el catálogo en Zyla API Hub para descubrir más integraciones de navegación y mapeo detrás de una clave. Cuando estés listo para implementar específicamente la API de datos de Waze, comienza tu prueba a continuación y conecta los puntos finales a tu servicio:

Iniciar prueba de 7 días en la API de datos de Waze

FAQ

¿Qué autenticación utiliza la API de datos de Waze en Zyla?
Envía Authorization: Bearer YOUR_API_KEY en cada solicitud a las URL del Hub mostradas arriba.

¿Cómo limito el tamaño de la carga útil para superposiciones de mapa?
Usa max_alerts y max_jams en Alertas y Atascos. Para mapas solo de incidentes, establece max_jams=0.

¿Cuáles son los formatos de coordenadas?
Todas las coordenadas son grados decimales, pasadas como cadenas como "lat,lon". Los rectángulos delimitadores utilizan pares de bottom_left y top_right.

¿Qué unidades se utilizan en las direcciones de conducción?
length_meters está en metros y duration_seconds está en segundos.

¿Hay un plan gratuito?
No hay Plan Gratuito. La primera API en Zyla incluye una prueba de 7 días o 50 solicitudes; consulta la página de la API para las opciones de acceso y precios actuales.