Feat/extremes/348 temp extremes endpoint pour tableau#437
Feat/extremes/348 temp extremes endpoint pour tableau#437
Conversation
…endpoint extremes
| - tmax | ||
| - tmin | ||
| default: tmax | ||
| description: > | ||
| Type d'extrême à calculer : `tmax` pour la température maximale, | ||
| `tmin` pour la température minimale. |
There was a problem hiding this comment.
la ca reste cohérent avec le premier endpoint min max, tn et tx sont les noms des colonnes en BDD, je peux changer si besoin?
There was a problem hiding this comment.
En météo j'ai l'impression que c’est courant de dire tn et tx, donc à voir avec @AntoineFede s'il veut rester dans les noms du milieu, d'autant plus qu'on parle d'une API, ou s'il veut garder une approche plus agnostique
| - name: limit | ||
| in: query | ||
| required: false | ||
| schema: | ||
| type: integer | ||
| minimum: 1 | ||
| default: 50 | ||
| description: Nombre maximal d'éléments retournés. | ||
|
|
||
| - name: offset | ||
| in: query | ||
| required: false | ||
| schema: | ||
| type: integer | ||
| minimum: 0 | ||
| default: 0 | ||
| description: Nombre d'éléments à ignorer avant de commencer la page. |
There was a problem hiding this comment.
Je suis perdu entre limit/offset et page/page_size @AntoineFede @Jolymark @rnoyer
There was a problem hiding this comment.
j'ai uniformisé avec deviation mais peut etre que c'est plus intuitif page et page_size
|
Un coup on utilise Extremes, un coup on utilise MinMax, faudrait uniformiser @AntoineFede |
Utilisons extremes comme initialement fait par Marc |
3 participants
Type de PR
Objectif
Ajout de l'endpoint GET /api/v1/temperature/extremes : tableau paginé des stations avec leur Tmin ou Tmax moyenne sur une période donnée.
Contexte
Story #348. Endpoint simelaireà temperature/deviation : même structure (pagination, tri, filtres), mais sur les températures extrêmes (min ou max) au lieu des écarts à la normale.
Les filtres classe_recente, date_de_creation, date_de_fermeture ont été ajoutés en suivant le pattern introduit par la PR #384 .
Changements
Nouveau endpoint GET /api/v1/temperature/extremes avec pagination, tri et filtres
Types : MinMaxOverviewQuery, MinMaxOverviewStation, MinMaxOverviewResult
Protocol MinMaxOverviewDataSource + service compute_minmax_overview
Filtres : station_ids, station_search, textreme_min/max, tmean_min/max, alt_min/max, classe_recente_min/max, date_de_creation_min/max, date_de_fermeture_min/max, departments, regions
Fake data source pour les tests (3 stations statiques)
Spec OpenAPI complète
Décisions techniques
Impacts
Tests
Points d’attention pour la review
Suivi