Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kelvins/Municipios-Brasileiros

:house_with_garden: Dados relacionados aos municípios brasileiros
https://github.com/kelvins/Municipios-Brasileiros

codigo-ibge csv dados estados latitude longitude municipios municipios-brasileiros sql uf

Last synced: 10 days ago
JSON representation

:house_with_garden: Dados relacionados aos municípios brasileiros

Host: GitHub
URL: https://github.com/kelvins/Municipios-Brasileiros
Owner: kelvins
License: mit
Created: 2016-12-14T12:51:08.000Z (almost 8 years ago)
Default Branch: main
Last Pushed: 2024-06-21T14:20:28.000Z (5 months ago)
Last Synced: 2024-10-29T15:34:31.898Z (12 days ago)
Topics: codigo-ibge, csv, dados, estados, latitude, longitude, municipios, municipios-brasileiros, sql, uf
Language: Python
Homepage:
Size: 2.32 MB
Stars: 1,097
Watchers: 61
Forks: 612
Open Issues: 9
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-made-by-brazilians - Municípios Brasileiros

README

        # Municípios Brasileiros [![Build Status](https://img.shields.io/github/checks-status/kelvins/Municipios-Brasileiros/main)](https://github.com/kelvins/Municipios-Brasileiros/actions)

Arquivos `SQL`, `CSV` e `JSON` contendo o código IBGE, nome do município, capital, código UF, UF, estado, latitude, longitude, código SIAFI, DDD e fuso horário de todos (ou quase todos) os municípios brasileiros. Total de 5.570 registros.

## Exemplos

### Dados

| Código IBGE |  Nome do Município  | Código UF | UF  |      Estado       | Capital | Latitude | Longitude |    Região    | Código Siafi | DDD |    Fuso Horário     |

| :---------: | :-----------------: | :-------: | :-: | :---------------: | :-----: | :------: | :-------: | :----------: | :----------: | :-: | :-----------------: |

|   5200050   |   Abadia de Goiás   |    52     | GO  |       Goiás       |    0    | -16.7573 | -49.4412  | Centro-Oeste |     1050     | 62  |  America/Sao_Paulo  |

|   3100104   | Abadia dos Dourados |    31     | MG  |   Minas Gerais    |    0    | -18.4831 | -47.3916  |   Sudeste    |     4001     | 34  |  America/Sao_Paulo  |

|   5200100   |      Abadiânia      |    52     | GO  |       Goiás       |    0    | -16.1970 | -48.7057  | Centro-Oeste |     9201     | 62  |  America/Sao_Paulo  |

|   3100203   |       Abaeté        |    31     | MG  |   Minas Gerais    |    0    | -19.1551 | -45.4444  |   Sudeste    |     4003     | 37  |  America/Sao_Paulo  |

|   4314902   |    Porto Alegre     |    43     | RS  | Rio Grande do Sul |    1    | -30.0318 | -51.2065  |     Sul      |     8801     | 51  |  America/Sao_Paulo  |

|   5106752   |  Pontes e Lacerda   |    51     | MT  |    Mato Grosso    |    0    | -15.2219 | -59.3435  | Centro-Oeste |     8999     | 65  | America/Porto_Velho |

### Exemplo SQL

#### Estados

```sql

CREATE TABLE estados(

    codigo_uf INT NOT NULL,

    uf VARCHAR(2) NOT NULL,

    nome VARCHAR(100) NOT NULL,

    latitude FLOAT(8) NOT NULL,

    longitude FLOAT(8) NOT NULL,

    regiao VARCHAR(12) NOT NULL,

    PRIMARY KEY (codigo_uf)

);

INSERT INTO estados VALUES

(11,'RO','Rondônia',-10.83,-63.34,'Norte'),

(12,'AC','Acre',-8.77,-70.55,'Norte'),

(13,'AM','Amazonas',-3.47,-65.1,'Norte'),

...

```

#### Municípios

