Arquivos JSON de localidades do Brasil para Regiões, Estados, Cidades e Distritos. Compilados a partir da base pública de localidades do IBGE.

Estes arquivos foram compilados para servir ao desenvolvimento de aplicações que precisem de dados sobre localidades do Brasil.

Use-os livremente em seus projetos, mas lembre-se de citar a fonte.

• regioes.json - 159 Bytes, 5 Regiões
• estados.json - 1.28 KB, 27 Estados
• cidades.json - 1.87 MB, 5.570 Cidades
• distritos.json - 1.25 MB, 10.670 Distritos
• capitais.json - 9.08 KB, 27 Capitais (também presentes em cidades.json)

// regioes.json : Regiao[]
interface Regiao {
  sigla: string
  nome: string
}

// estados.json : Estado[]
interface Estado {
  sigla: string
  nome: string
  regiao: Regiao['sigla']
}

// cidades.json : Cidade[]
// capitais.json : Cidade[]
interface Cidade {
  id: number
  nome: string
  uf: Estado['sigla']
  estado: Estado['nome']
  reg: Regiao['sigla']
  regiao: Regiao['nome']
  centreoide: {
    latitude: number
    longitude: number
  }
  microrregiao: {
    id: number
    nome: string
    mesorregiao: {
      id: number
      nome: string
    }
  }
  'regiao-imediata': {
    id: number
    nome: string
    'regiao-intermediaria': {
      id: number
      nome: string
    }
  }
}

// distritos.json : Distrito[]
interface Distrito {
  id: number
  nome: string
  cid: Cidade['id']
  cidade: Cidade['nome']
  uf: Estado['sigla']
  estado: Estado['sigla']
  regiao: Regiao['sigla']
}

Esses dados não são atualizados com frequência. Mas quando necessário atualizar, siga os passos abaixo:

• Clone este repositório com Git
• Abra-o como um projeto no VSCode (ou outro editor de sua preferência)
• Crie uma nova branch git para suas alterações
• Instale as dependências (Você precisa ter o Node.js instalado e o npm, yarn ou pnpm disponível)
• Execute o script build (npm run build ou yarn build ou pnpm build)
• Faça commit/push das alterações
• Abra um Pull Request para a branch main deste repositório