Quelle signification des différentes dates dans les données d'Observation ?

Quelle signification des différentes dates dans les données d'Observation ?

màj le Nov 26, 2025

Plusieurs dates font partie des informations retournées avec les données d'Observation, quelles sont leurs différences et leurs relations ?

Tableau synthétique

date

signification

date

signification

validity_time

Date et heure de la mesure réalisée par le capteur. Elle est toujours alignée sur les heures pleines (pour les observations horaires) ou sur les pas de 6 minutes. C’est cette date qui doit être utilisée dans les requêtes des APIs (paramètre date).

insert_time

Date et heure de l’insertion de la mesure dans les bases internes de Météo-France. Elle indique le moment où la donnée est devenue disponible dans notre chaîne de traitement.

reference_time

Date du traitement informatique qui extrait la donnée de nos bases internes pour l’intégrer au backend de l’API. Elle reflète uniquement le cadencement interne de l’API.

Il est donc normal et attendu d’observer :

validity_time < insert_time < reference_time

Explications complémentaires

Les observations sont récupérées par différents programmes d’alimentation qui s’exécutent à intervalles réguliers (ex. toutes les 6 minutes pour les observations 6M, à H+10 pour les observations horaires).

Ces tâches peuvent remonter des données :

  • ayant une validité dans l’heure précédente (flux 6 minutes),

  • ou dans les 24 heures précédentes (flux horaire),
    même si l’insertion de ces données dans nos bases (insert_time) est récente.

À quoi servent réellement les trois dates ?

  • insert_time
    Sert uniquement d’indicateur : elle vous informe du moment où la donnée a été injectée dans nos bases. Elle n’est pas exploitable pour déduire la validité de la mesure.

  • reference_time
    Indique seulement l’heure d’exécution des tâches logicielles de l’API. Elle n’est donc pas pertinente pour piloter une chaîne de traitement métier.

  • validity_time
    Est la seule date à prendre en compte pour reconstruire correctement la chronologie des observations ou identifier l’heure réelle de la mesure par le capteur météorologique.

Conclusion

Pour l’exploitation opérationnelle des données d’observation, seule la date validity_time doit être utilisée.
Ni insert_time ni reference_time ne permettent d’inférer l’heure de validité d’une mesure.

 

Articles connexes