ब्लॉग

Como Usar a API de Dados do Waze

Sua equipe precisa de dados de navegação ao vivo em produção esta semana—congestionamentos, incidentes e opções de rota em que você pode confiar. Ao final deste guia, você será capaz de autenticar, chamar os endpoints de navegação da API de Dados do Waze a partir do Zyla API Hub e analisar os campos que você realmente precisa para enviar um mapa, ETA ou recurso de roteamento.

O que você pode construir com a API de Dados do Waze

A API de Dados do Waze fornece alertas e congestionamentos em tempo real em uma área geográfica e direções de condução entre duas coordenadas, incluindo alertas ao longo de cada rota. Isso é útil para:

Ilustração: Como Usar a API de Dados do Waze

Sobreposições de tráfego no aplicativo (acidentes, fechamentos de estradas, perigos, polícia, congestionamentos).
Recursos de Roteamento/ETA que exibem alertas ao longo do caminho.
Dashboards de despacho e logística que monitoram um retângulo ao vivo ao redor de uma cidade ou corredor.

A API está disponível no Zyla API Hub, um marketplace com mais de 10.000 APIs públicas por trás de um modelo de assinatura e uma chave.

Começando no Zyla API Hub

Abra a página da API de Dados do Waze e inscreva-se para obter sua chave. A primeira API no Zyla inclui um teste de 7 dias ou 50 solicitações; a cobrança é por assinatura + cota (não por chamada). Não há Plano Gratuito. Verifique a página da API para opções de acesso e preços atuais.

Vá para: Iniciar teste de 7 dias na API de Dados do Waze
Clique em Inscrever-se ou Iniciar Teste Gratuito (quando disponível).
Copie sua chave da API.

Todas as solicitações usam o cabeçalho Authorization: Bearer YOUR_API_KEY. O host base é fornecido pelo Zyla; use as URLs exatas do Hub mostradas abaixo.

Endpoints que você usará para Navegação

1) Alertas e Congestionamentos

Método: GET

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

Descrição: Obtenha alertas e congestionamentos em tempo real dentro de um retângulo delimitador (latitude,longitude inferior-esquerdo e superior-direito).

Parâmetros:

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

2) Direções de Condução

Método: GET

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

Descrição: Obtenha rotas/direções de condução entre duas coordenadas. A resposta inclui metadados da rota e alertas encontrados ao longo das rotas possíveis. Suporta a definição do horário de chegada desejado.

Parâmetros:

source_coordinates (string, obrigatório): 32.0852999,34.78176759999999
destination_coordinates (string, obrigatório): 32.7940463,34.989571

Faça sua primeira chamada: Alertas e Congestionamentos

Copie e cole o curl oficial abaixo. Substitua YOUR_API_KEY pela sua chave. Mantenha a URL e os parâmetros exatamente como mostrado.

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"

Resposta de exemplo 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": "Fechado até 31 de jul para obras na estrada. Ref #151583431",
"image": null,
"publish_…

Campos principais que você normalmente usará:

data.alerts[].type e .subtype: categoria e subtipo (por exemplo, HAZARD_ON_ROAD_CONSTRUCTION, ROAD_CLOSED).
latitude, longitude: ponto a ser colocado em seu mapa.
publish_datetime_utc: timestamp UTC para verificações de recência e decisões de TTL.
city, street, country: rótulos opcionais para UI.
num_thumbs_up: sinal rápido de popularidade/validação.

Exemplo em Python: buscar e exibir perigos em um retângulo

Este exemplo chama o mesmo endpoint de Alertas e Congestionamentos, filtra por ROAD_CLOSED e HAZARD, e imprime uma linha compacta que você pode registrar ou enviar para uma sobreposição 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 é obrigatório.
As coordenadas são graus decimais. O retângulo é definido por pares inferior-esquerdo e superior-direito.
Os timestamps retornados em publish_datetime_utc são UTC. Armazene e compare em UTC para evitar desvios de TZ.

Direções de condução com alertas ao longo da rota

Use este endpoint para obter rotas candidatas e os alertas nelas. Você pode escolher a mais rápida, sinalizar pedágios e destacar congestionamentos ao longo do caminho em sua UI. Os parâmetros são source_coordinates e destination_coordinates, ambos como strings de latitude,longitude.

Método: GET

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

Parâmetros:

