Console API
Choisissez une route de l'API Kuma Data Core et remplissez ses paramètres. Le code se met à jour à mesure que vous tapez.
api.kumascience.com Documentation
GET /v1/health
État du service
Indique si l'API fonctionne et quelle édition elle sert. Répond sans clé.
Sans clé JSON
GET /v1/edition
Édition publiée
L’édition servie par l’API, à citer avec le DOI.
Sans clé JSON
POST /v1/cles
Obtenir une clé
La clé est émise tout de suite et affichée une seule fois.
Sans clé JSON
GET /v1/series
Catalogue des séries
Liste paginée des séries, avec filtres.
Clé requise JSON
GET /v1/series/{code_serie}
Mesures d’une série
Métadonnées et mesures d’une série, en JSON ou en CSV.
Clé requise JSON ou CSV
GET /v1/localites
Référentiel des localités
Liste paginée du référentiel géographique, du continent à la commune.
Clé requise JSON
GET /v1/localites/resolution
Localité d’un point
Renvoie la localité dont la cellule de grille contient le point.
Clé requise JSON
GET /v1/localites/{code}
Détail d’une localité
Fiche d’une localité, avec ses coordonnées.
Clé requise JSON
GET /v1/grandeurs/poa_parametrable
Irradiation sur plan incliné
Calcul par le modèle de Perez (1990) à partir d’une série GHI. Sans DNI ni DHI, le calcul passe au modèle de Liu-Jordan.
Clé requise JSON ou CSV
GET /v1/grandeurs/poa_bifacial
Irradiation bifaciale
Rangées de modules bifaces, modèle infinite sheds. Les séries DNI et DHI de la localité sont nécessaires.
Clé requise JSON ou CSV
GET /v1/grandeurs/productible_correction_thermique
Productible, correction thermique
Production PV corrigée de la température de cellule (NOCT, Ross 1980).
Clé requise JSON ou CSV
GET /v1/grandeurs/productible_pr_fourni
Productible, PR fourni
Production PV à partir d’un ratio de performance que vous fournissez, avec ou sans correction de température.
Clé requise JSON ou CSV
GET /v1/grandeurs/energie_utile_ecs
Eau chaude solaire
Énergie utile au capteur, modèle de Hottel-Whillier-Bliss. Il faut une série GHI et la série T2M de la même localité.
Clé requise JSON ou CSV
GET /v1/grandeurs/degre_jour_climatisation
Degrés-jours de climatisation
Cumul mensuel des degrés au-dessus d’une température de base (Erbs 1983), à partir d’une série T2M.
Clé requise JSON ou CSV
GET /v1/grandeurs/ghi_exceedance/{code_localite}
P50 et P90 annuels
Irradiation annuelle dépassée une année sur deux et neuf sur dix, sur 1991-2020.
Clé requise JSON
GET /v1/grandeurs/taux_salissure_proxy/{code_serie_source}
Pertes par salissure
Perte de transmission estimée par le modèle HSU, à partir d’une série PM2.5.
Clé requise JSON
GET /v1/grandeurs/pr_realiste/{code_serie_source}
PR réaliste saisonnier
Ratio de performance effectif du site, corrigé de la température et de la salissure, à partir d’une série GHI.
Clé requise JSON
GET /v1/grandeurs/incertitude_inter_source/{code_localite}
Incertitude inter-source
Écart entre sources satellitaires pour une localité.
Clé requise JSON
GET /v1/grandeurs/incertitude_inter_source
Incertitudes, toutes localités
Liste paginée des fiches d’incertitude de l’atlas.
Clé requise JSON
GET /v1/horaire/{localite}/{grandeur}
Valeurs horaires
Valeurs horaires en UTC sur une fenêtre de dates, en JSON ou en CSV.
Clé requise JSON ou CSV
GET /v1/horaire/{localite}/{grandeur}/disponibilite
Plage horaire disponible
Première et dernière date servies pour une localité et une grandeur.
Clé requise JSON
GET /v1/calage
Référentiels de calage
Stations de référence publiées et localités qu’elles couvrent.
Clé requise JSON
GET /v1/calage/{localite}/{grandeur}
Biais saisonniers
Biais du satellite par rapport au sol pour chaque saison, avec le facteur de correction.
Clé requise JSON
GET /v1/etudes/capsule
Ressource complète d’un point
Toutes les données du moteur pour un point, au format kuma-ressource-1 : un en-tête JSON suivi de données CSV.
Clé requise Texte