...
No Format |
---|
https://data.oceannetworks.ca/api/properties |
Method | Description | Example |
---|---|---|
get | Retrieve a list Property codes and descriptions |
|
get
The get method retrieves a list of property codes and descriptions
Parameters
Parameter | Type | Description | Example |
---|---|---|---|
Required | |||
token | string | All Web Services require a token. Once logged in at https://data.oceannetworks.ca/login, your token can be retrieved or generated at https://data.oceannetworks.ca/Profile . Click on the "Web Services" tab, then click "Generate Token". | token=YOUR_TOKEN_HERE |
Optional | |||
propertyCode | string | Return a single Property matching a specific Property Code
| propertyCode=beamposition |
propertyName | string | Return all Properties where the Property Name contains a keyword
| propertyName=Temp |
description | string | Return all Properties where Description contains a keyword
| description=water |
locationCode | string | Return all Properties available at a specific Location
| locationCode=BACAX |
deviceCategoryCode | string | Return all Properties that have devices belonging to a specific Device Category
| deviceCategoryCode=CTD |
deviceCode | string | Return all Properties associated with or measured by a specific Device.
| deviceCode=AandOpt0581 |
Response
Example for request: https://data.oceannetworks.ca/api/properties?method=get&token=[YOUR_TOKEN_HERE]&propertyCode=seawatertemperature
...
Returns a list of properties with values for Description, Property Code, Property Name, Units of Measure (UOM) and controlled vocabulary terms, ordered alphabetically by Property Code
[ { "description" : "Time: Gregorian days since 19700101T000000Z" , "propertyCode" : "gregoriantime" , "propertyName" : "Gregorian Time" , "uom" : "Gregorian days since 19700101T000000Z" }, { "description" : "Magnetic Heading" , "propertyCode" : "magneticheading" , "propertyName" : "Magnetic Heading" , "uom" : "deg" , "cvTerm" : [{ "uom" : [{ "vocabulary" : "BODC data storage units" , "uri" : "http://vocab.nerc.ac.uk/collection/P06/current/UAAA/" }] }] }, { "description" : "Pitch" , "propertyCode" : "pitch" , "propertyName" : "Pitch" , "uom" : "deg" , "cvTerm" : [{ "uom" : [{ "vocabulary" : "BODC data storage units" , "uri" : "http://vocab.nerc.ac.uk/collection/P06/current/UAAA/" }] }] }, { "description" : "Pressure" , "propertyCode" : "pressure" , "propertyName" : "Pressure" , "uom" : "decibar" , "cvTerm" : [{ "uom" : [{ "vocabulary" : "BODC data storage units" , "uri" : "http://vocab.nerc.ac.uk/collection/P06/current/UPDB/" }] }] }, { "description" : "Roll" , "propertyCode" : "roll" , "propertyName" : "Roll" , "uom" : "deg" }, { "description" : "Temperature: sea water" , "propertyCode" : "seawatertemperature" , "propertyName" : "Sea Water Temperature" , "uom" : "C" }, { "description" : "Sound Speed: sound velocity sensor" , "propertyCode" : "soundspeed" , "propertyName" : "Sound Speed" , "uom" : "m/s" }, { "description" : "Voltage: voltage sensor" , "propertyCode" : "voltage" , "propertyName" : "Voltage" , "uom" : "V" , "cvTerm" : [{ "uom" : [{ "vocabulary" : "BODC data storage units" , "uri" : "http://vocab.nerc.ac.uk/collection/P06/current/UVLT/" }] }] } ] |
Property | Type | Description | Example |
---|---|---|---|
description | string | Returns a description of the property. | "description":"Pressure" |
hasDeviceData | string | Returns whether, among all properties that fit the query, any of them have a NEPTUNE-searchable sensor, device, and site | "hasDeviceData":"true" |
hasPropertyData | string | Returns whether, among all properties that fit the query, any of them have a NEPTUNE-searchable primary sensor and device | "hasPropertyData":"false" |
propertyCode | string | Returns the property code. | "propertyCode":"pressure" |
propertyName | string | Returns the property name. | "propertyName":"Pressure" |
uom | string | Returns the Unit Of Measure that the property measurements are in. | "uom":"decibar" |
cvTerm | List | Returns a list of controlled vocabulary terms associated with the Property and the Unit of Measure associated with the Property if one exists. The controlled vocabulary terms associated with the Property are included in the "property" list and the terms associated with the Unit of Measure are included in the "uom" list. Each vocabulary term is composed of:
| "cvTerm": [{"property" : [{ "uom": [{ "vocabulary" : "BODC data storage units", "uri" : "http://vocab.nerc.ac.uk/collection/P06/current/UVLT/ |
Bad Request (HTTP 400)
errorCode | errorMessage | Description |
---|---|---|
127 | Invalid parameter value | Occurs when an invalid code is used in the filter. Most filters require an exact match, otherwise this error will occur.
|
129 | Invalid parameter name | Occurs when a filter parameter is in the query but is not supported.
|
URL Examples
- Return a list of All Properties (no filters)
...
- Return a list of all Properties that available for instruments with the Device Category 'ADCP2MHZ'
API Proxy
The https://data.oceannetworks.ca/apiproxy/properties URL link in the above examples can be used in a browser for sharing or testing purposes; however, it can not be accessed from code. Calls to the apiproxy server are redirected to a login screen to capture your user id. Accessing the apiproxy URL from code will return html in the payload, which may cause errors or unexpected behaviour. In order to use the deviceCategories properties endpoint from code, you must use the https://data.oceannetworks.ca/api/properties url along with a valid token.
Code Examples
Content Report Table | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Warning |
---|
Please report all issues with the web services, documentation, samples and client libraries to the Oceans 2.0 Help Centre |