Casos de Uso para a API de Dados do Waze

Você precisa de dados de navegação ao vivo em que possa confiar: incidentes, bloqueios de estrada, engarrafamentos e rotas práticas com ETAs. Ao final deste guia, você consultará os alertas e engarrafamentos do Waze para uma caixa delimitadora, recuperará direções de condução entre duas coordenadas e enviará esses resultados para seu aplicativo usando a API de Dados do Waze no Zyla API Hub.

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

A API de Dados do Waze expõe duas capacidades principais de navegação:

• Alertas e engarrafamentos em tempo real dentro de um retângulo geográfico (acidentes, bloqueios de estrada, perigos, engarrafamentos, polícia e mais).
• Direções de condução entre duas coordenadas, incluindo alertas ao longo de cada rota e indicadores como “é_o_mais_rápido” e indicadores de pedágio/HOV.

As equipes usam isso para alimentar aplicativos de motorista, painéis de despacho, ferramentas de operações e sobreposições de segurança. Você obtém uma única conta, uma chave de API e um modelo de assinatura + cota via Zyla API Hub, que hospeda mais de 10.000 APIs públicas. A listagem da API de Dados do Waze oferece um teste de 7 dias ou 50 solicitações para novos usuários do Zyla; verifique a página da API para opções de acesso e preços atuais.

Começando no Zyla API Hub

1. Abra a página da API de Dados do Waze e inicie seu teste: Iniciar teste de 7 dias na API de Dados do Waze.
2. Clique em Assinar ou Iniciar Teste Gratuito (quando disponível) para obter sua chave de API.
3. Envie solicitações com o cabeçalho Authorization: Bearer YOUR_API_KEY para os URLs exatos do Hub abaixo.

Se você estiver explorando outras categorias mais tarde, pode reutilizar a mesma chave em APIs no seu plano no Zyla API Hub.

Endpoint: Alertas e Engarrafamentos

Obtenha alertas e engarrafamentos em tempo real dentro de uma caixa delimitadora, especificada por pares de latitude,longitude do canto inferior esquerdo e do canto superior direito. Útil para sobreposições de mapa, avisos para motoristas ou notificações geofenced.

• Método: GET
• URL: https://zylalabs.com/api/4814/waze-data-api/6003/alerts-and-jams
• Parâmetros obrigatórios:
  • bottom_left (string): 51.2800,-0.5100
  • top_right (string): 51.5000,-0.0800
• Parâmetros opcionais:
  • max_alerts (string)
  • max_jams (string)

cURL

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"

Exemplo de resposta 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. Ref #151583431",
"image": null,
"publish_…

Campos-chave que você realmente usará:

• data.alerts[].type e subtype: categorização de perigo/engarrafamento/bloqueio para tags de UI e filtragem.
• latitude e longitude: plotar no mapa ou calcular proximidade a rotas/paradas.
• publish_datetime_utc: timestamps são UTC ISO-8601; armazene como UTC e converta no cliente apenas para exibição.
• cidade, rua, descrição: preencher texto de notificação ou painéis de operadores.
• num_thumbs_up: proxy simples de confiança para triagem.

Exemplo em Python: filtrar perigos de construção e bloqueios de estrada

import requests

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 []
construction_or_closed = []
for a in alerts:
a_type = a.get("type")
a_sub = a.get("subtype")
if a_type == "ROAD_CLOSED" or a_sub == "HAZARD_ON_ROAD_CONSTRUCTION":
construction_or_closed.append({
"id": a.get("alert_id"),
"type": a_type,
"subtype": a_sub,
"when_utc": a.get("publish_datetime_utc"),
"lat": a.get("latitude"),
"lon": a.get("longitude"),
"street": a.get("street"),
"city": a.get("city"),
"desc": a.get("description"),
})

print(f"Total de alertas: {len(alerts)} (construção/bloqueado: {len(construction_or_closed)})")
for row in construction_or_closed[:5]:
print(row)

Notas:

• As coordenadas são passadas como strings separadas por vírgula. A vírgula codificada na URL no exemplo cURL é tratada automaticamente pela biblioteca requests.
• Unidades: coordenadas em graus; timestamps em UTC; nenhuma paginação é documentada para este endpoint—use a caixa delimitadora e max_alerts/max_jams opcionais para controle de volume.
• Invalidação de cache: esses alertas são em tempo real por natureza; se você armazenar em uma camada de servidor, mantenha os TTLs curtos para categorias de segurança críticas.

Endpoint: Direções de Condução

Recupere opções de rota entre duas coordenadas e os alertas em cada rota. Isso é ideal para mostrar alternativas, calcular ETAs e fornecer prévias de perigos antes da viagem. A API suporta definir o horário de chegada desejado, mas os parâmetros para isso não estão detalhados aqui—consulte a página da API para as opções mais recentes.

• Método: GET
• URL: https://zylalabs.com/api/4814/waze-data-api/6004/driving-directions
• Parâmetros obrigatórios:
  • source_coordinates (string): 32.0852999,34.78176759999999
  • destination_coordinates (string): 32.7940463,34.989571

cURL

O que esperar na resposta

A resposta inclui uma ou mais rotas com atributos como:

• route_name: rótulo adequado para UI.
• length_meters e duration_seconds: use para exibições de distância/ETA e ordenação.
• is_fastest, is_toll, is_hov: lógica de seleção de rota.
• alerts: array de marcadores de alerta ao longo da rota (tipo, subtipo, coordenadas).

Campos de exemplo aparecem como:

Dicas práticas:

