Référence de l'API
Trois API sur une seule clé. Commencez par la première carte si vous n'avez pas encore fait d'appel ; les trois autres sont la référence des endpoints, séparée par produit pour que chacune reste consultable seule.
URL de base. Météo et Climat sont servies depuis https://api.climatememory.com, les Degrés-jours depuis https://api.climatememory.com. Authentifiez-vous avec un en-tête X-API-Key à chaque requête ; tous les endpoints sont en GET.
Démarrer
Faites votre premier appel à l'API Climate Memory en moins d'une minute : obtenir une clé, s'authentifier, comprendre les crédits et les plafonds de débit, et traiter les erreurs. Météo, degrés-jours et climat sur une seule clé.
11 sections →API Météo
Référence complète de l'API Météo : prévision et conditions actuelles pour toute coordonnée ou ville, chaque champ avec son unité, la cascade de modèles de 1,3 km à 28 km, plus les ensembles, la qualité de l'air, la neige, la mer et les rivières.
10 sections →API Degrés-jours
Référence complète de l'API Degrés-jours : degrés-jours de chauffage et de refroidissement depuis ERA5-Land jusqu'à 1950, toute température de base, quatre méthodes de calcul dont le standard français Costic, export CSV et archive horaire.
12 sections →API Climat
Référence complète de l'API Climat : 87 ans de climat quotidien pour chaque point terrestre du globe depuis 1940, agrégats mensuels, normales OMM 1991–2020 et 1961–1990, records, tendances au réchauffement et Köppen-Geiger, sur la grille ERA5.
6 sections →Tous les endpoints
Un seul tableau, tous les chemins des deux hôtes, avec leur coût et l'endroit où ils sont documentés. Ctrl+F ici, ou / pour la palette de recherche.
| Chemin | Rôle | Scope | Crédits | Documenté dans | Hôte |
|---|---|---|---|---|---|
/v1/geocode | Résoudre un nom de lieu en coordonnées, altitude et fuseau horaire. | toute clé | 0 | Géocodage | api.climatememory.com |
/v1/cities/search | Ancienne recherche par nom. Ne compare que le nom ASCII, trie par population. | toute clé | 0 | Recherche de ville | api.climatememory.com |
/v1/cities/nearest | La ville cataloguée la plus proche d'une coordonnée. | toute clé | 0 | Recherche de ville | api.climatememory.com |
/v1/attribution | Le libellé exact requis, lisible par une machine. Aucune clé nécessaire. | — | 0 | Attribution et licences | api.climatememory.com |
/v1/licensing | Le tableau des licences derrière chaque jeu de données. Aucune clé nécessaire. | — | 0 | Attribution et licences | api.climatememory.com |
/v1/forecast | Prévision horaire et quotidienne pour une coordonnée quelconque. | meteo | 1 | Prévision | api.climatememory.com |
/v1/forecast/city/{country}/{slug} | La même réponse, résolue via le catalogue de villes. | meteo | 1 | Prévision par ville | api.climatememory.com |
/v1/current | Les conditions à l'instant présent pour une coordonnée, interpolées entre deux pas de modèle. | meteo | 1 | Conditions actuelles | api.climatememory.com |
/v1/current/city/{country}/{slug} | Les mêmes, via le catalogue de villes. | meteo | 1 | Conditions actuelles | api.climatememory.com |
/v1/fields | Le même tableau en JSON, avec les unités et les champs renvoyés par défaut. Aucune clé nécessaire. | — | 0 | Référence des champs | api.climatememory.com |
/v1/models | Quels modèles sont en service, ce que chacun couvre, la fraîcheur de chacun. Aucune clé nécessaire. | — | 0 | Modèles et résolution | api.climatememory.com |
/v1/probability | Percentiles et probabilités de pluie depuis l'ensemble ECMWF à 51 membres. | meteo | 1 | Probabilités d'ensemble | api.climatememory.com |
/v1/air-quality | Particules, ozone, NO₂, SO₂, CO et poussière saharienne, depuis Copernicus CAMS. | meteo | 1 | Qualité de l'air | api.climatememory.com |
/v1/marine | Hauteur, direction et période des vagues depuis le modèle de vagues de l'ECMWF, dans le monde entier, jusqu'à 10 jours. | meteo | 1 | Mer — état de la mer | api.climatememory.com |
/v1/hydrology | Débit des rivières depuis Copernicus GloFAS sur un réseau hydrographique à 0,05°, jusqu'à 10 jours. | meteo | 1 | Rivières | api.climatememory.com |
/v1/degree-days | Degrés-jours de chauffage et de refroidissement pour une coordonnée. | dju | 2, +1 par période complète de 365,25 jours dans l'amplitude | Degrés-jours | api.climatememory.com |
/v1/degree-days?base=15,15.5,18,18.5,20 | Jusqu'à 60 températures de base en un seul appel, au prix d'une. | dju | same as one base | Plusieurs bases, une requête, un seul prix | api.climatememory.com |
/v1/degree-days/compare-methods | Les quatre méthodes sur la même période, côte à côte. | dju | 2, +1 par période complète de 365,25 jours dans l'amplitude | Méthodes de calcul | api.climatememory.com |
/v1/methods | Les définitions des méthodes et leurs préréglages. Aucune clé nécessaire. | — | 0 | Méthodes de calcul | api.climatememory.com |
/v1/degree-days/city/{country}/{slug} | Les mêmes, avec le fuseau horaire de la ville et sa correction d'îlot de chaleur urbain. | dju | 2, +1 par période complète de 365,25 jours dans l'amplitude | Degrés-jours par ville | api.climatememory.com |
/v1/degree-days?elevation={metres} | Correction de gradient adiabatique, de l'altitude de la maille à la vôtre. | dju | same | Des degrés-jours pour votre bâtiment, pas pour la maille | api.climatememory.com |
/v1/cells/resolve | Quelle maille répondrait pour un point, et à quelle distance elle se trouve. | dju | 1 | Épingler une maille, pour qu'une base de référence reste comparable | api.climatememory.com |
/v1/degree-days/cell/{cell_id} | Degrés-jours pour une maille nommée — jamais de recherche de maille la plus proche. | dju | 2, +1 par période complète de 365,25 jours dans l'amplitude | Épingler une maille, pour qu'une base de référence reste comparable | api.climatememory.com |
/v1/degree-days?breakdown={daily|weekly|monthly|yearly} | Agréger la même requête à la période sur laquelle votre contrat se règle. | dju | same | Périodes de ventilation | api.climatememory.com |
/v1/degree-days/monthly | Douze totaux mensuels pour une année civile, sans série quotidienne. | dju | 2 | Totaux mensuels pour une année | api.climatememory.com |
/v1/coverage | Ce que contient l'archive : premier et dernier jour avec des données, et l'axe dans lequel elle va croître. Aucune clé nécessaire. | — | 0 | Totaux mensuels pour une année | api.climatememory.com |
/v1/degree-days?format=csv | Les lignes de ventilation en fichier CSV. Formules payantes uniquement. | dju | 4× the JSON call | Export CSV | api.climatememory.com |
/v1/historical | L'archive de réanalyse servie brute : météo horaire jusqu'à 1950. | dju | (years + 1) × (variables ÷ 2), rounded down, min 1 | Historique horaire | api.climatememory.com |
/v1/historical/city/{country}/{slug} | Identique, avec le fuseau horaire de la ville et sa correction d'îlot de chaleur. | dju | (years + 1) × (variables ÷ 2), rounded down, min 1 | Historique par ville | api.climatememory.com |
/v1/historical/variables | Ce que l'archive contient actuellement, avec les unités, et quels champs sont dérivés. Aucune clé nécessaire. | — | 0 | Variables disponibles | api.climatememory.com |
/v1/climate/daily | Treize champs quotidiens pour toute coordonnée terrestre, de 1940 à la semaine dernière. | climate | 2, +1 par période complète de 365,25 jours dans l'amplitude | Climat quotidien | api.climatememory.com |
/v1/climate/monthly | Les mêmes champs agrégés par mois calendaire. | climate | 2, +1 par période complète de 365,25 jours dans l'amplitude | Agrégats mensuels | api.climatememory.com |
/v1/climate/summary | Normales mensuelles, série annuelle, records, tendances et Köppen — sans limite d'amplitude. | climate | 3, +1 par période complète de 365,25 jours dans l'amplitude | Le climat d'un lieu, en un seul appel | api.climatememory.com |
/v1/climate/normals | Une moyenne trentenaire sur une période de référence OMM. | normals | 3 | Normales OMM | api.climatememory.com |
/v1/climate/normals/compare | Les deux périodes OMM et l'écart entre elles, en un seul appel. | normals | 6 | Comparer deux normales | api.climatememory.com |
/v1/climate/coverage | Le run servi et les dates qu'il couvre. Aucune clé nécessaire. | — | 1 | Couverture, champs et mailles | api.climatememory.com |
/v1/climate/fields | Ce que ce run sait répondre, avec les unités, et quels champs sont dérivés. Aucune clé nécessaire. | — | 1 | Couverture, champs et mailles | api.climatememory.com |
/v1/climate/cells/resolve | Quelle maille répond pour un point, et à quelle distance. | climate | 1 | Couverture, champs et mailles | api.climatememory.com |
/v1/climate/licensing | Les conditions de licence de cette archive. Aucune clé nécessaire. | — | 0 | Couverture, champs et mailles | api.climatememory.com |
Pour les agents et les assistants de code
Deux fichiers, générés depuis la même source que ces pages, donc incapables de diverger de ce que vous lisez :
- /llms.txt — l'orientation courte : ce à quoi chaque produit répond, et quand se tourner vers lequel.
- /llms-full.txt — toute cette référence en un seul fichier Markdown, endpoints, paramètres et mises en garde compris.
Chaque service publie aussi un schéma OpenAPI 3.1 et une interface navigable : /v1/openapi-weather.json et /v1/docs/weather, /v1/openapi-degree-days.json et /v1/docs/degree-days, /v1/openapi-climate.json et /v1/docs/climate, /v1/openapi-geocoding.json et /v1/docs/geocoding. Générez un client typé dans n'importe quel langage à partir de ces schémas plutôt que d'en écrire un à la main.