Skip to content

ibge.v1 #

Constants #

const names_providers = {
	Providers.dados_abertos_br: 'dados-abertos-br'
	Providers.gov:              'gov'
	Providers.wikipedia:        'wikipedia'
}
const uri_municipios = 'https://brasilapi.com.br/api/ibge/municipios/v1'

Para referência: https://brasilapi.com.br/docs#tag/IBGE/paths/~1ibge~1municipios~1v1~1{siglaUF}?providers=dados-abertos-br,gov,wikipedia/get

const uri_uf = 'https://brasilapi.com.br/api/ibge/uf/v1'

Para referência https://brasilapi.com.br/docs#tag/IBGE/paths/~1ibge~1uf~1v1/get

fn get_estado_por_sigla_ou_codigo #

pub fn get_estado_por_sigla_ou_codigo(sigla_ou_codigo SiglaCodigo) !Estado

get_estado_por_sigla_ou_codigo Retorna informações de um estado do Brasil

https://brasilapi.com.br/docs#tag/IBGE/paths/~1ibge~1uf~1v1~1{siglaOuCodigo}/get

Exemplos de uso:

if estado := _ibge.get_estado_por_sigla_ou_codigo(sigla_ou_codigo: 'PB') { dump(estado) } else { dump(err) }

Caso ocorro algum erro, o retorno será um IBGEError

fn get_estados #

pub fn get_estados() ![]Estado

get_estados Retorna informações de todos estados do Brasil

https://brasilapi.com.br/docs#tag/IBGE/paths/~1ibge~1uf~1v1/get

Exemplos de uso:

if estados := _ibge.get_estados() { dump(estados) } else { dump(err) }

Caso ocorro algum erro, o retorno será um IBGEError

fn get_municipios #

pub fn get_municipios(param ParamsGet) ![]IBGE

get_municipios Retorna os municípios da unidade federativa

https://brasilapi.com.br/docs#tag/IBGE/paths/~1ibge~1municipios~1v1~1{siglaUF}?providers=dados-abertos-br,gov,wikipedia/get

Exemplos de uso:

if municipios := ibfe.get_municipios(uf: 'PB', providers: ibge.Providers.dados_aberto_br | Wikipedia) { dump(municipios) } else { dump(err) }

Caso ocorro algum erro, o retorno será um IBGEError

type SiglaCodigo #

pub type SiglaCodigo = int | string

fn (SiglaCodigo) str #

pub fn (s SiglaCodigo) str() string

enum Providers #

@[flag]
pub enum Providers {
	dados_abertos_br
	gov
	wikipedia
}

fn (Providers) get_names_setad #

pub fn (p Providers) get_names_setad() []string

struct Estado #

pub struct Estado {
pub:
	id     int
	sigla  string
	nome   string
	regiao ?Regiao
}

struct IBGE #

pub struct IBGE {
pub:
	nome        string
	codigo_ibge string
}

struct ParamsGet #

@[params]
pub struct ParamsGet {
pub:
	uf        string    @[required]
	providers Providers @[required]
}

struct Regiao #

pub struct Regiao {
pub:
	id    int
	sigla string
	nome  string
}