İklim API'si

Günlük iklim#

Parametreler

Bu, saatlik geçmişin önüne bir GROUP BY konmuş hâli değildir. Günlük alanlar bir kez, veri alımı sırasında, kolaylığa göre değil fiziğe göre seçilmiş bir gün sınırında türetilir; türetilmiş alanlar — hissedilen sıcaklık, güneşlenme süresi, ortalama nem — günlük uç değerlerden değil, tam saatlik seriden hesaplanır.

Aylık toplulaştırmalar#

Birikimli büyüklükler için toplamlar, geri kalanı için ortalamalar ve uç değerler. Aynı sütunu okuduğu için günlük seriyle aynı fiyattır.

Asıl çizdiğiniz şey aylık bir değerse, otuz katı veriyi çekip kendiniz indirgemek yerine bunu isteyin — yavaş olan aktarımdır, aritmetik değil.

Bir yerin iklimi, tek çağrıda#

Parametreler

Bir iklim sayfasının bir konum hakkında söylediği her şey, önceden indirgenmiş hâlde: on iki aylık normal, her tam takvim yılı için bir satır, düştükleri tarihlerle birlikte tüm zamanların rekorları, anlamlılığıyla birlikte en küçük kareler ısınma eğilimi ve Köppen-Geiger kodu. Dünya'daki herhangi bir kara koordinatı için.

daily=true ile normals?daily=true aynı şey değildir

Ve fark tam da buradadır. Normaller uç noktası otuz yıllık bir WMO penceresi üzerinden ortalama alır; bu ise istediğiniz pencere üzerinden — varsayılan olarak arşivin tamamı üzerinden — ortalama alır.

"30 Temmuz için normalin 9,4 °C üstünde" demenin, iddianın arkasına otuz değil seksen yedi yıl koyarak söylenebilmesinin tek yolu budur. Her gün kendi örnek sayısını taşır; dolayısıyla on beş günlük merkezli bir normale genişletmek Σ(mean·samples) / Σ(samples) ile yazılır — kesin ve ikinci bir istek olmadan.

Başka bir kaynakla karşılaştırmadan önce bilinmesi gereken iki kural

Bir takvim yılı, ancak arşiv o yılın en az 360 gününü tutuyorsa yıllık seriye ve eğilime girer; dolayısıyla içinde bulunulan yıl dışarıda kalır. Yarım yıl, yağışta bir çöküş olarak okunur ve eğilim doğrusunu peşinden sürükler.

trends, on tam yılın altında null'dur. Bunun altında bir eğim, iklim sinyali kılığına girmiş hava gürültüsüdür ve kendinden emin yanlış bir sayı yayımlamaktansa hiçbir şey yayımlamamayı yeğleriz. Aynı nedenle her eğilim kendi p_value değerini ve significant bayrağını taşır — eğimi alıntılamadan önce onları okuyun.

WMO normalleri#

Parametreler

Normal, rastgele istediğiniz bir dönemin ortalaması değildir. Dünya Meteoroloji Örgütü'nün sabitlediği bir pencere üzerinden alınmış otuz yıllık bir ortalamadır; böylece bir normali alıntılayan iki kişi aynı şeyi alıntılamış olur.

İstediğiniz şey bir WMO penceresi üzerinden değil de "kaydın tamamı üzerinden normal" ise bunun yerine /v1/climate/summary'yi kullanın — yalnızca climate scope'unu ister ve size otuz yıl yerine seksen yedi yıl verir.

İki normali karşılaştırmak#

İnsanların çoğu bir normal isterken aslında bu soruyu sorar — "burada normal nedir" değil, "normal ne kadar kaydı".

Buna tek istekte yanıt vermek, iki yarının farklı koşulardan gelmesini olanaksız kılar; bunu iki çağrıyla kendiniz hesaplamanın arıza biçimi de tam budur: arşiv ikisi arasında ilerler ve yayımladığınız fark o zaman bir iklim değişikliğinin yanı sıra bir sürüm değişikliği de içerir.

Kapsama, alanlar ve hücreler#

cells/resolve, ızgara tabanlı her ürüne güvenilmeden önce sorulması gereken soruyu yanıtlar: aslında hangi hücreyi okuyorum ve o hücre sorduğum noktadan ne kadar uzakta? 28 km'de bu mesafe 20 km olabilir ve bunu bilmek, bir sayıyı alıntılamakla onu sorumluca alıntılamak arasındaki farktır.

fields, /v1/historical/variables ile aynı sözleşmeye sahiptir: ürünün bir gün neyi tutabileceğini değil, koşunun neyi tuttuğunu listeler; böylece ona göre yazılmış bir istemci, arşiv büyüdüğünde bozulmaz.