A API do Trânsito Agora Brasil

Começar

Crie uma chave de teste no formulário abaixo e junte ao pedido. Abra isto no navegador, com a sua chave no fim, e já tem dados:

https://transitoagora.com.br/api/feed/interdicoes?cidade=sao-paulo&key=tab_…

Ou, num programa, mande a chave no cabeçalho, que não fica no histórico do navegador nem nos logs de quem estiver no meio:

curl -H "X-API-Key: tab_…" "https://transitoagora.com.br/api/feed/interdicoes?cidade=salvador"

A resposta é GeoJSON (uma FeatureCollection), pronta para jogar num mapa. Até o fim de 13 de outubro de 2026 o feed ainda responde sem chave, com um aviso no cabeçalho X-API-Notice e no campo aviso; a partir de 14 de outubro, só com chave.

A chave

A chave criada aqui é de teste: funciona 5 dias a contar do primeiro pedido, com 120 pedidos por hora, para ver se a API serve ao que está construindo. Depois, escolha um dos planos abaixo.

Pedimos nome, email e para que vai usar por três razões: para avisar quando uma fonte oficial cair ou mudar de formato; para saber o que falta na API a quem a usa de verdade; e porque uma chave que se pode revogar protege todo mundo de um loop descontrolado.

O endpoint

GET /api/feed/interdicoes: uma Feature por via afetada que tem ponto no mapa. Interdições oficiais publicadas pelos órgãos parceiros, e as lidas dos anúncios dos órgãos de trânsito e do noticiário local.

Exemplo de resposta

Uma resposta de verdade de ?cidade=sao-paulo, pedida em 8 de outubro de 2026 e cortada a uma Feature (o campo total diz quantas vieram):

{
  "type": "FeatureCollection",
  "attribution": {
    "text": "Dados: Trânsito Agora Brasil",
    "url": "https://transitoagora.com.br"
  },
  "metadata": {
    "titulo": "Interdições em São Paulo, Trânsito Agora Brasil",
    "total": 23,
    "gerado_em": "2026-10-08T21:45:18.658Z",
    "licenca": "Uso conforme os termos em https://transitoagora.com.br/api-publica. Atribuição obrigatória: Trânsito Agora Brasil (https://transitoagora.com.br) e a fonte de cada item (campo fonte); posições geocodificadas com OpenStreetMap (© colaboradores do OpenStreetMap, ODbL).",
    "documentacao": "https://transitoagora.com.br/api-publica"
  },
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -46.7101434,
          -23.4971614
        ]
      },
      "properties": {
        "tipo": "bloqueio_parcial",
        "tipo_texto": "Bloqueio parcial",
        "via": "Rua Baltazar da Silveira",
        "trecho": "entre as ruas Padre Mariano Ronchi e Padre Justino Lombardi",
        "municipio": "São Paulo",
        "uf": "SP",
        "inicio": "2026-10-08T00:00",
        "fim": "2026-12-26T23:59",
        "em_vigor": true,
        "motivo": "serviços de concretagem",
        "resumo": "A Rua Baltazar da Silveira, em Pirituba, será interditada parcialmente entre as ruas Padre Mariano Ronchi e Padre Justino Lombardi a partir de quinta-feira (08) para estacionamento de betoneiras e bombas de concretagem, com duração prevista de 80 dias.",
        "desvio": null,
        "oficial": false,
        "fonte": "CET",
        "fonte_url": "http://wwn.cetsp.com.br/noticias/2026/10/08/rua-baltazar-da-silveira-em-pirituba-sera-interditada-parcialmente-para-servicos-de-concretagem.aspx",
        "ponto_aproximado": false,
        "pagina": "https://transitoagora.com.br/sao-paulo/sao-paulo"
      }
    }
  ]
}

Os campos de cada Feature

No topo da resposta: attribution (o texto e o link que tem de mostrar) e metadata (título, total de Features, hora em que foi gerada, termos e documentação). O cabeçalho X-Attribution repete a atribuição, e X-API-Trial-Ends diz quando termina o teste da sua chave.

Planos

Como contratar: por enquanto, por email e fatura. Escreva para [email protected] com o nome do projeto e o uso previsto; respondemos com o plano e a fatura, e a sua chave passa a valer sem prazo.

O que os planos cobram é o acesso ao serviço: a chave, os limites, a leitura das fontes a cada poucos minutos, o mapeamento das vias e o suporte quando uma fonte cai. Os dados continuam sendo de quem os publica (os órgãos de trânsito, os parceiros e o noticiário citado em cada item), e o crédito de cada fonte faz parte das condições de uso.

Termos de uso

• Todo pedido leva chave (sem chave, só até 13 de outubro de 2026).
• A chave de teste vale 5 dias a contar do primeiro pedido. Depois disso, a API responde 402 até a chave passar a um plano pago.
• Construir um produto sobre a API sem plano pago, ou sem atribuição, não é um uso autorizado.
• A chave é de quem a pediu: não publique nem compartilhe. Se vazar, escreva e emitimos outra.

Dados: <a href="https://transitoagora.com.br">Trânsito Agora Brasil</a>

Erros

Os erros vêm em JSON, com os campos erro, detalhe e contato.

Limites

Por chave, não por IP, para que um app com muitos usuários não seja travado por um deles: 120 pedidos por hora no Teste, e o teto por dia de cada plano acima. Sem chave, enquanto durar a carência, 120 pedidos por hora. Cada resposta traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset.

O limite é folgado por uma razão prática: os órgãos publicam anúncios, não telemetria, e o feed muda a cada poucos minutos. Pedir mais de uma vez por minuto quase nunca traz nada novo. O CORS está aberto, para chamar direto do navegador.

Honestidade sobre a cobertura

O feed traz o que os órgãos e o noticiário publicaram, não tudo o que acontece nas ruas. Uma cidade sem interdições na resposta não é uma cidade sem interdições: é uma cidade onde ninguém anunciou nada que a gente tenha lido. Se construir alertas em cima disto, diga isso a quem os recebe. Em emergência, 190, 192 ou 193.

Publicar dados, em vez de ler

Esta página é para quem lê os dados. Se é uma prefeitura, um DER, uma concessionária ou a Defesa Civil e quer que as suas interdições entrem no mapa e nesta API com a sua assinatura, veja o programa de parceiros. É grátis para órgãos públicos.

Dúvidas, outro plano ou uma chave nova: [email protected].