Dados Abertos de Cidades Brasileiras em JSON - DDDs, Bairros, Estados · andradeandrey

  # 🇧🇷 Dados Abertos de Cidades Brasileiras

  Disponibilizei um repositório com dados estruturados sobre cidades brasileiras, pronto para usar em qualquer projeto.

  ## O que está incluído

  | Arquivo | Descrição |
  |---------|-----------|
  | `cidades.json` | 20 maiores cidades com população, DDD, região |
  | `estados.json` | 27 estados + DF com capitais |
  | `ddds.json` | 67 DDDs com cidades associadas |
  | `bairros/*.json` | ~450 bairros de 20 cidades |

  ## Uso Rápido

  ### JavaScript
  ```javascript
  const response = await fetch('https://raw.githubusercontent.com/andradeandrey/autocidade-dados-abertos/main/dados/cidades.json');
  const data = await response.json();
  console.log(data.cidades[0]); // São Paulo

  Python

  import requests

  url = "https://raw.githubusercontent.com/andradeandrey/autocidade-dados-abertos/main/dados/ddds.json"
  ddds = requests.get(url).json()

  # Encontrar DDD de uma cidade
  def buscar_ddd(cidade):
      for ddd, info in ddds["ddds"].items():
          if any(cidade.lower() in c.lower() for c in info["cidades"]):
              return ddd
      return None

  print(buscar_ddd("Campinas"))  # 19

  cURL

  curl -s https://raw.githubusercontent.com/andradeandrey/autocidade-dados-abertos/main/dados/estados.json | jq '.estados[] | select(.uf == "SP")'

  Casos de Uso

  - Formulários: Validar DDDs, autocompletar cidades
  - Dashboards: Dados demográficos por região
  - Apps: Listar bairros de uma cidade
  - Data Science: Análises geográficas

  Link

  🔗 GitHub: https://github.com/andradeandrey/autocidade-dados-abertos

  📊 Fonte: https://autocidade.com

  ---
  Contribuições são bem-vindas! Se quiser adicionar mais cidades ou dados, abre um PR.

  **Tags:** `#opensource #brasil #json #api #dados`