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)