Dados Abertos de Iluminação Pública — Iluminando

Informações públicas e gratuitas sobre lâmpadas apagadas, coletadas pelos próprios moradores. Hoje em operação em Guararema/SP.

O que é isso?

O Iluminando é um projeto que permite que qualquer morador reporte, em poucos segundos, uma lâmpada de rua apagada — direto pelo celular, com localização automática. Cada reporte vira um dado público: qualquer pessoa pode consultar onde e quando os problemas foram registrados.

O que são "dados abertos"?

Dados abertos são informações públicas que podem ser vistas, baixadas e reaproveitadas por qualquer pessoa, sem pedir autorização e sem pagar nada. Aqui, os dados abertos são os registros de iluminação pública da cidade onde o Iluminando está em operação — atualmente, Guararema.

Por que isso importa?

Com esses dados, é possível acompanhar quais ruas e bairros têm mais problemas de iluminação, cobrar a prefeitura e a empresa responsável pela manutenção, e conferir se os reparos prometidos realmente aconteceram. Transparência ajuda a cidade inteira.

Quem pode usar

  • Moradores curiosos
  • Jornalistas
  • Vereadores e câmara municipal
  • Prefeitura e órgãos de fiscalização (TCE, ouvidoria)
  • Pesquisadores e universidades
  • Quem programa — veja a seção técnica abaixo
⚠ O que NÃO aparece aqui Por respeito à privacidade (Lei Geral de Proteção de Dados — LGPD, Lei 13.709/2018), nome, telefone e qualquer outro dado de quem fez o reporte nunca são divulgados. Só ficam públicos os dados sobre o problema em si: local, data e tipo de ocorrência.

Licença

Você pode usar, copiar e republicar esses dados livremente, desde que cite a fonte (Iluminando). Essa licença é conhecida tecnicamente como Creative Commons CC BY 4.0.

Ver o mapa

Prefere ver tudo isso num mapa? É mais fácil de explorar.

Quer reportar uma lâmpada apagada? →

Para desenvolvedores

Versão 1.31.0 · Licença Creative Commons CC BY 4.0 · Acesso livre, sem autenticação, sem custo.

Endpoints

  • GET /v1/ocorrencias
  • GET /v1/ocorrencias/{id}
  • GET /v1/protocolos
  • GET /v1/estatisticas
  • GET /v1/metodologia
  • GET /v1/status
  • GET /openapi.yaml

Parâmetros comuns

formato json (padrão) | csv
pagina número da página (padrão: 1)
limite itens por página, máx 1000 (padrão: 100)
data_inicio AAAA-MM-DD
data_fim AAAA-MM-DD
tipo ACESA | APAGADA
bairro nome do bairro, EXATO como publicado em `bairro` (só em /ocorrencias)
endereco nome da via, EXATO como publicado em `endereco` (só em /ocorrencias)
resumo AAAA-MM-DD — o conjunto publicado no resumo diário dessa data, atrasadas inclusas (só em /ocorrencias; registro desde 2026-07-26)
ids ids de ocorrência separados por vírgula, máx 100 (só em /ocorrencias)

Especificação completa (OpenAPI): openapi.yaml

Exemplo: curl "https://dados.iluminando.app.br/v1/ocorrencias?limite=10"

Prefere o JSON cru desta página? clique aqui.