PHP — Obtendo Estados e Cidades e seus Códigos do IBGE

Olá Gente

Você já precisou integrar com NFe e se deparou com a necessidade dos códigos do IBGE das cidades? Ou Simplesmente precisou criar um Select com todos os Estados e Cidades?

Para isto, o próprio IBGE possui uma API oficial e gratuita!

Antes iremos obter os Estados, para isto, faça uma GET para:

https://servicodados.ibge.gov.br/api/v1/localidades/estados

Exemplo:

Iremos receber um array com todos estados, e em cada estado temos o Nome/Sigla e sua Região:

https://gist.github.com/cmacetko/9ffa3f2595f8acb1d1d631c1abfbec96

Agora iremos obter todas as cidades do estado “SC”.

Para isto, faça uma GET para a API abaixo:

https://servicodados.ibge.gov.br/api/v1/localidades/estados/[ESTADO]/distritos

Substituindo “[ESTADO]” pela Sigla do estado que você deseja consultar.

Exemplo:

Iremos receber um array com todas as cidades:

Os principais dados aqui são:

- municipio.nome: O nome da Cidade
- municipio.id: O código IBGE da cidade

Recomendo também salvar o ID dos registros, para que você possa atualizar sua base periodicamente.

Por hoje é isto, queridos desenvolvedores! 👩‍💼
Até logo! 👋