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.

Téléchargement "automatique" ou "par flux" des données marégraphiques REFMAR mises à disposition sur http://data.shom.fr

 

Le téléchargement "automatique" ou "par flux" permet d'obtenir automatiquement les mesures du niveau de la mer après paramétrage. Ce système permet à un utilisateur d’interroger et de collecter des données des marégraphes par requêtes. Il utilise le service Web SOS (Service Observation Sensor). Ce service OGC permet l’interrogation à distance de capteurs (marégraphes).

 

Principe de fonctionnement

Depuis chaque page d'une station, vous pouvez demander l'URL du service. L'URL est identique poru tous les marégraphes. C'est en paramètrant la requête envoyée au service qu'on interroge différentes stations.

 

Etape 1 : Cliquer sur le bouton "Consommer les flux"

Cliquez sur le bouton "Consommer les flux" se trouvant à droite et au-dessus du graphique représentant les niveaux marin en fonction du temps.

Accès au téléchargement "consommer les flux"

copie d'écran issue de la version non définitive du volet diffusion marégraphique de data.shom.fr

 

Etape 2 : Renseigner les champs demandés dans la nouvelle fenêtre ouverte

Dans la nouvelle fenêtre qui s'ouvre, indiquez votre nom (1), ainsi que votre adresse mail (2) et cliquez sur "Envoyer".

Accès au téléchargement "flux"

copie d'écran issue de la version non définitive du volet diffusion marégraphique de data.shom.fr

Vous avez également la possibilité, si vous le souhaitez, de recevoir de la part de l’équipe REFMAR des informations sur la marégraphie (informations sur les nouveaux observatoires, ceux actuellement en maintenance, actualités gravitant autour du niveau marin…). Pour cela, laissez la case cochée. A tout moment, vous avez la possibilité de vous abonner. Pour ce faire, il suffit de télécharger de nouvelles données en laissant la case idoine cochée.

Validation demande d'accès au téléchargement "flux"

copie d'écran issue de la version non définitive du volet diffusion marégraphique de data.shom.fr

Etape 3 : Paramétrage de la collecte

Une fois reçue l'URL du serveur à l'adresse mail renseignée l’URL, il est possible d’exécuter des requêtes http par différents moyens :

  • Collecte par l'interface du serveur
  • Collecte par un éditeur de requêtes POST dans son navigateur Internet
  • Collecte par script

l'URL du service est http://services.data.shom.fr/sos/service pour obtenir les données sous formes XML (POX) ou JSON. Pour obtenir le format TXT, l'URL est http://services.data.shom.fr/fast-sos/service/txt

Etape 3a : Collecte des données par l'interface du serveur

L’accès à cette interface se fait par l’URL suivante : http://services.data.shom.fr/sos/client

Dans votre navigateur, vous avez alors accès à l’interface suivante :

Interface directe du serveur

copie d'écran issue de la version non définitive du volet diffusion marégraphique de data.shom.fr

 

Les paramètres à renseigner sont les suivants :

  • Première liste (A) : choisir SOS ;
  • Seconde liste (B) : choisir 2.0.0 ;
  • Troisième liste (C) : choisir JSON ou POX.

Remarque : Les descriptions suivantes ont été faites avec l’option JSON.

  • Quatrième liste (D): il s’agit ici de choisir la requête (fonction associée) que vous souhaitez effectuer.

 

Les Extensions de bases disponibles sont pour le champ (E) :

  • GetCapabilities, pour demander une auto-description du service (liste des fonctions et paramètres associés). On y retrouve les paramétrages du serveur SOS « marégraphie ». ce sont ces paramètres qui seront utilisés pour construire la requête.

