Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

🇧🇷 Dados Abertos de Cidades Brasileiras

Dados estruturados sobre cidades, estados, DDDs e bairros do Brasil em formato JSON.

Fonte: AutoCidade - Guia de cidades e negócios locais do Brasil

📂 Estrutura

dados/
├── cidades.json      # 20 maiores cidades do Brasil
├── estados.json      # 27 estados + DF
├── ddds.json         # DDDs de todas as regiões
└── bairros/          # Bairros por cidade
    ├── sao-paulo.json
    ├── rio-de-janeiro.json
    ├── belo-horizonte.json
    └── ...

🚀 Uso Rápido

JavaScript/Node.js

// Carregar cidades
const cidades = require('./dados/cidades.json');
console.log(cidades.cidades[0]); // São Paulo

// Buscar DDD de uma cidade
const ddds = require('./dados/ddds.json');
console.log(ddds.ddds["11"]); // { estado: "SP", cidades: [...] }

Python

import json

# Carregar cidades
with open('dados/cidades.json', 'r', encoding='utf-8') as f:
    cidades = json.load(f)

print(cidades['cidades'][0]['nome'])  # São Paulo

# Buscar bairros de São Paulo
with open('dados/bairros/sao-paulo.json', 'r', encoding='utf-8') as f:
    sp = json.load(f)

print(sp['regioes'][0]['bairros'])  # Bairros da Zona Sul

cURL

# Via GitHub Raw
curl https://raw.githubusercontent.com/andradeandrey/autocidade-dados-abertos/main/dados/cidades.json

📊 Dados Disponíveis

Cidades (cidades.json)

Campo Descrição
slug Identificador URL-friendly
nome Nome da cidade
estado UF do estado
ddd Código DDD
populacao_estimada População aproximada
regiao Região do Brasil
capital Se é capital estadual
url Link para o AutoCidade

Cidades incluídas: São Paulo, Rio de Janeiro, Belo Horizonte, Brasília, Curitiba, Fortaleza, Manaus, Salvador, Recife, Porto Alegre, Goiânia, Guarulhos, Campinas, São Luís, São Gonçalo, Maceió, Duque de Caxias, Natal, Campo Grande, Belém.

DDDs (ddds.json)

Lista completa de DDDs do Brasil com cidades associadas:

  • 67 códigos DDD
  • Todas as capitais
  • Principais cidades do interior

Estados (estados.json)

Todos os 27 estados brasileiros com:

  • UF
  • Nome completo
  • Capital
  • Região
  • DDDs do estado

Bairros (bairros/*.json)

Bairros organizados por região para as maiores cidades:

  • Regiões (Zona Sul, Zona Norte, Centro, etc.)
  • Lista de bairros por região
  • Total de bairros

🔗 Links Úteis

📝 Exemplos de Uso

Encontrar DDD de uma cidade

function buscarDDD(cidade) {
  const ddds = require('./dados/ddds.json');
  for (const [ddd, info] of Object.entries(ddds.ddds)) {
    if (info.cidades.some(c => c.toLowerCase().includes(cidade.toLowerCase()))) {
      return ddd;
    }
  }
  return null;
}

console.log(buscarDDD('Campinas')); // "19"

Listar bairros de uma zona

import json

def bairros_por_zona(cidade_slug, zona_slug):
    with open(f'dados/bairros/{cidade_slug}.json', 'r', encoding='utf-8') as f:
        cidade = json.load(f)

    for regiao in cidade['regioes']:
        if regiao['slug'] == zona_slug:
            return regiao['bairros']
    return []

print(bairros_por_zona('sao-paulo', 'zona-sul'))
# ['Moema', 'Itaim Bibi', 'Vila Mariana', ...]

📄 Licença

Dados disponíveis sob licença MIT.

Fonte: AutoCidade.com

🤝 Contribuindo

  1. Fork este repositório
  2. Crie uma branch (git checkout -b feature/nova-cidade)
  3. Commit suas alterações (git commit -m 'Adiciona dados de XYZ')
  4. Push para a branch (git push origin feature/nova-cidade)
  5. Abra um Pull Request

Desenvolvido por AutoCidade - Encontre negócios locais em qualquer cidade do Brasil.

About

dados abertos de cidades brasileiras - DDDs, bairros, estados. Fonte: autocidade.com

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors