API Derajat-hari — derajat-hari pada basis apa pun, sejak 1950

Q: Apakah Anda mendukung DJU unifiés / Costic?

Ya — method=costic. Ia hanya memakai minimum dan maksimum harian dengan pembobotan empiris untuk hari yang melintasi basis, yang menjadi pegangan kontrak kinerja energi Prancis. Jalankan /v1/degree-days/compare-methods pada periode yang angkanya sudah Anda punya. Jika Costic menghasilkannya ulang, pakai Costic. Pemeriksaan itu berbiaya satu permintaan dan mencegah perdebatan.

Q: Bisakah saya mengekspor ke CSV atau Excel?

Tambahkan format=csv ke permintaan derajat-hari mana pun pada paket berbayar. Anda mendapat baris agregat — tidak pernah deret per jam — dengan rentang maksimum yang sama seperti panggilan JSON, dengan biaya empat kali kreditnya. Batas itu disengaja dan bukan setengah hati: arsip itulah yang Anda bayar, dan ekspor tanpa batas adalah cara pesaing memperolehnya dalam satu sore. Batas itulah yang membuat format ini bisa ada sama sekali.

Geser suhu basis

Basis °C

18.0

Pemanasan / tahun

660

Pendinginan / tahun

1 267

Aljir · satu tahun suhu rata-rata harian Biru kebutuhan pemanasan Jingga kebutuhan pendinginan

Area yang diarsir adalah derajat-harinya. Geser basisnya dan lihat kedua total bertukar tempat — pertukaran itulah seluruh alasan mengapa basisnya harus milik Anda. Gambar ini memakai metode rata-rata harian agar bisa berjalan di peramban Anda; API mengintegrasikan deret per jam dan menghasilkan ulang total ini pada basis 18.

1950 →

76 tahun, per jam. Pesaing spesialis mulai dari tahun 2000.

4

Metode perhitungan, karena kontrak Andalah yang memutuskan, bukan kami.

9 km

Kisi, di seluruh daratan — tidak perlu stasiun di dekatnya.

bebas

Suhu basis, termasuk pecahan, diselesaikan saat permintaan.

Mengapa data derajat-hari gratis biasanya tak terpakai

Basisnya

Basis 18 adalah jawaban satu gedung saja

Menghitung derajat-hari di muka pada basis 18 adalah jalan pintas yang jelas, dan itulah yang membuat sebagian besar kumpulan data gratis tak berguna secara komersial. Kantor berinsulasi baik dengan perolehan panas internal seimbang lebih dekat ke 15 °C; gudang yang bocor angin lebih dekat ke 19. Diberi deret basis 18, keduanya menerima angka yang tidak menggambarkan satu pun.

Kami justru menyimpan suhu per jam dan melakukan integrasinya saat Anda meminta. Basis adalah parameter kueri.

Perataannya

Rata-rata harian menyembunyikan harinya

Hari yang berayun dari 8 °C ke 22 °C punya rata-rata 15 °C. Terhadap basis 18 itu tampak seperti hari sejuk dengan kebutuhan pemanasan kecil. Nyatanya gedung itu memanaskan kuat sepanjang malam dan tak perlu apa-apa pada sore hari.

Integrasi per jam mempertahankan itu. Angkanya berbeda, dan itulah yang benar — kecuali kontrak Anda berkata lain, dan untuk itu lihat di bawah.

Empat metode, karena kontrak Andalah yang memutuskan

Inilah detail yang menutup kesepakatan B2B. Integrasi per jam kami paling setia secara fisis — dan tak berguna bagi pelanggan yang kontraknya ditulis atas Costic, karena angkanya tidak akan cocok. Maka metodenya adalah parameter.

Metode derajat-hari dibandingkan pada data yang sama, Aljir, basis 18 °C
method=	Pemanasan 18 °C	Pendinginan 18 °C	Kapan dipakai
`hourly`	781.9	1331.6	Bawaan. Mengintegrasikan defisit atau surplus per jam — paling setia secara fisis.
`costic`	741.7	1349.5	DJU unifiés Prancis. Diwajibkan oleh kontrak kinerja energi Prancis.
`mean`	659.9	1267.8	Rata-rata harian terhadap basis. Konvensi internasional yang paling luas dipakai.
`eurostat`	587.7	656.6	Statistik Eropa. Basisnya ditetapkan oleh definisi dan mengabaikan `base`.

Data sama, basis sama, tahun sama, tempat sama — dan selisih 18 % antara baris pertama dan ketiga. Siapa pun yang menyerahkan „derajat-hari” tanpa menyebut metodenya telah menyerahkan angka yang tak akan bisa Anda rekonsiliasi. /v1/degree-days/compare-methods mengembalikan keempatnya sekaligus, sehingga Anda menemukan yang menghasilkan ulang angka yang sudah ada di kontrak Anda sebelum berkomitmen pada sebuah paket.

