REFMAR and data.shom.fr staff are available to help you make the switch and answer all your questions.
Any application for registration or account changes are no longer taken into account.
JSON file format for REFMAR tide gauge data available on http://data.shom.fr
JSON, which stands for JavaScript Object Notation, is one of 3 REFMAR tidal data dissemination formats available on data.shom.fr. It is a text format derived from JavaScript object notation. It is used to represent structured information the way XML can.
JSON format:
The JSON file contains a "header" block. This block provides the coordinates of the tidal observatory for which the sea level measurements are being downloaded.
{"request":"GetObservation","version":"2.0.0","service":"SOS","observations":[ |
The rest of the file consists of the following blocks:
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 }, |
Each block corresponds to a water height for a given date/time.
The important information is:
- Lines 3 and 4: The number of the observatory (here the identifier is 3 corresponding to BREST);
- Line 5: the type of data: here WaterHeight/1 = high frequency raw data;
- Line 21: the coordinates of the site;
- Line 24 and 25: the date and time of the data in the format:
[year]-[month]-[day]T[hour]:[minutes]:[seconds][time system], with decimal seconds xx.xxx and Z (Zulu) corresponding to UTC;
- Line 26: the water height in meters.
References
- Directive Inspire et annexes
- Open Geospatial Consortium (OGC)
- SOS standard
- SOS implementation
- ISO metadata - national guidelines and recommendations
To find out more
- REFMAR tide gauge data available on http://data.shom.fr
- Information about REFMAR data producer partners
- SML file format accompanying each data file
Last updated : 2015 06 01