• duration_seconds está em segundos; converta para minutos para exibição ao usuário e mantenha os segundos brutos para cálculos de ETA.
• length_meters está em metros; para milhas ou quilômetros, converta no lado do cliente para evitar problemas de arredondamento.
• Se você precisar da geometria da rota, verifique se há um campo como route_coordinates; no exemplo acima, ele está presente, mas vazio—consulte a página da API para o comportamento e as flags atuais.

Casos de uso de navegação de alto sinal que você pode implementar esta semana

• Alertas de motorista geofenced: consulte Alertas e Engarrafamentos para sua área de serviço a cada N segundos/minutos e envie notificações para tipos ROAD_CLOSED ou HAZARD_ON_ROAD_CONSTRUCTION dentro de X metros de viagens ativas.
• Sobreposições de painel de despacho: desenhe todos os marcadores data.alerts dentro de uma caixa delimitadora regional; colorir por tipo (por exemplo, vermelho para ROAD_CLOSED, âmbar para HAZARD).
• Verificação de rota antes da atribuição: chame Direções de Condução para candidatos de coleta/descarte; rejeite rotas não mais rápidas com is_toll=true, a menos que o trabalho permita pedágios.
• Mensagens de clientes cientes do ETA: use duration_seconds para definir expectativas e mostre as duas melhores alternativas quando is_fastest for marginal.
• Monitoramento de operações: rastreie picos em perigos de construção via num_thumbs_up e filtragem de subtipo para priorizar comunicações com equipes de campo.

Detalhes de implementação que economizam tempo

• Ordem das coordenadas: todos os parâmetros mostrados usam latitude,longitude nessa ordem, como strings separadas por vírgula.
• Caixas delimitadoras: use um pequeno retângulo ao redor de um motorista para polling no dispositivo, ou caixas maiores por região para agregação no lado do servidor.
• Timestamps: publish_datetime_utc é UTC; armazene como UTC em todo o seu backend e localize no cliente apenas ao renderizar.
• Tratamento de erros: verifique status e request_id para observabilidade; registre request_id para correlacionar com seu monitoramento.
• Throughput: o marketplace usa um modelo de assinatura + cota, não pagamento por chamada. Para novos usuários do Zyla, a primeira API oferece um teste de 7 dias ou 50 solicitações. Sem Plano Gratuito. Para cotas e limites atuais, consulte a página da API.

Chame a API de agentes de IA via MCP

Se você usar clientes compatíveis com MCP (Claude Code, Cursor, Windsurf, etc.), aponte-os para o endpoint MCP do Zyla e forneça sua chave na URL:

MCP

Uma vez configurado, seu agente pode chamar os mesmos URLs do Waze Data API Hub com o cabeçalho Authorization: Bearer YOUR_API_KEY. Isso é útil para gerar automaticamente código de integração, elaborar funções de fetch ou executar chamadas de teste rápidas durante o desenvolvimento.

Fluxo de exemplo de ponta a ponta

1. Na criação da viagem, chame Direções de Condução com source_coordinates e destination_coordinates. Selecione a rota onde is_fastest é verdadeiro; armazene duration_seconds para ETA.
2. Durante a viagem, consulte Alertas e Engarrafamentos para uma pequena caixa delimitadora ao redor do motorista. Se você receber type=ROAD_CLOSED a 300 metros à frente, re-solicite Direções de Condução e proponha uma nova rota.
3. No seu painel, visualize alertas atuais para todas as regiões ativas usando o mesmo endpoint de Alertas e Engarrafamentos, filtrados por subtipo e publish_datetime_utc dentro do seu limite de recência.

Lista de verificação de solução de problemas

• Respostas 401/403: verifique Authorization: Bearer YOUR_API_KEY e se sua assinatura está ativa.
• Array de alertas vazio: confirme se sua caixa delimitadora realmente intersecta redes rodoviárias e se max_alerts/max_jams não são excessivamente restritivos.
• Mapas lentos do lado do cliente: reduza a densidade de símbolos filtrando para um subconjunto de tipos ou agrupe marcadores em níveis de zoom mais altos.
• ETA parece desatualizado: re-consulte Direções de Condução quando Alertas e Engarrafamentos apresentarem um JAM ou ROAD_CLOSED próximo ao seu caminho.

FAQ

Com que frequência devo consultar Alertas e Engarrafamentos?
Depende do seu caso de uso e cota. Para sobreposições críticas de segurança, mantenha os intervalos curtos, mas equilibrados com seus limites; para painéis, intervalos mais longos podem ser suficientes. Comece pequeno, meça o volume e depois ajuste.

Quais unidades length_meters e duration_seconds usam?
Metros e segundos, respectivamente. Converta no cliente para milhas/quilômetros e minutos conforme necessário.

Posso solicitar rotas para um horário de chegada desejado?
O endpoint Direções de Condução suporta a definição de um horário de chegada desejado, mas os parâmetros não estão detalhados aqui. Consulte a página da API para opções atuais.

Como faço para filtrar apenas construções ou bloqueios?
Verifique data.alerts[].type e subtype, por exemplo, type=ROAD_CLOSED ou subtype=HAZARD_ON_ROAD_CONSTRUCTION.

Isso é pagamento por chamada?
Não. A Zyla usa um modelo de assinatura + cota. Para novos usuários do Zyla, a primeira API oferece um teste de 7 dias ou 50 solicitações. Consulte a listagem para detalhes atuais.

Pronto para adicionar dados de navegação ao vivo do Waze ao seu produto? Crie sua conta, obtenha sua chave e comece a construir com a API de Dados do Waze: Iniciar teste de 7 dias na API de Dados do Waze.