API Iklim

Iklim harian#

Parameter

Ini bukan riwayat per jam yang diberi GROUP BY di depannya. Field harian diturunkan sekali saja, saat pencernaan data, pada batas hari yang dipilih demi fisika alih-alih demi kepraktisan, dan field turunan — suhu terasa, lama penyinaran matahari, kelembapan rata-rata — dihitung dari deret per jam yang utuh, bukan dari nilai ekstrem harian.

Agregat bulanan#

Jumlah untuk besaran akumulatif, rata-rata dan nilai ekstrem untuk sisanya. Harganya sama dengan deret harian, karena membaca kolom yang sama.

Mintalah ini bila yang benar-benar Anda gambar adalah angka bulanan, alih-alih mengambil tiga puluh kali lipat datanya lalu meringkasnya sendiri — yang lambat adalah transfernya, bukan aritmetikanya.

Iklim sebuah tempat, dalam satu panggilan#

Parameter

Semua yang dinyatakan sebuah halaman iklim tentang suatu lokasi, sudah diringkas: dua belas normal bulanan, satu baris per tahun kalender penuh, rekor sepanjang masa beserta tanggal terjadinya, tren pemanasan kuadrat terkecil beserta signifikansinya, dan kode Köppen-Geiger. Untuk koordinat daratan mana pun di Bumi.

daily=true tidak sama dengan normals?daily=true

Dan justru di situlah bedanya. Endpoint normal merata-ratakan pada jendela WMO tiga puluh tahun; yang ini merata-ratakan pada jendela yang Anda minta — seluruh arsip secara bawaan.

Inilah satu-satunya cara mengatakan "9,4 °C di atas normal untuk sebuah 30 Juli" dengan delapan puluh tujuh tahun di belakang pernyataan itu, bukan tiga puluh. Setiap hari membawa jumlah sampelnya, jadi memperlebar ke normal terpusat lima belas hari ditulis Σ(mean·samples) / Σ(samples) — persis, dan tanpa permintaan kedua.

Dua konvensi yang perlu diketahui sebelum membandingkan dengan sumber lain

Sebuah tahun kalender hanya masuk ke deret tahunan dan ke tren jika arsip memuat setidaknya 360 harinya, sehingga tahun berjalan dikecualikan. Setengah tahun terbaca sebagai anjloknya curah hujan dan menyeret garis tren bersamanya.

trends bernilai null di bawah sepuluh tahun penuh. Di bawah itu, sebuah kemiringan hanyalah derau cuaca yang berpakaian sinyal iklim, dan kami lebih suka tidak menerbitkan apa pun daripada menerbitkan angka keliru dengan percaya diri. Karena alasan yang sama setiap tren membawa p_value sendiri dan penanda significant — bacalah keduanya sebelum mengutip kemiringannya.

Normal WMO#

Parameter

Normal bukanlah rata-rata dari periode yang kebetulan Anda minta. Ia adalah rata-rata tiga puluh tahun pada jendela yang ditetapkan Organisasi Meteorologi Dunia, sehingga dua orang yang mengutip sebuah normal mengutip hal yang sama.

Jika yang Anda inginkan adalah "normal atas seluruh rekaman" alih-alih atas jendela WMO, pakailah /v1/climate/summary — ia hanya butuh scope climate dan memberi Anda delapan puluh tujuh tahun alih-alih tiga puluh.

Membandingkan dua normal#

Inilah pertanyaan yang sebenarnya diajukan kebanyakan orang ketika mereka meminta sebuah normal — bukan "apa yang normal di sini" melainkan "seberapa jauh yang normal itu bergeser".

Menjawabnya dalam satu permintaan berarti kedua paruhnya tidak mungkin berasal dari run yang berbeda, dan itulah mode kegagalan menghitungnya sendiri dari dua panggilan: arsipnya maju di antara keduanya, dan selisih yang Anda terbitkan lalu memuat perubahan versi selain perubahan iklim.

Cakupan, field, dan sel#

cells/resolve menjawab pertanyaan yang seharusnya diajukan kepada setiap produk bergrid sebelum ia dipercaya: sel mana yang sebenarnya saya baca, dan seberapa jauh sel itu dari titik yang saya tanyakan? Pada 28 km jarak itu bisa mencapai 20 km, dan mengetahuinya adalah beda antara mengutip sebuah angka dan mengutipnya dengan bertanggung jawab.

fields punya kontrak yang sama dengan /v1/historical/variables: ia menampilkan apa yang dimuat run, bukan apa yang mungkin suatu hari dimuat produknya, sehingga klien yang dibangun berdasarkan itu tidak rusak ketika arsipnya bertambah.