Data Packages

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.

Name	Description	Timespan	Download (size)
All Sensor Data (32 Sensors)	All sensors since benchmarking and calibration of hardware and uniformity of firmware; raw data streams and quality controlled, filtered data streams	June 2019 to present date	CSV (0.5GB) JSON (0.7GB)
Most Reliable Sensors Subset (23 Sensors)	Sensors with the highest data return rates and verified elevation surveys	One year ago to present date	CSV (0.2GB) JSON (0.3GB)
Hurricane Dorian (20 Sensors)	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 – 09/14/19	CSV (0.1GB) JSON (0.02GB)
Fort Pulaski Benchmark (3 Sensors)	Benchmarking data from two Georgia Tech sensors co-located with the NOAA Tide Gauge at Fort Pulaski	June 2019 to present date	CSV (0.1GB) JSON (0.1GB)

API

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.

Concepts

A Thing is a deployed sensor. A Thing has a Location and one or more Datastreams of Observations.
A Thing‘s Location contains the latitude and longitude coordinates of a sensor.
A sensor’s measurements are represented as a Datastream of Observations. Some sensors in our network only measure water level, and therefore have one Datastream named 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
```

Quickstart

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.