Please download this README when accessing any of the data packages and provide your email address so we can contact you with any updates to the data.
|All Sensor Data |
|All sensors since benchmarking and calibration of hardware and uniformity of firmware; raw data streams and quality controlled, filtered data streams||June 2019 to |
|Most Reliable |
|Sensors with the highest data return rates and verified elevation surveys||One year ago to|
|Hurricane Dorian |
|Closer look at the effects of Dorian; peak anomalies around 9:00PM EST on 09/04/19; only Most Reliable Sensors that were active at the time||08/25/19 – |
|Fort Pulaski |
|Benchmarking data from two Georgia Tech sensors co-located with the NOAA Tide Gauge at Fort Pulaski||June 2019 to|
The Smart Sea Level Sensors API provides an easy way to retrieve measurements and metadata from sea level sensors deployed in Chatham County, GA. The API is built according to the OGC SensorThings API standard, which provides a unified way to retrieve measurements from IoT sensor systems.
Below are concepts and common queries to get started using the Sea Level Sensors API. For more information on how to perform more customized queries, check out SensorUp’s OGC SensorThings API Documentation.
Thingis a deployed sensor. A
Locationand one or more
Locationcontains the latitude and longitude coordinates of a sensor.
- A sensor’s measurements are represented as a
Observations. Some sensors in our network only measure water level, and therefore have one
Water Level. Other sensors in our network measure air pressure, air temperature, and water level, and therefore have three
Datastreams for each metric.
# a sensor with one Datastream for water level measurements $ curl https://api.sealevelsensors.org/v1.0/Things(1)/Datastreams # a sensor with three Datastreams for water level, air temperature, and air pressure $ curl https://api.sealevelsensors.org/v1.0/Things(5)/Datastreams
Get all sensors
$ curl 'https://api.sealevelsensors.org/v1.0/Things'
Get a specific sensor
$ curl 'https://api.sealevelsensors.org/v1.0/Things(3)'
Get all measurements recorded by a specific sensor, sorted oldest to newest
$ curl 'https://api.sealevelsensors.org/v1.0/Datastreams(3)/Observations'
The first 100 measurements recorded by the sensor will return. The @iot.nextLink key gives next 100 measurements recorded by the sensor.
Alternatively, the $select query option can be used to select only the result and resultTime fields, and the $resultFormat query option can be used to return Observations in a more compact array format.
$ curl 'https://api.sealevelsensors.org/v1.0/Datastreams(3)/Observations?$select=resultTime,result&$resultFormat=dataArray'
Get all measurements recorded by a specific sensor between a start and end date
$ curl 'https://api.sealevelsensors.org/v1.0/Datastreams(3)/Observations?$filter=phenomenonTime%20ge%202019-09-19T00:00:00.000Z%20and%20phenomenonTime%20le%202019-09-20T00:00:00.000Z'
The first 100 measurements recorded by the sensor within the date range will return. The @iot.nextLink key gives next 100 measurements recorded by the sensor within the date range.