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

Simplifique a integração com NFe e a criação de Selects de Estados e Cidades utilizando a API oficial e gratuita do IBGE, que fornece informações precisas e atualizadas

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!

IBGE - API de serviço de dados
API de serviço de dados do IBGE

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! 👋