Derece-Gün API'si · ERA5-Land 9 km · 1950 →
Sizin taban sıcaklığınız. Taban 18 değil.
Denge noktası 15,5 °C olan bir bina, taban 18 derece-gün rakamını kullanamaz. Saatlik sıcaklığı saklıyor ve istediğiniz tabana karşı, istek anında integre ediyoruz — bu, üzerinden fatura kesebileceğiniz bir sayı ile özür dilemek zorunda kalacağınız bir sayı arasındaki farktır.
18.0
660
1 267
Cezayir · bir yıllık günlük ortalama sıcaklık Mavi ısıtma ihtiyacı Turuncu soğutma ihtiyacı
Boyalı alan derece-günün kendisidir. Tabanı sürükleyin ve iki toplamın yer değiştirmesini izleyin — bu takas, tabanın sizin olmasının bütün gerekçesidir. Bu şekil tarayıcınızda çalışabilmesi için günlük ortalama yöntemini kullanır; API saatlik seriyi integre eder ve taban 18'de bu toplamları yeniden üretir.
1950 →
76 yıl, saatlik. Uzman rakip 2000 yılında başlıyor.
4
Hesaplama yöntemi, çünkü kararı biz değil sözleşmeniz verir.
9 km
Izgara, karaların her yerinde — yakında istasyon gerekmez.
serbest
Taban sıcaklık, ondalıklar dâhil, istek anında çözülür.
Ücretsiz derece-gün verileri neden genellikle işe yaramaz
Taban
Taban 18 tek bir binanın yanıtıdır
Derece-günleri taban 18 için önceden hesaplamak bariz kestirmedir ve ücretsiz veri kümelerinin çoğunu ticari olarak işe yaramaz kılan şey budur. İç kazançları olan iyi yalıtılmış bir ofis 15 °C'ye daha yakın dengelenir; esintili bir depo 19'a. Taban 18 serisi verildiğinde ikisi de hiçbirini tarif etmeyen bir sayı alır.
Biz onun yerine saatlik sıcaklığı saklıyor ve integrasyonu siz istediğinizde yapıyoruz. Taban bir sorgu parametresidir.
Ortalama alma
Günlük ortalama günü gizler
8 °C'den 22 °C'ye salınan bir günün ortalaması 15 °C'dir. Taban 18'e karşı bu, ılıman ve ısıtma ihtiyacı düşük bir gün gibi görünür. Gerçekte bina bütün gece sıkı ısıttı ve öğleden sonra hiçbir şeye ihtiyaç duymadı.
Saatlik integrasyon bunu korur. Farklı bir sayıdır ve doğru olanıdır — sözleşmeniz başka bir şey söylemiyorsa; o zaman aşağıya bakın.
Dört yöntem, çünkü kararı sözleşmeniz verir
B2B anlaşmalarını bitiren ayrıntı budur. Saatlik integrasyonumuz fiziksel olarak en sadık olanıdır — ve sözleşmesi Costic üzerine yazılmış bir müşteri için işe yaramaz, çünkü rakamları tutmaz. Bu yüzden yöntem bir parametredir.
| method= | Isıtma 18 °C | Soğutma 18 °C | Ne zaman kullanılır |
|---|---|---|---|
hourly |
781.9 | 1331.6 | Varsayılan. Saatlik eksiği veya fazlayı integre eder — fiziksel olarak en sadık olanı. |
costic |
741.7 | 1349.5 | Fransız DJU unifiés. Fransız enerji performans sözleşmelerinde zorunlu. |
mean |
659.9 | 1267.8 | Tabana karşı günlük ortalama. Uluslararası en yaygın uzlaşım. |
eurostat |
587.7 | 656.6 | Avrupa istatistiği. Tabanlar tanım gereği sabittir ve base değerini yok sayar. |
Aynı veri, aynı taban, aynı yıl, aynı yer — ve birinci ile üçüncü satır arasında %18 fark. Size „derece-günler”i hangi yöntemle olduğunu söylemeden veren biri, uzlaştıramayacağınız bir sayı vermiştir. /v1/degree-days/compare-methods dördünü birden döndürür; böylece bir plana bağlanmadan önce sözleşmenizdeki rakamları yeniden üreten yöntemi bulursunuz.
Faturalarınızda görünen dört karar
Takvim
Yerel günler, UTC günleri değil
Derece-gün, binanın bulunduğu yerdeki takvim gününün bir özelliğidir. UTC'ye göre gruplamak her gecenin bir dilimini yanlış güne kaydırır ve aylık toplamları sessizce saptırır. Her istek konumun kaymasını alır ve buna göre gruplar; şehir uç noktaları kendi saat dilimini bilir.
Şehirler
Kentsel ısı adası, kalibre edilmiş
Yeniden analiz yapılı alanları 1–3 °C eksik okur; bu, soğutma derece-günlerini aşağı çeker — bir iklimlendirme boyutlandırıyorsanız belirleyicidir. Şehir uç noktaları, gerçek istasyon gözlemlerine karşı ölçülmüş bir kayma uygular: Cezayir +0,48 °C, Paris +1,13 °C.
Koordinat uç noktaları bunu uygulamaz ve bunu söyler.
Dönemler
Günlük, haftalık, aylık, yıllık
Aynı istekte dördü birden, çünkü sözleşmeler farklı dönemlerde uzlaşır. Haftalar ISO haftalarıdır; yani 1 Ocak 2023, 2022'nin 52. haftasında raporlanır — hesap tablonuz da böyle yapacaktır. Her kova kendi gün sayısını taşır, böylece bir aralığın kenarındaki eksik ay sessizce kısa kalmak yerine görünür olur.
Kalite
Kapsam ve neyin geçici olduğu
Her yanıt bir quality bloğu taşır: mevcut saatler, eksik olduğunda 1.0'ın altına düşen kapsam ve nihai yeniden analiz yerine tahminden doldurulmuş provisional_days sayısı — ERA5-Land yaklaşık beş gün gecikmeyle yayımlanır. Bir toplamın hangi kısmının henüz nihai olmadığını tam olarak görürsünüz.
Tek istek, on yıl, tek sayı
# Paris, 15,5 °C Britanya tabanı, on yıl, aylık satırlar
curl -H "X-API-Key: $API_KEY" \
"https://api.climatememory.com/v1/degree-days\
?lat=48.86&lon=2.35&base=uk&breakdown=monthly\
&start=2015-01-01&end=2024-12-31"
# Aynı bina, sözleşmesinin adını verdiği yöntemle
curl -H "X-API-Key: $API_KEY" \
"https://api.climatememory.com/v1/degree-days/city/fr/paris\
?base=18&method=costic&start=2024-01-01&end=2024-12-31"import httpx
# Bir portföyü iklime göre normalleştir: aynı taban, aynı yöntem, çok sayıda saha
def hdd(lat, lon, year, base=15.5, method="hourly"):
r = httpx.get(
"https://api.climatememory.com/v1/degree-days",
params={"lat": lat, "lon": lon, "base": base,
"method": method, "type": "HDD",
"start": f"{year}-01-01", "end": f"{year}-12-31"},
headers={"X-API-Key": API_KEY}, timeout=60,
)
r.raise_for_status()
return r.json()["totals"]["hdd"]
ratio = hdd(48.86, 2.35, 2024) / hdd(48.86, 2.35, 2023)
# tüketim %9 artı, derece-gün %11 artı -> bina iyileşti{
"location": { "latitude": 36.75, "longitude": 3.06,
"grid_cell": { "distance_km": 6.61, "resolution_km": 9 } },
"parameters": { "base_temperature_c": 18.0, "method": "hourly",
"start": "2025-07-01", "end": "2026-06-30" },
"totals": { "hdd": 781.86, "cdd": 1331.61 },
"quality": { "days": 365, "coverage": 1.0,
"missing_hours": 0, "provisional_days": 0 },
"breakdown": [ { "year": 2025, "month": 7, "hdd": 0.0,
"cdd": 289.4, "days": 31 } ]
}# Herhangi bir isteme format=csv ekleyin. Yalnızca ücretli planlar.
year,month,hdd,cdd,days,t_mean,coverage,provisional
2024,1,205.03,2.88,31,11.48,1.0,false
2024,2,168.44,4.10,29,12.31,1.0,false
2024,3,131.77,9.62,31,14.05,1.0,false
# Dosya adında yer ve tarihler bulunur, böylece altı ay sonra
# indirilenler klasöründe hâlâ tanınabilir.Bunu kim, ne için satın alır
Enerji performans sözleşmeleri
Havayı tartışmadan yılı kapatmak
Garantili tasarruf sözleşmesi „bina iyileşti” ile „kış ılıman geçti”yi ayırmak zorundadır. Sözleşmenin kendi tabanı ve yöntemiyle derece-günler, bu ayrımın yazıya döküldüğü yerdir — ve method=costic bir Fransız sözleşmesinin adını vereceği şeydir.
Portföy yönetimi
12 ülkede 400 binayı karşılaştırmak
Her saha kendi yerel takvimini, kendi ızgara hücresini ve şehirlerde kendi ısı adası düzeltmesini alır — tek taban ve tek yöntemle, böylece karşılaştırma bir şey ifade eder. Önce kontrol edilecek istasyon kapsamı yok.
HVAC boyutlandırma
Gerçek bir soğutma iklimine karşı soğutma yükü
Ekipmanın gerçekten dengelendiği tabanda soğutma derece-günleri; yeniden analiz ızgarasının en serin olduğu havaalanında değil, şehir merkezinde. Bunun 76 yılı, böylece tasarım yılı varsayılmak yerine seçilir.
Yazılım sağlayıcılar
Derece-günleri kendi ürününüzün içinde göndermek
Ticari yeniden dağıtım serbesttir. Sayıları enerji yönetim platformunuza, faturalama motorunuza veya ESG raporunuza koyun; bir satır kaynak gösterimi sizi izleyen tek yükümlülüktür.
Sayılar nereden geliyor
ERA5-Land, Copernicus yeniden analizi. Şimdiye dek özümsenmiş her gözlem üzerinde geriye doğru çalıştırılan bir fiziksel model; karaların her yerinde, 9 km ızgarada, 1950'den yaklaşık beş gün öncesine kadar saatlik bir sıcaklık alanı üretir.
Bu iş için neden bir istasyon kaydını yener. Bir meteoroloji istasyonu her taşınmayı, her cihaz değişimini ve geçmişindeki her boşluğu taşır; dolayısıyla tek bir istasyondan hesaplanan otuz yıllık eğilim, kısmen cihazın eğilimidir. Yeniden analizde bunların hiçbiri yoktur. Kapsam boşlukları da yoktur: en yakın istasyona 60 km uzaklıktaki bir saha, havaalanının yanındaki kadar iyi karşılanır.
Nerede daha zayıf. Yeniden analizin eksik okuduğu şehir merkezleri — şehir uç noktalarındaki kalibre düzeltme bu yüzden var. Ve nihai yeniden analiz gelene kadar geçici kalan son beş gün; yanıt bu günleri sizin için sayar.
Asıl mesele olan lisans. Copernicus, ERA5-Land'i CC-BY-4.0 ile yayımlar: ticari kullanım, yeniden dağıtım ve türev çalışmalar açıkça serbesttir. Bunu bir araştırma indirmesi değil, bir ürün yapan şey budur.
Sık sorulanlar
Derece-gün tam olarak nedir?
Dış sıcaklığın taban denen bir referansın ne kadar altında veya üstünde ve ne kadar süre kaldığının ölçüsü. Isıtma derece-günleri tabandan soğuk olunca, soğutma derece-günleri sıcak olunca birikir.
Bir binanın bu ocak ayında geçen yıla göre neden daha çok enerji tükettiğini, havayı davranışla karıştırmadan açıklamanın standart yoludur.
Herhangi bir taban sıcaklık kullanabilir miyim?
Ondalıklar dâhil herhangi bir değer. Adlandırılmış hazırlar da kabul edilir: uk (15,5 °C), ashrae (18,333 °C, yani 65 °F), iso, france ve eurostat (18 °C).
Isıtma ve soğutma için farklı tabanlar aynı istekte desteklenir, çünkü bir bina iki yönde nadiren aynı noktada dengelenir.
DJU unifiés / Costic destekliyor musunuz?
Evet — method=costic. Yalnızca günlük en düşük ve en yüksek değerleri, tabanı aşan günler için ampirik bir ağırlıkla kullanır; Fransız enerji performans sözleşmelerinin uzlaştığı şey budur.
Zaten rakamlarını bildiğiniz bir dönem üzerinde /v1/degree-days/compare-methods çalıştırın. Costic onları yeniden üretiyorsa Costic'i kullanın. Bu kontrol bir isteğe mal olur ve tartışmayı önler.
Arşiv ne kadar geriye gidiyor?
1 Ocak 1950'ye — 76 yıl, saatlik, dünya genelinde karada, 9 km ızgarada. Tek bir istek en fazla 10 yılı kapsayabilir; daha uzun geçmişler birkaç istektir.
Sahanın yakınında meteoroloji istasyonu gerekiyor mu?
Hayır. Izgara tabanlı yeniden analiz, 60 km içinde istasyonu olmayanlar dâhil her kara konumunu kapsar. Cihaz değişiklikleri ve geçmişte boşluklar bulunmamasıyla birlikte, istasyon tabanlı derece-gün sağlayıcılarına karşı başlıca üstünlüğü budur.
CSV veya Excel'e aktarabilir miyim?
Ücretli bir planda herhangi bir derece-gün isteğine format=csv ekleyin. Toplulaştırılmış satırları alırsınız — saatlik seriyi asla — JSON çağrısıyla aynı azami aralıkta, dört katı krediye.
Bu sınır isteksizlikten değil bilinçlidir: ödediğiniz şey arşivdir ve sınırsız dışa aktarım, bir rakibin onu bir öğleden sonrada elde etme yoludur. Biçimin var olmasını sağlayan şey bu sınırdır.
Maliyeti nedir?
Derece-günler ayda 19 €'luk Starter planından itibaren dâhildir: 50.000 kredi, hava durumu dâhil, CSV dâhil. Bir derece-gün isteği bir yıla kadar iki kredi, sonrasında her ek yıl için bir kredidir.
50.000 kredide bu, ayda kabaca 25.000 tek yıllık sorgu demektir — her gün sorgulanan birkaç yüz binalık bir portföye yeter.
Değerleri kendi ürünüm içinde yeniden satabilir miyim?
Evet. ERA5-Land, ticari kullanıma, yeniden dağıtıma ve türev çalışmalara izin veren CC-BY-4.0 ile yayımlanır. Verilerin göründüğü her yerde bir kaynak gösterimi satırı gösterin — /v1/attribution birebir metni döndürür ve anahtar istemez.
Elinizdeki rakamlara karşı doğrulayın
Onaylanmış rakamlara sahip olduğunuz bir yılı alın, compare-methods çalıştırın ve hangi yöntemin onları yeniden ürettiğini görün. Bunu satın almanın dürüst yolu budur.