La diffusion des données marégraphiques REFMAR est assurée sur le site http://data.shom.fr, le portail de l'information géographique maritime et littorale de références.
Bannière data.shom.fr

Les équipes REFMAR et data.shom.fr se tiennent à votre disposition pour répondre à l'ensemble de vos questions.

Le format de diffusion JSON des données marégraphiques REFMAR mises à disposition sur http://data.shom.fr

Le format JSON pour JavaScript Object Notation est l'un des 3 formats de diffusion des données marégraphiques REFMAR mises à disposition sur data.shom.fr, Il s'agit d'un format de données textuelles dérivé de la notation des objets du langage JavaScript. Il permet de représenter de l’information structurée comme le permet XML.

 

Constitution du format JSON :

Le fichier JSON contient un bloc "entête". Ce bloc fournit les coordonnées de l’observatoire de marée pour lequel les mesures du niveau marin sont téléchargées.

  {"request":"GetObservation","version":"2.0.0","service":"SOS","observations":[

 

La suite du fichier est composé des blocs suivants :
 

 1 {

2        "type":"http://www.opengis.net/def/observationType/OGC-OM/2.0/OM_Measurement",

3        "procedure":"http://shom.fr/maregraphie/procedure/3",

4        "offering":"http://shom.fr/maregraphie/offering/3",

5        "observableProperty":"http://shom.fr/maregraphie/observedProperty/WaterHeight/1",

6        "featureOfInterest":

7        {

8                "identifier":

9                {

10                        "codespace":"http://www.opengis.net/def/nil/OGC/0/unknown",

11                        "value":http://shom.fr/maregraphie/featureOfInterest/3

12               },

13               "name":                                                     

14               {

15               "codespace":"http://www.opengis.net/def/nil/OGC/0/unknown",

16               "value":"http://shom.fr/maregraphie/featureOfInterest/3"

17               },

18               "geometry":

19               {

20                        "type":"Point",

21                        "coordinates":[48.38290024,-4.49503994]

22               }

23       },

24       "phenomenonTime":"2015-02-03T09:54:12.000Z",

25       "resultTime":"2015-02-03T09:54:12.000Z",

26       "result":{"uom":"m","value":1.76}

27 },

 

Chaque bloc correspond à une hauteur d’eau pour une date/ heure donnée.

Les informations pertinentes sont :

  • Lignes 3 et 4 : le numéro de l’observatoire (ici l'identifiant 3 correspondant à BREST) ;
  • Ligne 5 : le type de donnée : ici WaterHeight/1 = données brutes hautes fréquence ;
  • Ligne 21 : le rappel des coordonnées du site ;
  • Ligne 24 et 25 : la date et l’heure de la donnée au format :

[année]-[mois]-[jour]T[heure]:[minutes]:[secondes][système horaire], avec les secondes en décimale xx.xxx et Z (Zoulou) correspond à UTC ;

  • Ligne 26 la hauteur d’eau en mètres.

 

Références

 

Pour en savoir plus

 

Dernière mise à jour de la page : 02/03/2015

Foire aux questions sur l'accès aux données marégraphiques REFMAR distribués sur http://data.shom.fr :