source_coordinates (string, obrigatório): 32.0852999,34.78176759999999
destination_coordinates (string, obrigatório): 32.7940463,34.989571

Campos de exemplo que você pode consumir da resposta incluem:

route_name: rótulo para a rota.
length_meters: comprimento da rota em metros.
duration_seconds: duração da rota em segundos.
is_toll, is_hov, is_fastest: flags para seleção de UI e heurísticas.
alerts[]: alertas por rota com tipo, subtipo, latitude, longitude.

Para uma chamada ao vivo e resposta de exemplo, veja o endpoint na página da API. Use o mesmo cabeçalho de Autorização mencionado acima.

Casos de uso de navegação no mundo real

Sobreposições de mapa: consulte o retângulo de Alertas e Congestionamentos ao redor de sua área de serviço a cada N segundos, dedupe por alert_id, expire por publish_datetime_utc.
ETAs com contexto: obtenha Direções de Condução, escolha a rota mais rápida (is_fastest) e exiba os 3 principais alertas por proximidade ao motorista.
Notificações geofenced: quando um motorista entra em uma caixa delimitadora, acione uma busca e notifique se houver algum ROAD_CLOSED à frente.
Dashboards de operações: defina max_jams=0 se você quiser apenas marcadores de incidentes para reduzir o tamanho da carga útil.

Notas de implementação que economizam tempo

Unidades: length_meters é em metros; duration_seconds é em segundos; timestamps são UTC.
Caixas delimitadoras: retângulos grandes retornam mais alertas; ajuste max_alerts para manter as cargas úteis pequenas para dispositivos móveis.
Cache: cache de curto prazo (30–60s) geralmente é suficiente para um mapa fluido sem esgotar sua cota.
Tratamento de erros: verifique status e request_id para diagnósticos; registre ambos para rastreamento.
Cotas: o uso é por assinatura + cota. A primeira API no Zyla inclui um teste de 7 dias ou 50 solicitações—monitore o consumo em seu painel do Zyla. Para termos atuais, veja a página da API.

Chame a API de Dados do Waze a partir de um agente de IA via MCP

Você pode conectar esta API a ferramentas e agentes de desenvolvedor compatíveis com MCP. Aponte seu cliente para o endpoint MCP e passe sua chave Zyla conforme descrito na documentação desses clientes. Consulte os fundamentos do MCP aqui:

MCP

Na definição da ferramenta MCP do seu agente, chame as mesmas URLs do Hub mostradas acima e inclua o cabeçalho Authorization: Bearer YOUR_API_KEY. Mantenha os nomes dos parâmetros de consulta idênticos às especificações do endpoint.

Lista de verificação de produção

Política de nova tentativa: 5xx transitórios com retrocesso aleatório; evite tempestades de nova tentativa em retângulos grandes.
Idempotência: use alert_id para deduplicar eventos. Armazene timestamps vistos por último por retângulo.
Privacidade: não registre PII; a API retorna metadados de incidentes adequados para uso operacional.
Observabilidade: anexe request_id aos logs e dashboards para rastreabilidade por chamada.
Implantação: valide as durações das rotas em relação aos seus ETAs históricos antes de substituir seu estimador principal.

Onde explorar e se inscrever

Navegue pelo catálogo no Zyla API Hub para descobrir mais integrações de navegação e mapeamento por trás de uma chave. Quando você estiver pronto para enviar com a API de Dados do Waze especificamente, inicie seu teste abaixo e conecte os endpoints ao seu serviço:

Iniciar teste de 7 dias na API de Dados do Waze

FAQ

Que autenticação a API de Dados do Waze usa no Zyla?
Envie Authorization: Bearer YOUR_API_KEY em cada solicitação para as URLs do Hub mostradas acima.

Como limito o tamanho da carga útil para sobreposições de mapa?
Use max_alerts e max_jams em Alertas e Congestionamentos. Para mapas apenas de incidentes, defina max_jams=0.

Quais são os formatos de coordenadas?
Todas as coordenadas são graus decimais, passadas como strings como "lat,lon". Retângulos delimitadores usam pares bottom_left e top_right.

Quais unidades são usadas nas direções de condução?
length_meters está em metros e duration_seconds está em segundos.

Há um plano gratuito?
Não há Plano Gratuito. A primeira API no Zyla inclui um teste de 7 dias ou 50 solicitações; veja a página da API para opções de acesso e preços atuais.