...
The primary purpose of this service, is to find the available properties of the data you want to access; the service provides the propertyCode that you can use to request a data product via the dataProductDelivery web service.
For a list of available property codes, along with names, descriptions and units of measure, see the Available Properties page.
See External Web Services for method and token usage and error messages.
URL
No Format |
---|
https://data.oceannetworks.ca/api/properties |
...
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=5ba514e8-1203-428c-8835-879c8173e387YOUR_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 |
...
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/ |
...
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 an unsupported a filter parameter is in the query but is not supported.
|
URL Examples
- Return a list of All Properties (no filters)
...