Skip to content

cptec.v1 #

Constants #

const uri_cidade = 'https://brasilapi.com.br/api/cptec/v1/cidade'

https://brasilapi.com.br/docs#operation/listcities(/cptec/v1/cidade)

const uri_clima_capital = 'https://brasilapi.com.br/api/cptec/v1/clima/capital'
const uri_clima_aeroporto = 'https://brasilapi.com.br/api/cptec/v1/clima/aeroporto'
const uri_previsao_cidade = 'https://brasilapi.com.br/api/cptec/v1/clima/previsao'
const uri_previsao_oceanica_cidade = 'https://brasilapi.com.br/api/cptec/v1/ondas/'

fn cidades #

pub fn cidades(params ParamCidades) ![]Cidade

cidades Retorna listagem com todas as cidades junto a seus respectivos códigos presentes nos serviços da CPTEC

https://brasilapi.com.br/docs#operation/listcities(/cptec/v1/cidade)

Exemplo de uso:

if cidades := cptec.cidades() { dump(cidades) } else { println(err) //print message error }

Caso ocorra alguma falha irá retornar um errors.CptecError

fn clima_aeroporto #

pub fn clima_aeroporto(icao_code string) !Capital

clima_aeroporto Retorna condições meteorológicas atuais no aeroporto solicitado. Este endpoint utiliza o código ICAO (4 dígitos) do aeroporto.

https://brasilapi.com.br/docs#operation/airportcurrentcondicao(/cptec/v1/clima/aeroporto/:icaoCode)

Exemplo de uso:

if clima := cptec.clima_aeroporto() { dump(clima) } else { println(err) //print message error }

Caso ocorra alguma falha irá retornar um errors.CptecError

fn clima_capital #

pub fn clima_capital() ![]Capital

clima_capital Retorna condições meteorológicas atuais nas capitais do país, com base nas estações de solo de seu aeroporto.

https://brasilapi.com.br/docs#operation/Condi%C3%A7%C3%B5esatuaisnascapitais(/cptec/v1/clima/capital)

Exemplo de uso:

if climas := cptec.clima_capital() { dump(climas) } else { println(err) //print message error }

Caso ocorra alguma falha irá retornar um errors.CptecError

fn previsao_cidade #

pub fn previsao_cidade(params ParamPrevisaoCidade) !Previsiao

previsao_cidade Retorna Pervisão meteorológica de 1 até 6 dias da cidade informada.

https://brasilapi.com.br/docs#operation/airportcurrentcondicao(/cptec/v1/clima/aeroporto/:icaoCode)

Exemplo de uso:

if previsao := cptec.previsao_cidade() { dump(previsao) } else { println(err) //print message error }

Caso ocorra alguma falha irá retornar um errors.CptecError

fn previsao_oceanica #

pub fn previsao_oceanica(params ParamPrevisaoCidade) !PrevisaOceanica

previsao_oceanica Retorna Pervisão oceânica de 1 até 6 dias da cidade informada.

https://brasilapi.com.br/docs#operation/airportcurrentcondicao(/cptec/v1/clima/aeroporto/:icaoCode)

Exemplo de uso:

if previsao := cptec.previsao_oceanica() { dump(previsao) } else { println(err) //print message error }

Caso ocorra alguma falha irá retornar um errors.CptecError

struct Capital #

pub struct Capital {
pub:
	codigo_icao         string
	atualizado_em       string
	pressao_atmosferica string
	visibilidade        string
	vento               int
	direcao_vento       int
	umidade             int
	condicao            string
	condicao_desc       string @[json: 'condicao_Desc']
	temp                int
}

struct Cidade #

pub struct Cidade {
pub:
	nome   string
	estado string
	id     int
}

struct Clima #

pub struct Clima {
pub:
	data          string
	condicao      string
	min           int
	max           int
	indice_uv     int
	condicao_desc string
}

struct DadoOndas #

pub struct DadoOndas {
pub:
	vento              f32
	direcao_vento      string
	direcao_vento_desc string
	altura_onda        f32
	direcao_onda       string
	direcao_onda_desc  string
	agitacao           string
	hora               string
}

struct Ondas #

pub struct Ondas {
pub:
	data        string
	dados_ondas []DadoOndas
}

struct ParamCidades #

@[params]
pub struct ParamCidades {
pub:
	city_name ?string
}

struct ParamPrevisaoCidade #

@[params]
pub struct ParamPrevisaoCidade {
pub:
	city_code int
	days      i16 = 1
}

struct PrevisaOceanica #

pub struct PrevisaOceanica {
pub:
	cidade        string
	estado        string
	atualizado_em string
	ondas         []Ondas
}

struct Previsiao #

pub struct Previsiao {
pub:
	cidade        string
	estado        string
	atualizado_em string
	clima         []Clima
}