Dokumentacja API
Trzy API na jednym kluczu. Zacznij od pierwszej karty, jeśli nie wykonałeś jeszcze żadnego wywołania; pozostałe trzy to dokumentacja endpointów, rozdzielona według produktu, aby każda pozostała przeszukiwalna osobno.
Adresy bazowe. Pogoda i Klimat są serwowane z https://api.climatememory.com, Stopniodni z https://api.climatememory.com. Uwierzytelniaj się nagłówkiem X-API-Key przy każdym żądaniu; każdy endpoint to GET.
Zacznij tutaj
Wykonaj pierwsze wywołanie API Climate Memory w mniej niż minutę: odbierz klucz, uwierzytelnij się, zrozum kredyty i limity tempa oraz obsłuż błędy. Pogoda, stopniodni i klimat na jednym kluczu.
11 sekcji →API Pogoda
Pełna dokumentacja API Pogoda: prognoza i warunki bieżące dla dowolnej współrzędnej lub miasta, każde pole ze swoją jednostką, kaskada modeli od 1,3 km do 28 km, a do tego ensemble, jakość powietrza, śnieg, morze i rzeki.
10 sekcji →API Stopniodni
Pełna dokumentacja API Stopniodni: stopniodni grzania i chłodzenia z ERA5-Land od 1950 roku, dowolna temperatura bazowa, cztery metody obliczeń łącznie z francuską normą Costic, eksport CSV i archiwum godzinowe.
12 sekcji →API Klimat
Pełna dokumentacja API Klimat: 87 lat klimatu dobowego dla każdego lądowego punktu Ziemi od 1940 roku, agregaty miesięczne, normy WMO 1991–2020 i 1961–1990, rekordy, trendy ocieplenia i klasyfikacja Köppena-Geigera, na siatce ERA5.
6 sekcji →Wszystkie endpointy
Jedna tabela, wszystkie ścieżki na obu hostach, wraz z ceną i miejscem, gdzie są opisane. Ctrl+F tutaj albo /, aby otworzyć paletę wyszukiwania.
| Ścieżka | Do czego służy | Scope | Kredyty | Opisane w | Host |
|---|---|---|---|---|---|
/v1/geocode | Zamienia nazwę miejsca na współrzędne, wysokość i strefę czasową. | dowolny klucz | 0 | Geokodowanie | api.climatememory.com |
/v1/cities/search | Starsze wyszukiwanie nazw. Dopasowuje tylko nazwę ASCII i porządkuje według ludności. | dowolny klucz | 0 | Wyszukiwanie miast | api.climatememory.com |
/v1/cities/nearest | Najbliższe skatalogowane miasto dla współrzędnej. | dowolny klucz | 0 | Wyszukiwanie miast | api.climatememory.com |
/v1/attribution | Dokładnie wymagane brzmienie, czytelne maszynowo. Klucz niepotrzebny. | — | 0 | Atrybucja i licencje | api.climatememory.com |
/v1/licensing | Tabela licencji stojących za każdym zbiorem danych. Klucz niepotrzebny. | — | 0 | Atrybucja i licencje | api.climatememory.com |
/v1/forecast | Prognoza godzinowa i dobowa dla dowolnej współrzędnej. | meteo | 1 | Prognoza | api.climatememory.com |
/v1/forecast/city/{country}/{slug} | Ta sama odpowiedź, rozwiązana przez katalog miast. | meteo | 1 | Prognoza dla miasta | api.climatememory.com |
/v1/current | Warunki w tej chwili dla współrzędnej, interpolowane między krokami modelu. | meteo | 1 | Warunki bieżące | api.climatememory.com |
/v1/current/city/{country}/{slug} | To samo, przez katalog miast. | meteo | 1 | Warunki bieżące | api.climatememory.com |
/v1/fields | Ta sama tabela w JSON-ie, z jednostkami i informacją, które pola są domyślne. Klucz niepotrzebny. | — | 0 | Dokumentacja pól | api.climatememory.com |
/v1/models | Które modele są w użyciu, co każdy pokrywa i jak świeży jest. Klucz niepotrzebny. | — | 0 | Modele i rozdzielczość | api.climatememory.com |
/v1/probability | Percentyle i prawdopodobieństwa deszczu z 51-członowego ensemble'u ECMWF. | meteo | 1 | Prawdopodobieństwa z ensemble'u | api.climatememory.com |
/v1/air-quality | Pyły zawieszone, ozon, NO₂, SO₂, CO i pył saharyjski, z Copernicus CAMS. | meteo | 1 | Jakość powietrza | api.climatememory.com |
/v1/marine | Wysokość, kierunek i okres fali z modelu falowego ECMWF, na całym świecie, do 10 dni. | meteo | 1 | Morze — stan morza | api.climatememory.com |
/v1/hydrology | Przepływ rzek z Copernicus GloFAS na sieci rzecznej 0,05°, do 10 dni. | meteo | 1 | Rzeki | api.climatememory.com |
/v1/degree-days | Stopniodni grzania i chłodzenia dla współrzędnej. | dju | 2, +1 za każdy pełny okres 365,25 dni w zakresie | Stopniodni | api.climatememory.com |
/v1/degree-days?base=15,15.5,18,18.5,20 | Do 60 temperatur bazowych w jednym wywołaniu, w cenie jednej. | dju | same as one base | Wiele baz, jedno żądanie, jedna cena | api.climatememory.com |
/v1/degree-days/compare-methods | Wszystkie cztery metody na tym samym okresie, obok siebie. | dju | 2, +1 za każdy pełny okres 365,25 dni w zakresie | Metody obliczeń | api.climatememory.com |
/v1/methods | Definicje metod i ich nastawy. Klucz niepotrzebny. | — | 0 | Metody obliczeń | api.climatememory.com |
/v1/degree-days/city/{country}/{slug} | To samo, ze strefą czasową miasta i jego poprawką na miejską wyspę ciepła. | dju | 2, +1 za każdy pełny okres 365,25 dni w zakresie | Stopniodni dla miasta | api.climatememory.com |
/v1/degree-days?elevation={metres} | Korekta gradientowa z wysokości terenu komórki na twoją. | dju | same | Stopniodni dla twojego budynku, a nie dla komórki siatki | api.climatememory.com |
/v1/cells/resolve | Która komórka odpowiedziałaby za punkt i jak daleko leży. | dju | 1 | Przypięcie komórki, żeby punkt odniesienia pozostał porównywalny | api.climatememory.com |
/v1/degree-days/cell/{cell_id} | Stopniodni dla nazwanej komórki — bez szukania najbliższej komórki, nigdy. | dju | 2, +1 za każdy pełny okres 365,25 dni w zakresie | Przypięcie komórki, żeby punkt odniesienia pozostał porównywalny | api.climatememory.com |
/v1/degree-days?breakdown={daily|weekly|monthly|yearly} | Zagreguj to samo żądanie do okresu, na którym rozlicza się twoja umowa. | dju | same | Okresy podziału | api.climatememory.com |
/v1/degree-days/monthly | Dwanaście sum miesięcznych dla jednego roku kalendarzowego, bez szeregu dobowego. | dju | 2 | Sumy miesięczne dla roku | api.climatememory.com |
/v1/coverage | Co zawiera archiwum: pierwszy i ostatni dzień z danymi oraz oś, w którą będzie rosło. Klucz niepotrzebny. | — | 0 | Sumy miesięczne dla roku | api.climatememory.com |
/v1/degree-days?format=csv | Wiersze podziału jako plik CSV. Tylko plany płatne. | dju | 4× the JSON call | Eksport CSV | api.climatememory.com |
/v1/historical | Archiwum reanalizy serwowane surowo: pogoda godzinowa od 1950 roku. | dju | (years + 1) × (variables ÷ 2), rounded down, min 1 | Historia godzinowa | api.climatememory.com |
/v1/historical/city/{country}/{slug} | Identycznie, ze strefą czasową miasta i poprawką na wyspę ciepła. | dju | (years + 1) × (variables ÷ 2), rounded down, min 1 | Historia dla miasta | api.climatememory.com |
/v1/historical/variables | Co archiwum zawiera w tej chwili, z jednostkami, i które pola są wyprowadzane. Klucz niepotrzebny. | — | 0 | Dostępne zmienne | api.climatememory.com |
/v1/climate/daily | Trzynaście pól dobowych dla dowolnej lądowej współrzędnej, od 1940 roku po zeszły tydzień. | climate | 2, +1 za każdy pełny okres 365,25 dni w zakresie | Klimat dobowy | api.climatememory.com |
/v1/climate/monthly | Te same pola zagregowane po miesiącach kalendarzowych. | climate | 2, +1 za każdy pełny okres 365,25 dni w zakresie | Agregaty miesięczne | api.climatememory.com |
/v1/climate/summary | Normy miesięczne, szereg roczny, rekordy, trendy i Köppen — bez limitu zakresu. | climate | 3, +1 za każdy pełny okres 365,25 dni w zakresie | Klimat miejsca, w jednym wywołaniu | api.climatememory.com |
/v1/climate/normals | Trzydziestoletnia średnia z okresu referencyjnego WMO. | normals | 3 | Normy WMO | api.climatememory.com |
/v1/climate/normals/compare | Oba okresy WMO i zmiana między nimi, w jednym wywołaniu. | normals | 6 | Porównanie dwóch norm | api.climatememory.com |
/v1/climate/coverage | Serwowany przebieg i daty, które obejmuje. Klucz niepotrzebny. | — | 1 | Pokrycie, pola i komórki | api.climatememory.com |
/v1/climate/fields | Na co ten przebieg potrafi odpowiedzieć, z jednostkami, i które pola są wyprowadzane. Klucz niepotrzebny. | — | 1 | Pokrycie, pola i komórki | api.climatememory.com |
/v1/climate/cells/resolve | Która komórka odpowiada za punkt i jak daleko leży. | climate | 1 | Pokrycie, pola i komórki | api.climatememory.com |
/v1/climate/licensing | Warunki licencji tego archiwum. Klucz niepotrzebny. | — | 0 | Pokrycie, pola i komórki | api.climatememory.com |
Dla agentów i asystentów kodu
Dwa pliki, generowane z tego samego źródła co te strony, więc nie mogą rozejść się z tym, co czytasz:
- /llms.txt — krótkie wprowadzenie: na co odpowiada każdy produkt i kiedy sięgnąć po który.
- /llms-full.txt — cała ta dokumentacja w jednym pliku Markdown, ze wszystkimi endpointami, parametrami i zastrzeżeniami.
Każda usługa publikuje też schemat OpenAPI 3.1 i przeglądarkowy interfejs: /v1/openapi-weather.json i /v1/docs/weather, /v1/openapi-degree-days.json i /v1/docs/degree-days, /v1/openapi-climate.json i /v1/docs/climate, /v1/openapi-geocoding.json i /v1/docs/geocoding. Wygeneruj z nich typowanego klienta w dowolnym języku, zamiast pisać go ręcznie.