```sql

CREATE TABLE municipios(

    codigo_ibge INT NOT NULL,

    nome VARCHAR(100) NOT NULL,

    latitude FLOAT(8) NOT NULL,

    longitude FLOAT(8) NOT NULL,

    capital BOOLEAN NOT NULL,

    codigo_uf INT NOT NULL,

    siafi_id VARCHAR(4) NOT NULL UNIQUE,

    ddd INT NOT NULL,

    fuso_horario VARCHAR(32) NOT NULL,

    PRIMARY KEY (codigo_ibge),

    FOREIGN KEY (codigo_uf) REFERENCES estados (codigo_uf)

);

INSERT INTO municipios VALUES

(5200050,'Abadia de Goiás',-16.7573,-49.4412,FALSE,52,'1050',62,'America/Sao_Paulo'),

(3100104,'Abadia dos Dourados',-18.4831,-47.3916,FALSE,31,'4001',34,'America/Sao_Paulo'),

(5200100,'Abadiânia',-16.197,-48.7057,FALSE,52,'9201',62,'America/Sao_Paulo'),

...

```

### Exemplo CSV

#### Estados

```csv

codigo_uf,uf,nome,regiao

11,RO,Rondônia,-10.83,-63.34,Norte

12,AC,Acre,-8.77,-70.55,Norte

13,AM,Amazonas,-3.47,-65.1,Norte

...

```

#### Municípios

```csv

codigo_ibge,nome,latitude,longitude,capital,codigo_uf,siafi_id,ddd,fuso_horario

5200050,Abadia de Goiás,-16.7573,-49.4412,0,52,1050,62,America/Sao_Paulo

3100104,Abadia dos Dourados,-18.4831,-47.3916,0,31,4001,34,America/Sao_Paulo

5200100,Abadiânia,-16.197,-48.7057,0,52,9201,62,America/Sao_Paulo

...

```

### Exemplo JSON

#### Estados

```json

[

  {

    "codigo_uf": 11,

    "uf": "RO",

    "nome": "Rondônia",

    "latitude": -10.83,

    "longitude": -63.34,

    "regiao": "Norte"

  },

  {

    "codigo_uf": 12,

    "uf": "AC",

    "nome": "Acre",

    "latitude": -8.77,

    "longitude": -70.55,

    "regiao": "Norte"

  },

  {

    "codigo_uf": 13,

    "uf": "AM",

    "nome": "Amazonas",

    "latitude": -3.47,

    "longitude": -65.1,

    "regiao": "Norte"

  }

]

```

#### Municípios

```json

[

  {

    "codigo_ibge": 5200050,

    "nome": "Abadia de Goiás",

    "latitude": -16.7573,

    "longitude": -49.4412,

    "capital": 0,

    "codigo_uf": 52,

    "siafi_id": 1050,

    "ddd": 62,

    "fuso_horario": "America/Sao_Paulo"

  },

  {

    "codigo_ibge": 3100104,

    "nome": "Abadia dos Dourados",

    "latitude": -18.4831,

    "longitude": -47.3916,

    "capital": 0,

    "codigo_uf": 31,

    "siafi_id": 4001,

    "ddd": 34,

    "fuso_horario": "America/Sao_Paulo"

  },

  {

    "codigo_ibge": 5200100,

    "nome": "Abadiânia",

    "latitude": -16.197,

    "longitude": -48.7057,

    "capital": 0,

    "codigo_uf": 52,

    "siafi_id": 9201,

    "ddd": 62,

    "fuso_horario": "America/Sao_Paulo"

  }

]

```

**Nota**: caso encontre qualquer dado inconsistente ou tenha alguma sugestão por favor crie uma [issue](https://github.com/kelvins/Municipios-Brasileiros/issues) ou envie um [pull request](https://github.com/kelvins/Municipios-Brasileiros/pulls) diretamente. Obrigado a todos os [colaboradores](https://github.com/kelvins/Municipios-Brasileiros/graphs/contributors). :raised_hands:

## Exportação dos Dados

Existem diversas ferramentas para trabalhar com bancos de dados e exportar os dados em outros formatos como `CSV`, `JSON`, entre outros.

Uma ferramenta que costumo utilizar com frequência é o [DBeaver](https://dbeaver.io/), pois além de ser multiplataforma ela é simples de usar e disponibiliza várias opções para a exportação dos dados.

## Serviço de Dados do IBGE

Hoje o IBGE conta com um serviço de dados que disponibiliza diversas informações sobre as localidades do Brasil.

A API do IBGE pode ser acessada pelo seguinte endereço: https://servicodados.ibge.gov.br/api/docs/localidades