API Stopniodni · ERA5-Land 9 km · 1950 →
Twoja temperatura bazowa. Nie baza 18.
Budynek o punkcie równowagi 15,5 °C nie zrobi nic z liczbą stopniodni dla bazy 18. Trzymamy temperaturę godzinową i całkujemy ją względem bazy, o którą prosisz, w momencie zapytania — a to różnica między liczbą, na której możesz fakturować, a liczbą, za którą będziesz się tłumaczyć.
18.0
660
1 267
Algier · rok średniej dobowej temperatury Niebieski zapotrzebowanie na ogrzewanie Pomarańczowy zapotrzebowanie na chłodzenie
Wypełnione pole jest stopniodniem. Przeciągnij bazę i patrz, jak obie sumy zamieniają się miejscami — ta zamiana to cały powód, dla którego baza musi być twoja. Ten rysunek używa metody średniej dobowej, żeby dało się go policzyć w przeglądarce; API całkuje szereg godzinowy i odtwarza te sumy dla bazy 18.
1950 →
76 lat, godzinowo. Wyspecjalizowany konkurent zaczyna w 2000 roku.
4
Metody obliczeń, bo decyduje twoja umowa, a nie my.
9 km
Siatka, wszędzie na lądzie — żadna stacja w pobliżu nie jest potrzebna.
dowolna
Temperatura bazowa, z ułamkami, rozstrzygana przy zapytaniu.
Dlaczego darmowe stopniodni są zwykle bezużyteczne
Baza
Baza 18 to odpowiedź jednego budynku
Liczenie stopniodni z góry dla bazy 18 to oczywisty skrót i właśnie on czyni większość darmowych zbiorów bezużytecznymi komercyjnie. Dobrze ocieplone biuro z zyskami wewnętrznymi równoważy się bliżej 15 °C; nieszczelna hala bliżej 19. Otrzymawszy szereg dla bazy 18, oba dostają liczbę, która nie opisuje żadnego z nich.
My zamiast tego przechowujemy temperaturę godzinową i całkujemy, gdy poprosisz. Baza jest parametrem zapytania.
Uśrednianie
Średnia dobowa chowa dzień
Dzień, który przeszedł od 8 °C do 22 °C, ma średnią 15 °C. Przy bazie 18 wygląda to na łagodny dzień z niewielkim zapotrzebowaniem na ogrzewanie. W rzeczywistości budynek grzał mocno całą noc, a po południu nie potrzebował nic.
Całkowanie godzinowe to zachowuje. To inna liczba i to ta właściwa — chyba że twoja umowa mówi inaczej, o czym niżej.
Cztery metody, bo decyduje twoja umowa
To ten szczegół, który domyka transakcje B2B. Nasze całkowanie godzinowe jest fizycznie najwierniejsze — i bezużyteczne dla klienta, którego umowa jest napisana na Costic, bo jego liczby się nie zgodzą. Dlatego metoda jest parametrem.
| method= | Grzew. 18 °C | Chłodn. 18 °C | Kiedy stosować |
|---|---|---|---|
hourly |
781.9 | 1331.6 | Domyślna. Całkuje godzinowy niedobór lub nadmiar — fizycznie najwierniejsza. |
costic |
741.7 | 1349.5 | Francuskie DJU unifiés. Wymagane przez francuskie umowy o efekt energetyczny. |
mean |
659.9 | 1267.8 | Średnia dobowa względem bazy. Najbardziej rozpowszechniona konwencja międzynarodowa. |
eurostat |
587.7 | 656.6 | Statystyka europejska. Bazy są ustalone przez definicję i ignorują base. |
Te same dane, ta sama baza, ten sam rok, to samo miejsce — i 18 % różnicy między pierwszym a trzecim wierszem. Kto podaje ci „stopniodni” bez wskazania metody, podał ci liczbę, której nie uzgodnisz. /v1/degree-days/compare-methods zwraca wszystkie cztery naraz, żebyś znalazł tę, która odtwarza wartości już obecne w twojej umowie, zanim zwiążesz się planem.
Cztery decyzje, które widać na fakturach
Kalendarz
Dni lokalne, nie dni UTC
Stopniodzień jest własnością dnia kalendarzowego tam, gdzie stoi budynek. Grupowanie po UTC przesuwa kawałek każdej nocy do niewłaściwego dnia i po cichu zniekształca sumy miesięczne. Każde zapytanie bierze przesunięcie lokalizacji i grupuje odpowiednio; punkty miastowe znają własną strefę.
Miasta
Miejska wyspa ciepła, skalibrowana
Reanaliza zaniża tereny zabudowane o 1–3 °C, co obniża stopniodni chłodnicze — istotne, jeśli dobierasz klimatyzację. Punkty miastowe stosują przesunięcie zmierzone względem rzeczywistych obserwacji stacji: Algier +0,48 °C, Paryż +1,13 °C.
Punkty po współrzędnych go nie stosują i wprost o tym mówią.
Okresy
Dziennie, tygodniowo, miesięcznie, rocznie
Wszystkie cztery w tym samym zapytaniu, bo umowy ustalają różne. Tygodnie są tygodniami ISO, więc 1 stycznia 2023 raportujemy w tygodniu 52 roku 2022 — tak samo zrobi twój arkusz. Każdy kubełek niesie swoją liczbę dni, więc niepełny miesiąc na krawędzi zakresu jest widoczny, a nie po cichu krótszy.
Jakość
Pokrycie i to, co tymczasowe
Każda odpowiedź niesie blok quality: godziny obecne, pokrycie poniżej 1.0, gdy którychś brakuje, i liczbę provisional_days uzupełnionych z prognozy zamiast ostatecznej reanalizy — ERA5-Land ukazuje się z około pięciodniowym opóźnieniem. Widzisz dokładnie, która część sumy nie jest jeszcze ostateczna.
Jedno zapytanie, dziesięć lat, jedna liczba
# Paryż, baza brytyjska 15,5 °C, dziesięć lat, wiersze miesięczne
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"
# Ten sam budynek, metoda wskazana w jego umowie
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
# Normalizacja portfela względem klimatu: ta sama baza, ta sama metoda, wiele lokalizacji
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)
# zużycie +9 %, stopniodni +11 % -> budynek się poprawił{
"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 } ]
}# Dodaj format=csv do dowolnego zapytania. Tylko w planach płatnych.
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
# Plik ma w nazwie miejsce i daty, więc pozostaje
# rozpoznawalny sześć miesięcy później w folderze pobranych.Kto to kupuje i po co
Umowy o efekt energetyczny
Rozliczyć rok bez sporu o pogodę
Umowa z gwarancją oszczędności musi oddzielić „budynek się poprawił” od „zima była łagodna”. Stopniodni na bazie i metodzie samej umowy są sposobem, w jaki to rozdzielenie zostaje zapisane — a method=costic to to, co wskaże umowa francuska.
Zarządzanie portfelem
Porównać 400 budynków w 12 krajach
Każda lokalizacja dostaje własny kalendarz lokalny, własną komórkę siatki i, w miastach, własną korektę wyspy ciepła — na jednej bazie i jednej metodzie, żeby porównanie coś znaczyło. Żadnego pokrycia stacjami do sprawdzania na wstępie.
Dobór HVAC
Obciążenie chłodnicze wobec prawdziwego klimatu chłodzenia
Stopniodni chłodnicze na bazie, przy której urządzenie naprawdę się równoważy, w centrum miasta, a nie na lotnisku, gdzie siatka reanalizy jest najchłodniejsza. 76 lat tego, żeby rok projektowy był wybrany, a nie założony.
Dostawcy oprogramowania
Zabrać stopniodni do własnego produktu
Redystrybucja komercyjna jest dozwolona. Wstaw liczby do swojej platformy zarządzania energią, silnika rozliczeniowego albo raportu ESG; linijka atrybucji to jedyny obowiązek, który za tobą idzie.
Skąd biorą się liczby
ERA5-Land, reanaliza Copernicusa. Model fizyczny przeliczony wstecz po wszystkich kiedykolwiek zasymilowanych obserwacjach, dający godzinowe pole temperatury na siatce 9 km, wszędzie na lądzie, od 1950 roku do mniej więcej pięciu dni temu.
Dlaczego to bije szereg stacyjny w tym zadaniu. Stacja meteorologiczna niesie każdą przeprowadzkę, każdą zmianę przyrządu i każdą lukę swojej historii, więc trzydziestoletni trend policzony z jednej stacji jest po części trendem aparatury. Reanaliza nie ma nic z tego. Nie ma też dziur w pokryciu: lokalizacja 60 km od najbliższej stacji jest obsłużona dokładnie tak samo dobrze jak ta obok lotniska.
Gdzie jest słabsza. Centra miast, które reanaliza zaniża — stąd skalibrowana korekta w punktach miastowych. I ostatnie pięć dni, tymczasowe do czasu nadejścia ostatecznej reanalizy; odpowiedź liczy te dni za ciebie.
Licencja, o którą tu chodzi. Copernicus publikuje ERA5-Land na CC-BY-4.0: użycie komercyjne, redystrybucja i dzieła pochodne są wprost dozwolone. To czyni z tego produkt, a nie pobranie do badań.
Częste pytania
Czym dokładnie jest stopniodzień?
Miarą tego, jak bardzo i jak długo temperatura zewnętrzna była poniżej lub powyżej odniesienia zwanego bazą. Stopniodni grzewcze narastają, gdy jest zimniej niż baza, chłodnicze, gdy jest cieplej.
To standardowy sposób wyjaśnienia, dlaczego budynek zużył w tym styczniu więcej energii niż w poprzednim, bez mylenia pogody z zachowaniem.
Czy mogę użyć dowolnej temperatury bazowej?
Dowolnej wartości, z ułamkami. Akceptowane są też nazwane ustawienia: uk (15,5 °C), ashrae (18,333 °C, czyli 65 °F), iso, france i eurostat (18 °C).
Różne bazy dla ogrzewania i chłodzenia są obsługiwane w tym samym zapytaniu, bo budynek rzadko równoważy się w tym samym punkcie w obie strony.
Czy obsługujecie DJU unifiés / Costic?
Tak — method=costic. Używa tylko minimum i maksimum dobowego z empirycznym ważeniem dni przekraczających bazę, na czym opierają się francuskie umowy o efekt energetyczny.
Uruchom /v1/degree-days/compare-methods na okresie, dla którego masz już liczby. Jeśli Costic je odtwarza, użyj Costic. Ta kontrola kosztuje jedno zapytanie i oszczędza sporu.
Jak daleko sięga archiwum?
Do 1 stycznia 1950 roku — 76 lat, godzinowo, na całym świecie na lądzie, na siatce 9 km. Jedno zapytanie może obejmować do 10 lat; dłuższe historie to kilka zapytań.
Czy potrzebuję stacji meteorologicznej blisko obiektu?
Nie. Reanaliza siatkowa pokrywa każdą lokalizację lądową, w tym takie bez stacji w promieniu 60 km. To jej główna przewaga nad dostawcami stopniodni opartymi na stacjach, obok braku zmian przyrządów i luk w historii.
Czy mogę wyeksportować do CSV lub Excela?
Dodaj format=csv do dowolnego zapytania o stopniodni w planie płatnym. Dostajesz wiersze zagregowane — nigdy szeregu godzinowego — z tym samym maksymalnym zakresem co wywołanie JSON, za czterokrotność kredytów.
To ograniczenie jest zamierzone, a nie niechętne: archiwum jest tym, za co płacisz, a nieograniczony eksport to sposób, w jaki konkurent zdobywa je w jedno popołudnie. To ograniczenie pozwala temu formatowi w ogóle istnieć.
Ile to kosztuje?
Stopniodni są zawarte od planu Starter za 19 € miesięcznie: 50 000 kredytów, pogoda w cenie, CSV w cenie. Zapytanie o stopniodni kosztuje dwa kredyty do roku, plus jeden za każdy kolejny rok.
Przy 50 000 kredytów to około 25 000 zapytań rocznych miesięcznie — dość dla portfela kilkuset budynków odpytywanego codziennie.
Czy mogę odsprzedawać te wartości we własnym produkcie?
Tak. ERA5-Land jest publikowana na CC-BY-4.0, która dopuszcza użycie komercyjne, redystrybucję i dzieła pochodne. Pokaż linijkę atrybucji wszędzie tam, gdzie dane się pojawiają — /v1/attribution zwraca dokładne brzmienie i nie wymaga klucza.
Sprawdź to na liczbach, które już masz
Weź rok, dla którego masz zatwierdzone liczby, uruchom compare-methods i zobacz, która metoda je odtwarza. To uczciwy sposób kupowania tego.