Request (Near) Real-Time Data
# Get the token from your Oceans 3.0 profile page
from onc import ONC
onc = ONC("YOUR_TOKEN")
/scalardata/location
Get the last scalar data reading available from a device in a location
params = {
"locationCode": "SEVIP",
"deviceCategoryCode": "CTD",
"rowLimit": "1",
"getLatest": "true",
}
onc.getScalardata(params)
# Longer method name
# onc.getScalardataByLocation(params)
# Alias method name
# onc.getDirectByLocation(params)
Get 1 minute of time-series scalar data readings from a a device in a location
params = {
"locationCode": "SEVIP",
"deviceCategoryCode": "CTD",
"dateFrom": "2016-09-01T00:00:00.000Z",
"dateTo": "2016-09-01T00:01:00.000Z",
}
onc.getScalardata(params)
# Longer method name
# onc.getScalardataByLocation(params)
# Alias method name
# onc.getDirectByLocation(params)
Get 10 seconds of raw CTD data readings from a location
params = {
"locationCode": "BACAX",
"deviceCategoryCode": "CTD",
"dateFrom": "2017-05-23T00:00:00.000Z",
"dateTo": "2017-05-23T00:00:10.000Z",
}
onc.getRawdata(params)["data"]["readings"]
# Longer method name
# onc.getRawdataByLocation(params)["data"]["readings"]
# Alias method name
# onc.getDirectRawByLocation(params)["data"]["readings"]
/scalardata/device
Get 10 seconds of raw data readings from a specific device
params = {
"deviceCode": "AMLMETRECX50348",
"dateFrom": "2019-06-01T00:00:00.000Z",
"dateTo": "2019-06-01T00:00:10.000Z",
}
onc.getRawdata(params)
# Longer method name
# onc.getRawdataByDevice(params)
# Alias method name
# onc.getDirectRawByDevice(params)
Get 1 minute of time-series scalar data readings from a specific device
params = {
"deviceCode": "SBECTD19p4686",
"dateFrom": "2016-09-01T00:00:00.000Z",
"dateTo": "2016-09-01T00:01:00.000Z",
}
onc.getScalardata(params)
# Longer method name
# onc.getScalardataByDevice(params)
# Alias method name
# onc.getDirectByDevice(params)