Smart Mooring Sensor Data

The /sensor-data url communicates data collected from a deployed Spotter's Smart Mooring sensors within a given date-time window.

get
Smart Mooring Sensor Data

https://api.sofarocean.com/api/sensor-data?spotterId=:spotterId&startDate=:startDate&endDate=:endDate
Returns Smart Mooring sensor data for the corresponding spotterId between startDate and endDate.
Request
Response
Request
Query Parameters
spotterId
required
string
SpotterId of the device to retrieve data for.
startDate
required
string
ISO8601-formatted timestamp string indicating start date for data inclusion. Example: 2021-01-01T07:00:00Z
endDate
required
string
ISO8601-formatted timestamp string indicating end date for data inclusion. Example: 2021-01-02T07:00:00Z
Response
200: OK
The /sensor-data response format consists of a “flat” (uncategorized) data stream ordered by timestamp. The sensorPosition property represents the physical position of a sensor in the Smart Mooring relative to Spotter. Sensor position 1 is closest to Spotter. The data_type_name property represents the type of information being sent by a sensor, as ingested by the API. The timestamp field in a /sensor-data response is an ISO8061-formatted string, which indicates the end of a sample collection period. Timestamps within this data format, while ordered, are not necessarily unique. Two or more sensors may send different values with identical timestamps (e.g. a temperature sensor and a pressure sensor which both emit data on the same time interval).
{
"status": "success",
"data": [
{
"latitude": 13.1203,
"longitude": 100.91925,
"timestamp": "2021-12-01T03:02:13.000Z",
"sensorPosition": 2,
"units": "μbar",
"value": 50,
"unit_type": "pressure",
"data_type_name": "rbrcoda3_stdevpressure_15bits"
},
{
"latitude": 13.1203,
"longitude": 100.91925,
"timestamp": "2021-12-01T03:02:13.000Z",
"sensorPosition": 2,
"units": "°C",
"value": 25.266200000000005,
"unit_type": "temperature",
"data_type_name": "rbrcoda3_meantemperature_20bits"
},
{
"latitude": 13.1203,
"longitude": 100.91925,
"timestamp": "2021-12-01T03:02:13.000Z",
"sensorPosition": 1,
"units": "°C",
"value": 25.480000000000004,
"unit_type": "temperature",
"data_type_name": "sofar_temperature_12bits"
},
{
"latitude": 13.1203,
"longitude": 100.91925,
"timestamp": "2021-12-01T03:02:13.000Z",
"sensorPosition": 2,
"units": "μbar",
"value": 1122270,
"unit_type": "pressure",
"data_type_name": "rbrcoda3_meanpressure_21bits"
},
{
"latitude": 13.1203,
"longitude": 100.91925,
"timestamp": "2021-12-01T03:17:13.000Z",
"sensorPosition": 2,
"units": "°C",
"value": 25.268500000000003,
"unit_type": "temperature",
"data_type_name": "rbrcoda3_meantemperature_20bits"
},
{
"latitude": 13.1203,
"longitude": 100.91925,
"timestamp": "2021-12-01T03:17:13.000Z",
"sensorPosition": 1,
"units": "°C",
"value": 25.520000000000003,
"unit_type": "temperature",
"data_type_name": "sofar_temperature_12bits"
},
{
"latitude": 13.1203,
"longitude": 100.91925,
"timestamp": "2021-12-01T03:17:13.000Z",
"sensorPosition": 2,
"units": "μbar",
"value": 1122190,
"unit_type": "pressure",
"data_type_name": "rbrcoda3_meanpressure_21bits"
},
{
"latitude": 13.1203,
"longitude": 100.91925,
"timestamp": "2021-12-01T03:17:13.000Z",
"sensorPosition": 2,
"units": "μbar",
"value": 70,
"unit_type": "pressure",
"data_type_name": "rbrcoda3_stdevpressure_15bits"
},
]
}

Example Request

curl "https://api.sofarocean.com/api/sensor-data?spotterId=SPOT-0222&startDate=2021-12-01T07:00:00Z&endDate=2021-12-02T07:00:00Z" -H 'token: YOUR_API_TOKEN'