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
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 mapaPrefere ver tudo isso num mapa? É mais fácil de explorar.
Para desenvolvedores
Endpoints
GET /v1/ocorrenciasGET /v1/ocorrencias/{id}GET /v1/protocolosGET /v1/estatisticasGET /v1/metodologiaGET /v1/statusGET /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.