Dans ce champ (E), l’utilisateur peut choisir le détail de paramétrage possible de la requête :

  • All section : détail complet (à privilégier pour connaître l’ensemble des paramètres possibles de chaque fonction ;
  • Content section : détail intermédiaire ;
  • Minimal : description minimale.
  • DescribeSensor pour demander des informations sur un capteur. Il s’agit du fichier SML décrit ici.

Dans ce champ (E), l’utilisateur peut choisir le détail de paramétrage possible de la requête :

  • DescribSensor SOS 2.0.0 : description normale (à privilégier) ;
  • With ValidTime Instant : description à une date / heure donnée (pas d’intérêt ici pour les marégraphes) ;
  • With ValidTime Period : sur une période de temps (pas d’intérêt ici pour les marégraphes).
  • GetObservation, pour demander les données de hauteurs d'eau mesurées par le marégraphe.

Dans ce champ (E), l’utilisateur peut choisir le détail de paramétrage possible de la requête :

  • Multiple filter : détaille l’ensemble des paramètres disponibles ;
  • No filter : sans filtre sur les observations (à ne pas utiliser) ;
  • Single filter : filtre sur une zone géographique (sans intérêt pour les marégraphes) et filtre temporel (permet de sélectionner la période de temps pour laquelle vous souhaitez collecter des données). Ce dernier filtre est à privilégier.

 

Dans le champ Service URL, il faut laisser l’URL par défaut : http://services.data.shom.fr/sos/service

Dans la partie « Request », paramétrer comme suit :

  • Première liste : choisir POST
  • Seconde liste et Troisième liste : choisir application/JSON

En fonction des paramètres choisis, le prototype de la requête est alors proposé dans la partie en dessous.

Il suffit ensuite d’adapter cette requête au serveur de marégraphe, à partir des paramètres spécifique du serveur SOS marégraphie fournie par GetCapabilities. Pour finir, appuyer sur le bouton « Send », pour que le résultat s’affiche dans la partie en dessous « Response ».

Interface directe du serveur

copie d'écran issue de la version non définitive du volet diffusion marégraphique de data.shom.fr

 

 

Etape 3b : Exemple de requête pour la collecte des données par un module de requête HTTP dans un navigateur

 

Pour la suite de la description, le module utilisé est «HTTPRequester».

Le module une fois installé dans Firefox est accessible par l’icône apparaissant dans votre navigateur :

Icône HttpRequester sur Firefox

En cliquant sur cet icône, s’ouvre la fenêtre suivante :

Fenêtre HttpRequester [Firefox]

copie d'écran HttpRequester sous Firefox

La configuration est la suivante :

  • Dans le champ Service URL (A) : il faut saisir l’URL du service (se référer au paragraphe de l'étape 3)
  • Choisir dans le champ en dessous (GET) (B) : choisir « POST »
  • Dans le champ « content type »  (C) : choisir « application/json »
  • Dans l’espace (D), saisir la requête (voir les exemples du paragraphe suivant 3c) ;
  • Appuyer sur « Submit » pour envoyer la requête.

Le résultat apparaît alors dans la partie (E).

 

 

Etape 3c : Exemples de requêtes

Pour GetCapabilities :

La requête suivante fournit l’ensemble des fonctions et des paramètres associés du serveur et sert également à paramétrer les autres fonctions.

{

  "request": "GetCapabilities",

  "service": "SOS",

  "sections": [

    "ServiceIdentification",

    "ServiceProvider",

    "OperationsMetadata",

    "FilterCapabilities",

    "Contents"

  ]

}

Pour DescribeSensor :

La requête suivante permet de demander des informations sur un marégraphe (ici celui de Roscoff dont l'identifiant est 54). Une page spéciale rassemble pour chaque marégraphe l'identifiant qui lui est attribué. Le paramétrage s’effectue sur la ligne «  procédure ». L’URL sera celle fournie par le GetCapabilities.

{

  "request": "DescribeSensor",

  "service": "SOS",

  "version": "2.0.0",

  "procedure": "http://xxxxxxx/maregraphie/procedure/54",

  "procedureDescriptionFormat": "http://www.opengis.net/sensorML/1.0.1"

}

Pour GetObservation :

Cette requête permet d’extraire des données de l'observatoire marégraphique de Toulon (identifiant 68), du 15/01/2014 à 00h00 au 17/02/2015 à 23h59min59sec. Le Z correspond à l'heure Zoulou (= UTC = TU + 0h).

{

  "request": "GetObservation",

  "service": "SOS",

  "version": "2.0.0",

  "procedure": "http://xxxxxxxxxx/maregraphie/procedure/68",

  "offering": "http:// xxxxxxxxxx /maregraphie/offering/68",

  "observedProperty": "http:// xxxxxxxxxx /maregraphie/observedProperty/WaterHeight/1",

  "temporalFilter": {

    "during": {

      "ref": "om:phenomenonTime",

      "value": [

        "2014-01-15T00:00:00Z",

        "2015-02-17T23:59:59Z"

      ]

    }

  }

}

 

D'autres paramétrages sont possible sur les fonctions suivantes :

  • «procedure» et «offering», Les URL correspondantes sont fournies par le GETcapabilities. L'identifiant 68 correspond au marégraphe de Toulon ;
  • «observedProperty» permet de choisir le type de hauteur d’eau, parmi les différents types d’enregistrements :
    • WaterHeight/1 : Brutes Haute fréquence ;
    • WaterHeight/2 : Brutes temps différé ;
    • WaterHeight/3 : Validées temps différé ;
    • WaterHeight/4 : Validées horaires ;
    • WaterHeight/5 : Brutes horaires (A VENIR) ;
    • WaterHeight/6 : Pleines et basses mers (A VENIR).
  • « temporalFilter », permet de préciser les bornes temporelles entre lesquelles vous souhaitez récupérer les données.

Le format "2015-01-15T00:00:00+00:00", correspond à :

 [année]-[mois]-[jour]T[heure]:[minutes]:[secondes][système horaire ici UTC]

 

Etape 3d : Exemple de requête pour la collecte des données par script

Pour automatiser la récupération des données, il est possible de scripter les requêtes avec une commande de type wget.

wget -O fichier_sortie.extension --header='Content-Type: application/json' --post-data='{"request": "GetObservation", "service": "SOS", "version": "2.0.0", "procedure": [ "http://shom.fr/maregraphie/procedure/id_maregraphe"], "offering": ["http://shom.fr/maregraphie/offering/id_maregraphe"],"featureOfInterest":["http://shom.fr/maregraphie/featureOfInterest/id_maregraphe "], "observedProperty": ["http://shom.fr/maregraphie/observedProperty/WaterHeight/type_hauteur_données"], "temporalFilter":[{"during": {"ref": "om:phenomenonTime", "value": [ "date_debut", "date_fin"]}}]}' URL_service

 

Par exemple la requête pour récupérer les données brutes haute fréquence de la station de Brest du 3 juillet 2015 au 9 juillet 2015 au format TXT est la suivante :

wget -O response.txt --header='Accept-Encoding: application/txt' --header='Content-Type: application/json' --post-data='{"request": "GetObservation", "service": "SOS", "version": "2.0.0", "procedure": [ "http://shom.fr/maregraphie/procedure/3"], "offering": ["http://shom.fr/maregraphie/offering/3"],"featureOfInterest":["http://shom.fr/maregraphie/featureOfInterest/3"], "observedProperty": ["http://shom.fr/maregraphie/observedProperty/WaterHeight/1"], "temporalFilter":[{"during": {"ref": "om:phenomenonTime", "value": [ "2015-07-03T00:00:00Z", "2015-07-09T23:59:59Z"]}}]}' http://services.data.shom.fr/fast-sos/service/txt

Se référer aux explications des paramètres du paragraphe 3.c.

 

Pour en savoir plus

 

 

Dernière mise à jour de la page : 10/05/2016

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