{"id":18030412,"url":"https://github.com/endersonmaia/ibge-localidades-sql","last_synced_at":"2025-08-29T05:12:26.518Z","repository":{"id":79860839,"uuid":"281270576","full_name":"endersonmaia/ibge-localidades-sql","owner":"endersonmaia","description":"Recupera cadastro de localidade do IBGE através da API e converte em um banco de dados SQL.","archived":false,"fork":false,"pushed_at":"2020-07-21T14:25:03.000Z","size":3,"stargazers_count":4,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-04T21:16:35.967Z","etag":null,"topics":["bash","ibge","ibge-api","open-data","sql","sqlite"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/endersonmaia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-21T02:02:29.000Z","updated_at":"2025-02-27T15:37:19.000Z","dependencies_parsed_at":"2023-07-11T04:01:28.892Z","dependency_job_id":null,"html_url":"https://github.com/endersonmaia/ibge-localidades-sql","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/endersonmaia/ibge-localidades-sql","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endersonmaia%2Fibge-localidades-sql","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endersonmaia%2Fibge-localidades-sql/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endersonmaia%2Fibge-localidades-sql/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endersonmaia%2Fibge-localidades-sql/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/endersonmaia","download_url":"https://codeload.github.com/endersonmaia/ibge-localidades-sql/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endersonmaia%2Fibge-localidades-sql/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272632419,"owners_count":24967250,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-29T02:00:10.610Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","ibge","ibge-api","open-data","sql","sqlite"],"created_at":"2024-10-30T09:14:14.275Z","updated_at":"2025-08-29T05:12:26.487Z","avatar_url":"https://github.com/endersonmaia.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IBGE Localidades\n\nEste projeto utiliza a API do IBGE para gerar uma base de dados com o Cadastro Brasileiro de  Localidades.\n\n- [IBGE Localidades](#ibge-localidades)\n  - [Carregando banco de dados](#carregando-banco-de-dados)\n  - [Tabelas](#tabelas)\n    - [Regiões](#regiões)\n    - [UFs](#ufs)\n    - [Mesorregiões](#mesorregiões)\n    - [Microrregiões](#microrregiões)\n    - [Municípios](#municípios)\n    - [Distritos](#distritos)\n    - [Subdistritos](#subdistritos)\n  - [Licença](#licença)\n\n## Carregando banco de dados\n\nVocê precisará dos programas `curl`, `sqlite` e `jq`.\n\nBaixe este repositório, e execute o script `./load-ibge-localidades.sh`.\n\nSegue uma consulta de teste :\n\n```shell\n$\u003e cat\u003c\u003cEOF | sqlite3 -csv ibge-localidades.db\n    SELECT regiao.sigla, regiao.nome, uf.sigla, uf.nome , count(*) AS qtd_municipios\n    FROM municipios    AS m\n    JOIN ufs           AS uf       ON (m.uf_id = uf.id)\n    JOIN regioes       AS regiao   ON (uf.regiao_id = regiao.id)\n    GROUP BY regiao.sigla, regiao.nome, uf.sigla, uf.nome;\nEOF\nCO,Centro-Oeste,DF,\"Distrito Federal\",1\nCO,Centro-Oeste,GO,\"Goiás\",246\nCO,Centro-Oeste,MS,\"Mato Grosso do Sul\",79\nCO,Centro-Oeste,MT,\"Mato Grosso\",141\nN,Norte,AC,Acre,22\nN,Norte,AM,Amazonas,62\nN,Norte,AP,\"Amapá\",16\nN,Norte,PA,\"Pará\",144\nN,Norte,RO,\"Rondônia\",52\nN,Norte,RR,Roraima,15\nN,Norte,TO,Tocantins,139\nNE,Nordeste,AL,Alagoas,102\nNE,Nordeste,BA,Bahia,417\nNE,Nordeste,CE,\"Ceará\",184\nNE,Nordeste,MA,\"Maranhão\",217\nNE,Nordeste,PB,\"Paraíba\",223\nNE,Nordeste,PE,Pernambuco,185\nNE,Nordeste,PI,\"Piauí\",224\nNE,Nordeste,RN,\"Rio Grande do Norte\",167\nNE,Nordeste,SE,Sergipe,75\nS,Sul,PR,\"Paraná\",399\nS,Sul,RS,\"Rio Grande do Sul\",497\nS,Sul,SC,\"Santa Catarina\",295\nSE,Sudeste,ES,\"Espírito Santo\",78\nSE,Sudeste,MG,\"Minas Gerais\",853\nSE,Sudeste,RJ,\"Rio de Janeiro\",92\nSE,Sudeste,SP,\"São Paulo\",645\n```\n\n## Tabelas\n\nA hierarquia do CNAE é Região \u003e UF \u003e Mesorregião \u003e Microrregião \u003e Município -\u003e Distrito -\u003e Subdistrito.\n\nEx.:\n\n```\nCadastro    Código      Sigla   Nome\nRegião      2           NE      Nordeste\nUF          27          AL      Alagoas\nMesorregião 2703                Leste Alagoano\nMicroregião 27011               Maceió\nMunicípio   2704302             Maceió\nDistrito    270430205           Maceió\nSubdistrito 27043020506         Primeira Região\n```\n\n### Regiões\n\n- `regioes`\n\n```sql\ncampo       tipo\n----        ----\nid          INT\nsigla       CHAR(2)\nnome        TEXT\n```\n\n### UFs\n\n- `ufs`\n\n```sql\ncampo       tipo\n-----       ----\nid          INT\nsigla       CHAR(2)\nnome        TEXT\nregiao_id   INT\n```\n\n### Mesorregiões\n\n- `mesorregioes`\n\n```sql\ncampo       tipo\n----        ----\nid          INT\nnome        TEXT\nuf_id       INT\nregiao_id   INT\n```\n\n### Microrregiões\n\n- `microrregioes`\n\n```sql\ncampo           tipo\n----            ----\nid              INT\nnome            TEXT\nmesorregiao_id  INT\nuf_id           INT\nregiao_id       INT\n```\n\n### Municípios\n\n- `municipios`\n\n```sql\ncampo           tipo\n----            ----\nid              INT\nnome            TEXT\nmicrorregiao_id INT\nmesorregiao_id  INT\nuf_id           INT\nregiao_id       INT\n```\n\n### Distritos\n\n- `distritos`\n\n```sql\ncampo           tipo\n----            ----\nid              INT\nnome            TEXT\nmunicipio_id    INT\nmicrorregiao_id INT\nmesorregiao_id  INT\nuf_id           INT\nregiao_id       INT\n```\n\n### Subdistritos\n\n- `subdistritos`\n\n```sql\ncampo           tipo\n----            ----\nid              INT\nnome            TEXT\ndistrito_id     INT\nmunicipio_id    INT\nmicrorregiao_id INT\nmesorregiao_id  INT\nuf_id           INT\nregiao_id       INT\n```\n\n## Licença\n\nO código fonte deste projeto é [MIT License](LICENSE), Copyright (c) 2020 Enderson Tadeu Salgueiro Maia.\n\nOs dados são obtivos através da [API do IBGE](https://servicodados.ibge.gov.br/api/docs/localidades?versao=1).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fendersonmaia%2Fibge-localidades-sql","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fendersonmaia%2Fibge-localidades-sql","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fendersonmaia%2Fibge-localidades-sql/lists"}