Climate
Série temporal climática¶
Através deste endpoint da API, você pode buscar diversas variáveis climáticas que foram extraídas para todos os municípios brasileiros a partir dos dados de reanálise baseados em satélite fornecidos pela Copernicus ERA5.
Essas séries são em escala de tempo diária. Detalhes sobre como os dados de satélite são processados e agregados no nível municipal estão disponíveis aqui.
Tabela de Parâmetros¶
Entrada¶
Nome do Parâmetro | Obrigatório | Tipo | Descrição |
---|---|---|---|
*page | sim | int | Página a ser exibida |
*per_page | sim | int | Quantos itens serão exibidos por página (até 100) |
start | sim | str (AAAA-mm-dd) | Data de início |
end | sim | str (AAAA-mm-dd) | Data de fim |
geocode | não | int | Código de município do IBGE |
uf | não | str (UF) | Abreviação de duas letras do estado brasileiro. Ex: SP |
Saída (itens)¶
Nome do Parâmetro | Tipo | Descrição |
---|---|---|
date | date (AAAA-mm-dd) | Dia do ano |
geocodigo | int | Código de município do IBGE |
temp_min | float (°C) | Temperatura mínima diária |
temp_med | float (°C) | Temperatura média diária |
temp_max | float (°C) | Temperatura máxima diária |
precip_min | float (mm) | Precipitação diária mínima |
precip_med | float (mm) | Precipitação diária média |
precip_max | float (mm) | Precipitação diária máxima |
precip_tot | float (mm) | Precipitação diária total |
pressao_min | float (atm) | Pressão mínima diária ao nível do mar |
pressao_med | float (atm) | Pressão média diária ao nível do mar |
pressao_max | float (atm) | Pressão máxima diária ao nível do mar |
umid_min | float (%) | Umidade relativa diária mínima |
umid_med | float (%) | Umidade relativa diária média |
umid_max | float (%) | Umidade relativa diária máxima |
Detalhes¶
page
consiste no total de itens retornados pela requisição dividido por per_page
. A informação de pagination
é retornada junto com a requisição. Ex.:
'pagination': {
'items': 10, # Quantidade de Itens sendo exibidos
'total_items': 10, # Quantidade total de Itens retornados na requisição
'page': 1, # *parâmetro da requisição
'total_pages': 1, # Quantidade total de páginas retornadas na requisição
'per_page': 100 # *parâmetro da requisição
},
Exemplos de uso¶
library(httr)
library(jsonlite)
climate_api <- "https://api.mosqlimate.org/api/datastore/climate/"
page <- "1"
pagination <- paste0("?page=", page, "&per_page=100&")
filters <- paste0("start=2022-12-30&end=2023-12-30")
headers <- add_headers(
`X-UID-Key` = API_KEY
)
url <- paste0(climate_api, pagination, filters)
resp <- GET(url, headers)
content <- content(resp, "text")
json_content <- fromJSON(content)
items <- json_content$items
pagination_data <- json_content$pagination
curl -X 'GET' \
'https://api.mosqlimate.org/api/datastore/climate/?start=2022-12-30&end=2023-12-30&page=1&per_page=100' \
-H 'accept: application/json' \
-H 'X-UID-Key: See X-UID-Key documentation'
# Or you can add a geocode to the filters
curl -X 'GET' \
'https://api.mosqlimate.org/api/datastore/climate/?start=2022-12-30&end=2023-12-30&geocode=3304557&page=1&per_page=100' \
-H 'accept: application/json' \
-H 'X-UID-Key: See X-UID-Key documentation'
*A paginação da resposta contém informações sobre a quantidade de itens retornados pela chamada da API. Essas informações podem ser usadas para navegar entre os dados consultados alterando o parâmetro page
na URL. Ver detalhes