API Clima

Clima diário#

Parâmetros

Isto não é o histórico horário com um GROUP BY à frente. Os campos diários são derivados uma só vez, na ingestão, numa fronteira de dia escolhida pela física e não pela conveniência, e os campos derivados — temperatura aparente, duração da insolação, humidade média — são calculados a partir da série horária completa e não a partir dos extremos diários.

Agregados mensais#

Somas para as acumulações, médias e extremos para o resto. O mesmo preço da série diária, porque lê a mesma coluna.

Peça-os quando é um valor mensal que realmente traça, em vez de ir buscar trinta vezes os dados e reduzi-los você mesmo — o lento é a transferência, não a aritmética.

O clima de um lugar, numa só chamada#

Parâmetros

Tudo o que uma página de clima afirma sobre um local, já reduzido: doze normais mensais, uma linha por ano de calendário completo, os recordes absolutos com as datas em que caíram, a tendência de aquecimento por mínimos quadrados com a sua significância, e o código Köppen-Geiger. Para qualquer coordenada de terra firme do planeta.

daily=true não é o mesmo que normals?daily=true

E a diferença é o essencial. O endpoint das normais faz a média sobre uma janela OMM de trinta anos; este faz a média sobre a janela que pediu — o arquivo inteiro, por omissão.

É a única maneira de dizer «9,4 °C acima do normal para um 30 de julho» com oitenta e sete anos por trás da afirmação em vez de trinta. Cada dia traz a sua contagem de amostras, por isso alargar a uma normal centrada de quinze dias escreve-se Σ(mean·samples) / Σ(samples) — exato, e sem um segundo pedido.

Duas convenções a conhecer antes de comparar com outra fonte

Um ano de calendário só entra na série anual e na tendência se o arquivo tiver pelo menos 360 dos seus dias, pelo que o ano em curso fica de fora. Meio ano lê-se como um colapso da precipitação e arrasta consigo uma reta de tendência.

trends vale null abaixo de dez anos completos. Abaixo disso, um declive é ruído meteorológico vestido de sinal climático, e preferimos não publicar nada a publicar um número errado dito com confiança. Cada tendência traz pela mesma razão o seu p_value e a sua marca significant — leia-os antes de citar o declive.

Normais OMM#

Parâmetros

Uma normal não é a média do período que calhou pedir. É uma média de trinta anos sobre uma janela fixada pela Organização Meteorológica Mundial, para que duas pessoas que citam uma normal citem a mesma coisa.

Se o que quer é «a normal sobre o registo inteiro» e não sobre uma janela OMM, use antes /v1/climate/summary — só precisa do scope climate e dá-lhe oitenta e sete anos em vez de trinta.

Comparar duas normais#

Esta é a pergunta que a maioria das pessoas está realmente a fazer quando pede uma normal — não «o que é normal aqui» mas «quanto é que o normal se mexeu».

Respondê-la num só pedido garante que as duas metades não podem vir de runs diferentes, que é o modo de falha de a calcular por si a partir de duas chamadas: o arquivo avança entre elas, e a diferença que publica passa então a conter uma mudança de versão além de uma mudança climática.

Cobertura, campos e células#

cells/resolve responde à pergunta que se devia fazer a qualquer produto em grelha antes de confiar nele: que célula estou realmente a ler, e a que distância está do ponto que pedi? A 28 km essa distância pode ser de 20 km, e sabê-la é a diferença entre citar um número e citá-lo com responsabilidade.

fields tem o mesmo contrato que /v1/historical/variables: lista o que o run tem e não o que o produto poderá vir a ter um dia, para que um cliente construído contra ele não parta quando o arquivo crescer.