API pública de eventos de tráfego

Visão geral

A API pública permite consumir os eventos de tráfego aprovados do PLI Reporta em formato GeoJSON — buraco, acidente, alagamento, bloqueio, lentidão, etc. Não inclui manifestações cidadãs nem reportes em análise interna.

Base URL: —

Não foi possível carregar o manifesto ao vivo. Verifique se o backend está em execução e reinicie com a tarefa Start App do VS Code.

Endpoint principal

Use este endereço para obter todas as categorias em um único GeoJSON:

GET /api/public/eventos-trafego.geojson

Resposta: FeatureCollection com geometria Point (WGS84) e propriedades descritas abaixo. Cache HTTP de 60 segundos.

Abrir GeoJSON no navegador →

Camadas por categoria

Uma URL GeoJSON por tipo de evento:

GET /api/public/eventos-trafego/{category_id}.geojson

Simbologia oficial (eventos de tráfego)

A API expõe uma única simbologia, idêntica à página Funcionalidades do sistema na gestão: losango com borda fixa #003b5a e ícone interno da categoria tingido pela cor do status. Ao clicar no símbolo, siga a especificação do popup das camadas.

• GET /api/public/ e GET /api/public/catalog — bloco simbologia
• Cada feature GeoJSON inclui marker_shape, marker_border_color, symbol_color, icon_url
• Ícones em /static/img/icons/{category_id}.png ou .svg
• simbologia.legenda_status — relação cor/status da legenda

Relação cor / status (legenda)

A cor do ícone interno do losango segue o status de cada feature (symbol_color). A API pública expõe apenas status com export_publico — demais entradas servem de referência para integradores.

Ícones por categoria

Popup ao clicar no símbolo

Integradores que reproduzem o mapa público devem exibir um popup informativo ao clicar em cada ponto — sem ações de moderação, sem botão “Já foi resolvido?” e sem scores internos. A referência visual está em /mapa (implementação oficial do PLI Reporta).

Estrutura (de cima para baixo)

1. Cabeçalho colorido — título + botão fechar (×) à direita, fixo no cabeçalho.
2. Faixa de situação — texto orientado ao cidadão conforme status.
3. Informações de Cadastro — campos do registro (subset público).
4. Informações Rodoviários — malha DER / contexto viário (sempre listada em eventos de tráfego; vazios como —).
5. Foto — se photo_url estiver preenchido.
6. Rodapé — data/hora da consulta (Consultado em …).

Cabeçalho

Título

{tipo da camada} do tipo {rótulo da categoria} — ex.: Evento de tráfego do tipo Buraco. Use category_label da feature e o rótulo fixo Evento de tráfego (esta API não expõe manifestações).

Tipografia

Caixa alta, cor branca, centralizado, uma linha (reticências se necessário).

Fundo

Cor do ícone interno do losango: propriedade symbol_color da feature (mesma regra da simbologia / legenda de status).

Fechar

Botão × no canto superior direito dentro do cabeçalho, sobre o fundo colorido.

Faixa de situação (status)

Informações de Cadastro

Campos exibidos nesta ordem. Omitir linhas cujo valor seja vazio (exceto na seção rodoviária). Rótulo alinhado à esquerda; valor à direita; blocos com a mesma largura da foto.

Informações Rodoviários

Sempre exibir a seção em eventos de tráfego. Campos vazios aparecem como —. Não exibir Distância snap utilizada no mapa público. Quando road_scope ou o contexto indicarem via municipal, usar o rótulo Provavelmente municipal em Classificação viária (inferência, não confirmação).

Campos da API que não entram no popup público

• id, cluster_id, scores veracity, relevance, priority
• Flags internas: visivel_mapa_*, export_*, capture_nonce_valid
• photo_url como texto (apenas a imagem é exibida)
• trechos afetados / affected_edges, URL da foto como campo de lista
• Propriedades de simbologia (marker_*, icon_*, symbol_color) — usadas no marcador e no cabeçalho, não como linhas de cadastro

Parâmetros de consulta

Disponíveis em todos os endpoints *.geojson:

bbox

minLon,minLat,maxLon,maxLat — limita à caixa delimitadora (WGS84).

since

Data ISO 8601 — apenas eventos capturados a partir deste instante.

min_priority

Número 0.0–1.0 — filtra por prioridade mínima (padrão 0).

—

Como utilizar

cURL

—

JavaScript (fetch)

—

QGIS

1. Camada → Adicionar camada → Adicionar camada vetorial…
2. Protocolo: HTTP(S)/Cloud
3. URL: cole o endpoint eventos-trafego.geojson (ou uma categoria específica)
4. OK — o GeoJSON será carregado como camada de pontos

Manifesto da API (JSON)

GET /api/public/ retorna a lista completa de endpoints, camadas e regras em JSON — útil para descoberta automática por integradores.

GET /api/public/

Campos das features

Cada feature inclui, entre outros:

• id, category, category_label, status
• marker_shape, marker_border_color, symbol_color, status_label
• icon_format, icon_path, icon_url
• description, magnitude, priority
• veracity, relevance, blocking
• valid_from, valid_to, captured_at
• road_scope, road_label, road_context
• photo_url — link público da foto do reporte

Registros com valid_to expirado não aparecem, mesmo que o status seja publicado.