Empat keputusan yang muncul di tagihan Anda

Kalender

Hari lokal, bukan hari UTC

Derajat-hari adalah sifat sebuah hari kalender di tempat gedung itu berada. Mengelompokkan menurut UTC memindahkan seiris tiap malam ke hari yang salah dan diam-diam membiaskan total bulanan. Setiap permintaan mengambil pergeseran lokasi dan mengelompokkan sesuai itu; titik akhir kota tahu zona waktunya sendiri.

Kota

Pulau panas perkotaan, terkalibrasi

Reanalisis membaca kawasan terbangun terlalu rendah sebesar 1–3 °C, yang menekan derajat-hari pendinginan — menentukan jika Anda menghitung kapasitas pendingin udara. Titik akhir kota menerapkan pergeseran yang diukur terhadap pengamatan stasiun nyata: Aljir +0,48 °C, Paris +1,13 °C.

Titik akhir berbasis koordinat tidak menerapkannya, dan menyatakannya.

Periode

Harian, mingguan, bulanan, tahunan

Keempatnya dalam permintaan yang sama, karena kontrak menetapkan periode yang berbeda-beda. Minggu memakai minggu ISO, jadi 1 Januari 2023 dilaporkan pada minggu 52 tahun 2022 — yang juga akan dilakukan lembar kerja Anda. Setiap keranjang membawa jumlah harinya, sehingga bulan yang terpotong di tepi rentang terlihat, bukan diam-diam pendek.

Kualitas

Cakupan, dan apa yang masih sementara

Setiap respons membawa blok quality: jam yang ada, cakupan di bawah 1.0 saat ada yang hilang, dan jumlah provisional_days yang diisi dari prakiraan alih-alih reanalisis final — ERA5-Land terbit dengan jeda sekitar lima hari. Anda melihat persis bagian mana dari sebuah total yang belum final.

Satu permintaan, sepuluh tahun, satu angka

GET /v1/degree-days?lat=&lon=&base=&method=&start=&end=

# Paris, basis Britania 15,5 °C, sepuluh tahun, baris bulanan
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"

# Gedung yang sama, dengan metode yang disebut kontraknya
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

# Normalisasi portofolio terhadap cuaca: basis sama, metode sama, banyak lokasi
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)
# konsumsi +9 %, derajat-hari +11 % -> gedungnya membaik

{
  "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 } ]
}

# Tambahkan format=csv ke permintaan mana pun. Hanya paket berbayar.
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

# Berkasnya dinamai menurut lokasi dan tanggal, jadi tetap
# dikenali enam bulan kemudian di folder unduhan.

Siapa yang membeli ini, dan untuk apa

Kontrak kinerja energi

Menutup tahun tanpa berdebat soal cuaca

Kontrak dengan jaminan penghematan harus memisahkan „gedungnya membaik” dari „musim dinginnya sejuk”. Derajat-hari pada basis dan metode kontrak itu sendiri adalah cara pemisahan itu dituliskan — dan method=costic adalah yang akan disebut kontrak Prancis.

Manajemen portofolio

Membandingkan 400 gedung di 12 negara

Setiap lokasi mendapat kalender lokalnya, selnya sendiri, dan di kota koreksi pulau panasnya sendiri — pada satu basis dan satu metode, agar perbandingannya bermakna. Tidak ada cakupan stasiun yang perlu diperiksa lebih dulu.

Penentuan kapasitas HVAC

Beban pendinginan terhadap iklim pendinginan yang nyata

Derajat-hari pendinginan pada basis tempat peralatan benar-benar seimbang, di pusat kota alih-alih di bandara tempat kisi reanalisis paling sejuk. Tersedia 76 tahun, sehingga tahun rancangan dipilih alih-alih diandaikan.

Vendor perangkat lunak

Mengirim derajat-hari di dalam produk Anda sendiri

Redistribusi komersial diizinkan. Taruh angkanya di platform manajemen energi, mesin penagihan, atau laporan ESG Anda; satu baris atribusi adalah satu-satunya kewajiban yang mengikuti Anda.

Dari mana angkanya berasal

ERA5-Land, reanalisis Copernicus. Model fisis yang dijalankan mundur atas setiap pengamatan yang pernah diasimilasi, menghasilkan medan suhu per jam pada kisi 9 km, di seluruh daratan, dari 1950 sampai sekitar lima hari lalu.

Mengapa itu mengalahkan rekaman stasiun untuk pekerjaan ini. Stasiun cuaca membawa setiap perpindahan, setiap pergantian alat dan setiap celah dalam sejarahnya, sehingga tren tiga puluh tahun yang dihitung dari satu stasiun sebagian adalah tren instrumentasinya. Reanalisis tidak punya itu semua. Ia juga tak punya lubang cakupan: lokasi 60 km dari stasiun terdekat dilayani persis sebaik lokasi di sebelah bandara.

