Skip to content

andradeandrey/autocidade-dados-abertos

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

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •