API Klimat

Klimat dobowy#

Parametry

To nie jest historia godzinowa z GROUP BY z przodu. Pola dobowe są wyprowadzane raz, przy wciąganiu danych, na granicy doby wybranej ze względu na fizykę, a nie na wygodę, a pola pochodne — temperatura odczuwalna, usłonecznienie, średnia wilgotność — są liczone z pełnego szeregu godzinowego, a nie z dobowych ekstremów.

Agregaty miesięczne#

Sumy dla wielkości kumulowanych, średnie i ekstrema dla reszty. Ta sama cena co szereg dobowy, bo czyta tę samą kolumnę.

Poproś o nie, gdy to wartość miesięczna jest tym, co naprawdę rysujesz, zamiast ściągać trzydzieści razy więcej danych i redukować je samodzielnie — wolny jest transfer, a nie arytmetyka.

Klimat miejsca, w jednym wywołaniu#

Parametry

Wszystko, co strona klimatyczna mówi o danym miejscu, już zredukowane: dwanaście norm miesięcznych, jeden wiersz na każdy pełny rok kalendarzowy, rekordy wszech czasów z datami, w których padły, trend ocieplenia metodą najmniejszych kwadratów wraz z jego istotnością oraz kod Köppena-Geigera. Dla dowolnej lądowej współrzędnej na Ziemi.

daily=true to nie to samo co normals?daily=true

I w tej różnicy tkwi sedno. Endpoint norm uśrednia po trzydziestoletnim oknie WMO; ten uśrednia po oknie, o które poprosiłeś — domyślnie po całym archiwum.

To jedyny sposób, żeby powiedzieć „9,4 °C powyżej normy jak na 30 lipca” z osiemdziesięcioma siedmioma latami za tym twierdzeniem, a nie trzydziestoma. Każdy dzień niesie swoją liczbę próbek, więc poszerzenie do piętnastodniowej normy centrowanej zapisuje się jako Σ(mean·samples) / Σ(samples) — dokładnie i bez drugiego żądania.

Dwie konwencje, które warto znać przed porównaniem z innym źródłem

Rok kalendarzowy wchodzi do szeregu rocznego i do trendu tylko wtedy, gdy archiwum ma co najmniej 360 jego dni, więc rok bieżący jest wyłączony. Pół roku czyta się jak załamanie opadów i ciągnie za sobą linię trendu.

trends jest równe null poniżej dziesięciu pełnych lat. Poniżej tego nachylenie to szum pogodowy przebrany za sygnał klimatyczny, a wolimy nie publikować nic niż pewną siebie błędną liczbę. Z tego samego powodu każdy trend niesie własne p_value i flagę significant — przeczytaj je, zanim zacytujesz nachylenie.

Normy WMO#

Parametry

Norma to nie średnia z okresu, o który akurat poprosiłeś. To średnia trzydziestoletnia z okna ustalonego przez Światową Organizację Meteorologiczną, tak żeby dwie osoby cytujące normę cytowały to samo.

Jeśli chodzi ci o „normę z całego zapisu”, a nie z okna WMO, użyj raczej /v1/climate/summary — wymaga tylko scope'u climate i daje osiemdziesiąt siedem lat zamiast trzydziestu.

Porównanie dwóch norm#

To pytanie, które większość ludzi naprawdę zadaje, prosząc o normę — nie „co jest tu normalne”, ale „o ile normalne się przesunęło”.

Odpowiedź w jednym żądaniu gwarantuje, że obie połowy nie mogą pochodzić z różnych przebiegów, a to właśnie tryb awarii liczenia tego samemu z dwóch wywołań: archiwum posuwa się między nimi, a różnica, którą publikujesz, zawiera wtedy zmianę wersji obok zmiany klimatu.

Pokrycie, pola i komórki#

cells/resolve odpowiada na pytanie, które należałoby zadać każdemu produktowi siatkowemu, zanim się mu zaufa: którą komórkę tak naprawdę czytam i jak daleko jest od punktu, o który pytałem? Przy 28 km ta odległość może wynieść 20 km, a jej znajomość to różnica między zacytowaniem liczby a zacytowaniem jej odpowiedzialnie.

fields ma ten sam kontrakt co /v1/historical/variables: wypisuje, co zawiera przebieg, a nie co produkt kiedyś może zawierać, więc klient zbudowany na nim nie psuje się, gdy archiwum urośnie.