Di mana ia lebih lemah. Pusat kota, yang dibaca terlalu rendah oleh reanalisis — karena itu ada koreksi terkalibrasi pada titik akhir kota. Dan lima hari terakhir, yang bersifat sementara sampai reanalisis final tiba; responsnya menghitung hari-hari itu untuk Anda.

Lisensinya, dan itulah intinya. Copernicus menerbitkan ERA5-Land di bawah CC-BY-4.0: penggunaan komersial, redistribusi dan karya turunan semuanya diizinkan secara tegas. Itulah yang menjadikan ini produk alih-alih unduhan riset.

Pertanyaan umum

Apa persisnya derajat-hari itu?

Ukuran seberapa jauh, dan berapa lama, suhu luar berada di bawah atau di atas sebuah acuan yang disebut basis. Derajat-hari pemanasan menumpuk saat lebih dingin dari basis, derajat-hari pendinginan saat lebih hangat.

Ia adalah cara baku menjelaskan mengapa sebuah gedung memakai lebih banyak energi pada Januari ini daripada Januari lalu, tanpa mencampuradukkan cuaca dengan perilaku.

Bisakah saya memakai suhu basis apa pun?

Nilai apa pun, termasuk pecahan. Prasetel bernama juga diterima: uk (15,5 °C), ashrae (18,333 °C, yaitu 65 °F), iso, france dan eurostat (18 °C).

Basis berbeda untuk pemanasan dan pendinginan didukung dalam permintaan yang sama, karena sebuah gedung jarang seimbang pada titik yang sama di kedua arah.

Apakah Anda mendukung DJU unifiés / Costic?

Ya — method=costic. Ia hanya memakai minimum dan maksimum harian dengan pembobotan empiris untuk hari yang melintasi basis, yang menjadi pegangan kontrak kinerja energi Prancis.

Jalankan /v1/degree-days/compare-methods pada periode yang angkanya sudah Anda punya. Jika Costic menghasilkannya ulang, pakai Costic. Pemeriksaan itu berbiaya satu permintaan dan mencegah perdebatan.

Sejauh apa arsipnya ke belakang?

Sampai 1 Januari 1950 — 76 tahun, per jam, di seluruh dunia pada daratan, pada kisi 9 km. Satu permintaan boleh mencakup hingga 10 tahun; riwayat lebih panjang berarti beberapa permintaan.

Apakah saya perlu stasiun cuaca dekat lokasi?

Tidak. Reanalisis berbasis kisi mencakup setiap lokasi daratan, termasuk yang tanpa stasiun dalam radius 60 km. Itulah keunggulan utamanya atas penyedia derajat-hari berbasis stasiun, di samping tidak adanya pergantian alat atau celah dalam sejarahnya.

Bisakah saya mengekspor ke CSV atau Excel?

Tambahkan format=csv ke permintaan derajat-hari mana pun pada paket berbayar. Anda mendapat baris agregat — tidak pernah deret per jam — dengan rentang maksimum yang sama seperti panggilan JSON, dengan biaya empat kali kreditnya.

Batas itu disengaja dan bukan setengah hati: arsip itulah yang Anda bayar, dan ekspor tanpa batas adalah cara pesaing memperolehnya dalam satu sore. Batas itulah yang membuat format ini bisa ada sama sekali.

Berapa biayanya?

Derajat-hari sudah termasuk sejak paket Starter seharga 19 € per bulan: 50.000 kredit, cuaca termasuk, CSV termasuk. Satu permintaan derajat-hari berbiaya dua kredit sampai satu tahun, ditambah satu untuk tiap tahun berikutnya.

Pada 50.000 kredit itu kira-kira 25.000 pencarian satu tahun per bulan — cukup untuk portofolio beberapa ratus gedung yang ditanya setiap hari.

Harga lengkap →

Bisakah saya menjual kembali nilainya di dalam produk saya?

Bisa. ERA5-Land diterbitkan di bawah CC-BY-4.0, yang mengizinkan penggunaan komersial, redistribusi dan karya turunan. Tampilkan satu baris atribusi di mana pun datanya muncul — /v1/attribution mengembalikan kalimat persisnya dan tidak butuh kunci.

Uji terhadap angka yang sudah Anda punya

Ambil satu tahun yang angkanya sudah disahkan, jalankan compare-methods, dan lihat metode mana yang menghasilkannya ulang. Itulah cara jujur membeli ini.

Mulai dengan Starter — 19 € Referensi derajat-hari

Suhu basis Anda. Bukan basis 18.