Sample Sensorthings API Queries and Responses
Sample Calls with Responses
Querying from a Project
Starting a query from a project helps narrow data retrieval to only those records associated with that project, making the data more manageable and meaningful. For example, if each project represents a unique study or monitoring area, querying from it directly ensures you are only accessing information relevant to that specific context.
Explore available projects here: https://wyseason.uwyo.edu/sta/v1.1/Projects.
This a path to see all things related to Project 1:
https://wyseason.uwyo.edu/sta/v1.1/Projects(1)/Things
Response:
{
"value": [
{
"name": "Datastreams",
"url": "https://wyseason.uwyo.edu/sta/v1.1/Datastreams"
},
{
"name": "FeaturesOfInterest",
"url": "https://wyseason.uwyo.edu/sta/v1.1/FeaturesOfInterest"
},
{
"name": "HistoricalLocations",
"url": "https://wyseason.uwyo.edu/sta/v1.1/HistoricalLocations"
},
{
"name": "Locations",
"url": "https://wyseason.uwyo.edu/sta/v1.1/Locations"
},
{
"name": "MultiDatastreams",
"url": "https://wyseason.uwyo.edu/sta/v1.1/MultiDatastreams"
},
{
"name": "Observations",
"url": "https://wyseason.uwyo.edu/sta/v1.1/Observations"
},
{
"name": "ObservedProperties",
"url": "https://wyseason.uwyo.edu/sta/v1.1/ObservedProperties"
},
{
"name": "Projects",
"url": "https://wyseason.uwyo.edu/sta/v1.1/Projects"
},
{
"name": "Roles",
"url": "https://wyseason.uwyo.edu/sta/v1.1/Roles"
},
{
"name": "Sensors",
"url": "https://wyseason.uwyo.edu/sta/v1.1/Sensors"
},
{
"name": "Things",
"url": "https://wyseason.uwyo.edu/sta/v1.1/Things"
},
{
"name": "Users",
"url": "https://wyseason.uwyo.edu/sta/v1.1/Users"
},
{
"name": "UserProjectRoles",
"url": "https://wyseason.uwyo.edu/sta/v1.1/UserProjectRoles"
}
],
"serverSettings": {
"conformance": [
"http://www.opengis.net/spec/iot_sensing/1.1/req/batch-request/batch-request",
"http://www.opengis.net/spec/iot_sensing/1.1/req/create-observations-via-mqtt/observations-creation",
"http://www.opengis.net/spec/iot_sensing/1.1/req/create-update-delete",
"http://www.opengis.net/spec/iot_sensing/1.1/req/data-array/data-array",
"http://www.opengis.net/spec/iot_sensing/1.1/req/datamodel",
"http://www.opengis.net/spec/iot_sensing/1.1/req/multi-datastream",
"http://www.opengis.net/spec/iot_sensing/1.1/req/receive-updates-via-mqtt/receive-updates",
"http://www.opengis.net/spec/iot_sensing/1.1/req/request-data",
"http://www.opengis.net/spec/iot_sensing/1.1/req/resource-path/resource-path-to-entities",
"https://fraunhoferiosb.github.io/FROST-Server/extensions/DeepSelect.html",
"https://fraunhoferiosb.github.io/FROST-Server/extensions/GeoJSON-ResultFormat.html",
"https://fraunhoferiosb.github.io/FROST-Server/extensions/JsonBatchRequest.html",
"https://fraunhoferiosb.github.io/FROST-Server/extensions/OpenAPI.html",
"https://fraunhoferiosb.github.io/FROST-Server/extensions/ResponseMetadata.html",
"https://fraunhoferiosb.github.io/FROST-Server/extensions/SelectDistinct.html",
"https://github.com/INSIDE-information-systems/SensorThingsAPI/blob/master/CSV-ResultFormat/CSV-ResultFormat.md"
],
"http://www.opengis.net/spec/iot_sensing/1.1/req/create-observations-via-mqtt/observations-creation": {
"endpoints": [
"mqtt://wyseason.uwyo.edu:1883"
]
},
"http://www.opengis.net/spec/iot_sensing/1.1/req/receive-updates-via-mqtt/receive-updates": {
"endpoints": [
"mqtt://wyseason.uwyo.edu:1883"
]
}
}
}List All Object Types
This request provides an overview of the SensorThings response. Each value consists of a “name” that provides the name of the SensorThings class together with a “url” that provides access to all objects of this class.
The following provides an overview of the SensorThings response at:
https://wyseason.uwyo.edu/sta/v1.1
Response:
{
"@iot.count": 15,
"value": [
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)",
"@iot.id": 3,
"name": "LB00001",
"description": "LimnoTech lake buoy",
"properties": {
"active": true,
"contactEmail": "sarah.collins@uwyo.edu",
"contactName": "Dr. Sarah Collins",
"deployDate": "2023-07-12",
"projectName": "season_buoys",
"thingType": "lake buoy"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)",
"@iot.id": 4,
"name": "LB00002",
"description": "LimnoTech lake buoy",
"properties": {
"active": true,
"contactEmail": "sarah.collins@uwyo.edu",
"contactName": "Dr. Sarah Collins",
"deployDate": "2023-07-12",
"projectName": "season_buoys",
"thingType": "lake buoy"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)",
"@iot.id": 8,
"name": "LB00004",
"description": "LimnoTech lake buoy",
"properties": {
"active": true,
"contactEmail": "sarah.collins@uwyo.edu",
"contactName": "Dr. Sarah Collins",
"deployDate": "2023-07-12",
"projectName": "season_buoys",
"thingType": "lake buoy"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)",
"@iot.id": 9,
"name": "LB00003",
"description": "LimnoTech lake buoy",
"properties": {
"active": true,
"contactEmail": "sarah.collins@uwyo.edu",
"contactName": "Dr. Sarah Collins",
"deployDate": "2023-07-08",
"projectName": "season_buoys",
"thingType": "lake buoy"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)",
"@iot.id": 11,
"name": "SSN00001",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "FOTM1",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-06-19",
"firstDeployDate": "2024-06-19",
"projectName": "season_FOTM",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)",
"@iot.id": 12,
"name": "SSN00002",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "FOTM2",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-06-19",
"firstDeployDate": "2024-06-19",
"projectName": "season_FOTM",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)",
"@iot.id": 13,
"name": "SSN00003",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "FOTM3",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-06-19",
"firstDeployDate": "2024-06-19",
"projectName": "season_FOTM",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)",
"@iot.id": 14,
"name": "SSN00004",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "FOTM4",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-06-19",
"firstDeployDate": "2024-06-19",
"projectName": "season_FOTM",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)",
"@iot.id": 15,
"name": "MET00001",
"description": "all in one meteorological station",
"properties": {
"active": true,
"alias": "FOTM5",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-06-19",
"firstDeployDate": "2024-06-19",
"projectName": "season_FOTM",
"thingType": "met station"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)",
"@iot.id": 22,
"name": "SSN00008",
"description": "Zentra Cloud soil sensor nest",
"properties": {
"active": true,
"alias": "TSS1",
"initialDeployDate": "2024-09-26",
"projects": [
{
"host": "WYSEaSON",
"name": "WYACT",
"managers": [
{
"name": "Tom Rust",
"email": "wyseason@uwyo.edu",
"position": "WYSEaSON Director"
}
],
"partners": [
{
"name": "Teton Science School"
}
],
"organization": "University of Wyoming"
}
],
"thingType": [
"soil sensor nest"
]
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)",
"@iot.id": 23,
"name": "SSN00009",
"description": "Zentra Cloud soil sensor nest with met station",
"properties": {
"active": true,
"alias": "TSS2",
"initialDeployDate": "2024-09-26",
"projects": [
{
"host": "WYSEaSON",
"name": "WYACT",
"managers": [
{
"name": "Tom Rust",
"email": "wyseason@uwyo.edu",
"position": "WYSEaSON Director"
}
],
"partners": [
{
"name": "Teton Science School"
}
],
"organization": "University of Wyoming"
}
],
"thingType": [
"soil sensor nest",
"met station"
]
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)",
"@iot.id": 24,
"name": "SSN00010",
"description": "Zentra Cloud soil sensor nest",
"properties": {
"active": true,
"alias": "TSS3",
"initialDeployDate": "2024-09-26",
"projects": [
{
"host": "WYSEaSON",
"name": "WYACT",
"managers": [
{
"name": "Tom Rust",
"email": "wyseason@uwyo.edu",
"position": "WYSEaSON Director"
}
],
"partners": [
{
"name": "Teton Science School"
}
],
"organization": "University of Wyoming"
}
],
"thingType": [
"soil sensor nest"
]
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(29)",
"@iot.id": 29,
"name": "Test Name",
"description": "Test Description",
"properties": {
"active": "false",
"alias": "TestAlias",
"initialDeployDate": "2024-09-26",
"projects": [
{
"host": "WYSEaSONTest",
"name": "WYACTTest",
"managers": [
{
"name": "Nicholas Case",
"email": "ncase2@uwyo.edu",
"position": "Form Maker Test"
}
],
"partners": [
{
"name": "Teton Science SchoolTest"
}
],
"organization": "University of WyomingTest"
}
],
"purpose": "Test Purpose",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(29)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(29)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(29)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(29)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(29)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(30)",
"@iot.id": 30,
"name": "SSN00011",
"description": "Zentra Cloud soil sensor nest with met station",
"properties": {
"active": true,
"alias": "JHMR1",
"initialDeployDate": "2024-10-29",
"projects": [
{
"host": "WYSEaSON",
"name": "WYACT",
"managers": [
{
"name": "Tom Rust",
"email": "wyseason@uwyo.edu",
"position": "WYSEaSON Director"
}
],
"partners": [
{
"name": "Jackson Hole Mountain Resort"
}
],
"organization": "University of Wyoming"
}
],
"thingType": [
"soil sensor nest",
"met station"
]
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(30)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(30)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(30)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(30)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(30)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(31)",
"@iot.id": 31,
"name": "SSN00012",
"description": "Zentra Cloud soil sensor nest",
"properties": {
"active": true,
"alias": "JHMR2",
"initialDeployDate": "2024-10-29",
"projects": [
{
"host": "WYSEaSON",
"name": "WYACT",
"managers": [
{
"name": "Tom Rust",
"email": "wyseason@uwyo.edu",
"position": "WYSEaSON Director"
}
],
"partners": [
{
"name": "Jackson Hole Mountain Resort"
}
],
"organization": "University of Wyoming"
}
],
"thingType": [
"soil sensor nest"
]
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(31)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(31)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(31)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(31)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(31)/Datastreams"
}
]
}Get All of One Type
This request provides all of one type. The types are the core classes: Locations, Things, Datastreams, Observations, ObservedProperties. To request all Things , use the following URL:
https://wyseason.uwyo.edu/sta/v1.1/Things(3)The SensorThings API will respond with a list of available Things as follows, including a @iot.nextLink to get the next set.
Response:
{
"@iot.count": 15,
"value": [
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)",
"@iot.id": 3,
"name": "LB00001",
"description": "LimnoTech lake buoy",
"properties": {
"active": true,
"contactEmail": "sarah.collins@uwyo.edu",
"contactName": "Dr. Sarah Collins",
"deployDate": "2023-07-12",
"projectName": "season_buoys",
"thingType": "lake buoy"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)",
"@iot.id": 4,
"name": "LB00002",
"description": "LimnoTech lake buoy",
"properties": {
"active": true,
"contactEmail": "sarah.collins@uwyo.edu",
"contactName": "Dr. Sarah Collins",
"deployDate": "2023-07-12",
"projectName": "season_buoys",
"thingType": "lake buoy"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(4)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)",
"@iot.id": 8,
"name": "LB00004",
"description": "LimnoTech lake buoy",
"properties": {
"active": true,
"contactEmail": "sarah.collins@uwyo.edu",
"contactName": "Dr. Sarah Collins",
"deployDate": "2023-07-12",
"projectName": "season_buoys",
"thingType": "lake buoy"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(8)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)",
"@iot.id": 9,
"name": "LB00003",
"description": "LimnoTech lake buoy",
"properties": {
"active": true,
"contactEmail": "sarah.collins@uwyo.edu",
"contactName": "Dr. Sarah Collins",
"deployDate": "2023-07-08",
"projectName": "season_buoys",
"thingType": "lake buoy"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(9)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)",
"@iot.id": 11,
"name": "SSN00001",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "FOTM1",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-06-19",
"firstDeployDate": "2024-06-19",
"projectName": "season_FOTM",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(11)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)",
"@iot.id": 12,
"name": "SSN00002",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "FOTM2",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-06-19",
"firstDeployDate": "2024-06-19",
"projectName": "season_FOTM",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(12)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)",
"@iot.id": 13,
"name": "SSN00003",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "FOTM3",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-06-19",
"firstDeployDate": "2024-06-19",
"projectName": "season_FOTM",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(13)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)",
"@iot.id": 14,
"name": "SSN00004",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "FOTM4",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-06-19",
"firstDeployDate": "2024-06-19",
"projectName": "season_FOTM",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(14)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)",
"@iot.id": 15,
"name": "MET00001",
"description": "all in one meteorological station",
"properties": {
"active": true,
"alias": "FOTM5",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-06-19",
"firstDeployDate": "2024-06-19",
"projectName": "season_FOTM",
"thingType": "met station"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(15)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(18)",
"@iot.id": 18,
"name": "SSN00005",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "CC1",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-07-23",
"firstDeployDate": "2024-07-23",
"projectName": "season_CC",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(18)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(18)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(18)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(18)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(18)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(19)",
"@iot.id": 19,
"name": "SSN00006",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "CC2",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-07-23",
"firstDeployDate": "2024-07-23",
"projectName": "season_CC",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(19)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(19)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(19)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(19)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(19)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(20)",
"@iot.id": 20,
"name": "SSN00007",
"description": "soil sensor nest",
"properties": {
"active": true,
"alias": "CC3",
"contactEmail": "Thomas.Rust@uwyo.edu",
"contactName": "Tom Rust",
"deployDate": "2024-07-23",
"firstDeployDate": "2024-07-23",
"projectName": "season_CC",
"thingType": "soil sensor nest"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(20)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(20)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(20)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(20)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(20)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)",
"@iot.id": 22,
"name": "SSN00008",
"description": "Zentra Cloud soil sensor nest",
"properties": {
"active": true,
"alias": "TSS1",
"initialDeployDate": "2024-09-26",
"projects": [
{
"host": "WYSEaSON",
"name": "WYACT",
"managers": [
{
"name": "Tom Rust",
"email": "wyseason@uwyo.edu",
"position": "WYSEaSON Director"
}
],
"partners": [
{
"name": "Teton Science School"
}
],
"organization": "University of Wyoming"
}
],
"thingType": [
"soil sensor nest"
]
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(22)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)",
"@iot.id": 23,
"name": "SSN00009",
"description": "Zentra Cloud soil sensor nest with met station",
"properties": {
"active": true,
"alias": "TSS2",
"initialDeployDate": "2024-09-26",
"projects": [
{
"host": "WYSEaSON",
"name": "WYACT",
"managers": [
{
"name": "Tom Rust",
"email": "wyseason@uwyo.edu",
"position": "WYSEaSON Director"
}
],
"partners": [
{
"name": "Teton Science School"
}
],
"organization": "University of Wyoming"
}
],
"thingType": [
"soil sensor nest",
"met station"
]
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(23)/Datastreams"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)",
"@iot.id": 24,
"name": "SSN00010",
"description": "Zentra Cloud soil sensor nest",
"properties": {
"active": true,
"alias": "TSS3",
"initialDeployDate": "2024-09-26",
"projects": [
{
"host": "WYSEaSON",
"name": "WYACT",
"managers": [
{
"name": "Tom Rust",
"email": "wyseason@uwyo.edu",
"position": "WYSEaSON Director"
}
],
"partners": [
{
"name": "Teton Science School"
}
],
"organization": "University of Wyoming"
}
],
"thingType": [
"soil sensor nest"
]
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(24)/Datastreams"
}
]
}Get One of a Type
This request provides information related to a specific device. In this instance, the response includes the Thing record for Jackson Lake in Wyoming. In the example, one can see that the property @iot.id has the value ‘3’, adding this identifier at the end of the URL in parentheses () creates the URL for this specific thing. (Alternatively, this URL is provided in the @iot.selfLink attribute of this object):
https://wyseason.uwyo.edu/sta/v1.1/ThingsAll other object types can be directly addressed in the same manner.
The response to the request for a specific object (Thing) through this manner appears like this:
Response:
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)",
"@iot.id": 3,
"name": "LB00001",
"description": "LimnoTech lake buoy",
"properties": {
"active": true,
"contactEmail": "sarah.collins@uwyo.edu",
"contactName": "Dr. Sarah Collins",
"deployDate": "2023-07-12",
"projectName": "season_buoys",
"thingType": "lake buoy"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Datastreams"
}Specific Attributes of an Object
Most applications do not require all attributes provided by the SensorThings API object types. While such a reduction in the breadth of the data may not seem especially relevant pertaining to one individual object, when thousands of objects are requested such reduction through filtering can vastly reduce the volume of data being transferred. This is particularly important if one is building a mobile application, which may be accessed over a shaky internet connection! In the following example, the Things response is reduced to individual devices and descriptions with the $select parameter:
https://wyseason.uwyo.edu/sta/v1.1/Things?
$select=@iot.id,description&$top=3
Response:
{
"@iot.count": 16,
"value": [
{
"@iot.id": 3,
"description": "LimnoTech lake buoy"
},
{
"@iot.id": 4,
"description": "LimnoTech lake buoy"
},
{
"@iot.id": 8,
"description": "LimnoTech lake buoy"
}
],
"@iot.nextLink": "https://wyseason.uwyo.edu/sta/v1.1/Things?$top=3&$skip=3&$select=%40iot.id,description&$orderby=%40iot.id+asc&$skipFilter=%28%40iot.id+gt+8%29"
}Deep Select
It is also possible to do a Deep Select, which can be used to gather more information in properties. This extension enables fetching only parts of complex properties, like Thing/properties, Observation/parameters or Location/location.
Syntax and Returned Data
Selected sub-fields are separated by a /. The nesting structure of the returned fields is not changed.
https://wyseason.uwyo.edu/sta/v1.1/Things?
$select=@iot.id,properties/monitoringLocationName,properties/monitoringLocationUrl&$top=3
Response:
{
"@iot.count": 16,
"value": [
{
"@iot.id": 3,
"properties": {
}
},
{
"@iot.id": 4,
"properties": {
}
},
{
"@iot.id": 8,
"properties": {
}
}
],
"@iot.nextLink": "https://wyseason.uwyo.edu/sta/v1.1/Things?$top=3&$skip=3&$select=%40iot.id,properties%2FmonitoringLocationName,properties%2FmonitoringLocationUrl&$orderby=%40iot.id+asc&$skipFilter=%28%40iot.id+gt+8%29"
}Sorting Responses
The orderby request parameter is used to sort a dataset by a specific attribute, allowing the data to be returned in ascending (asc) or descending (desc) order. A common use case is combining orderby with the top parameter to limit the results, such as retrieving the two most recent observation values for a datastream.
For example, the following URL fetches the two latest observations, sorted by phenomenonTime in descending order:
https://wyseason.uwyo.edu/sta/v1.1/Datastreams(3)/Observations?
$orderby=phenomenonTime desc
&$top=2
Response:
{
"value": [
{
"@iot.id": "AR008-331856091114601",
"properties": {
"monitoringLocationUrl": "https://waterdata.usgs.gov/monitoring-location/331856091114601",
"monitoringLocationName": "16S01W10CC1 CH-32 WU"
}
},
{
"@iot.id": "AR008-334933091153501",
"properties": {
"monitoringLocationUrl": "https://waterdata.usgs.gov/monitoring-location/334933091153501",
"monitoringLocationName": "10S02W14DC1 DE-7 WU"
}
},
{
"@iot.id": "AR008-335246091271101",
"properties": {
"monitoringLocationUrl": "https://waterdata.usgs.gov/monitoring-location/335246091271101",
"monitoringLocationName": "09S04W36AB1 DE-1 WU"
}
}
],
"@iot.nextLink": "https://labs.waterdata.usgs.gov/sta/v1.1/Things?$top=3&$skip=3&$select=%40iot.id,properties%2FmonitoringLocationName,properties%2FmonitoringLocationUrl&$orderby=%40iot.id+asc&$skipFilter=%28%40iot.id+gt+%27AR008-335246091271101%27%29"
}Combined Request Parameters
Top-level $options are separated by &.
Items in $select or $expand are separated by ,.
Within a $expand, use ; to separate $options. Use () to clearly specify which request parameters apply to which expanded object type.
https://wyseason.uwyo.edu/sta/v1.1/Things?$expand=Locations($select=id,name;$top=1),Datastreams($select=name,id;$top=1)&$top=1
Response:
{
"@iot.count": 16,
"value": [
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)",
"@iot.id": 3,
"name": "LB00001",
"description": "LimnoTech lake buoy",
"properties": {
"active": true,
"contactEmail": "sarah.collins@uwyo.edu",
"contactName": "Dr. Sarah Collins",
"deployDate": "2023-07-12",
"projectName": "season_buoys",
"thingType": "lake buoy"
},
"restricted": false,
"Locations@iot.count": 1,
"Locations": [
{
"@iot.id": 14,
"name": "Jackson Lake 01"
}
],
"Datastreams@iot.count": 35,
"Datastreams": [
{
"name": "LB00001ATemp",
"@iot.id": 1
}
],
"Datastreams@iot.nextLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Datastreams?$top=1&$skip=1&$select=name,%40iot.id&$orderby=%40iot.id+asc&$skipFilter=%28%40iot.id+gt+1%29",
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/HistoricalLocations",
"Locations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Locations",
"MultiDatastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/MultiDatastreams",
"Projects@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Projects",
"Datastreams@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Things(3)/Datastreams"
}
],
"@iot.nextLink": "https://wyseason.uwyo.edu/sta/v1.1/Things?$top=1&$skip=1&$expand=Locations%28%24top%3D1%3B%24select%3D%40iot.id%2Cname%3B%24orderby%3D%40iot.id+asc%29,Datastreams%28%24top%3D1%3B%24select%3Dname%2C%40iot.id%3B%24orderby%3D%40iot.id+asc%29&$orderby=%40iot.id+asc&$skipFilter=%28%40iot.id+gt+3%29"
}Build a Targeted Query
To get related object types in one request, you can connect them together. For example, you might want to retrieve all Things along with their associated Datastreams.
Breakdown of the Request
$select=@iot.id,description: Retrieves the ID and description of each Thing.
$expand=Datastreams: Includes all Datastreams related to each Thing.
$top=2: Limits the response to 2 Things.
https://wyseason.uwyo.edu/sta/v1.1/Things?\$select=\@iot.id,description&\$expand=Datastreams&\$top=2This request gives you the ID and description of each Thing along with all associated Datastreams, making it easy to see their relationships in one response.
Response Truncated:
{
"@iot.count": 16,
"value": [
{
"@iot.id": 3,
"description": "LimnoTech lake buoy",
"Datastreams@iot.count": 35,
"Datastreams": [
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Datastreams(1)",
"@iot.id": 1,
"name": "LB00001ATemp",
"description": "Outside ambient air temperature ",
"observationType": "Instantaneous",
"unitOfMeasurement": {
"name": "degrees Celsius",
"symbol": "°C",
"definition": ""
},
"observedArea": {
"type": "LineString",
"coordinates": [
[-110.5897, 43.8592],
[-110.6641, 43.9334]
]
},
"phenomenonTime": "2023-07-10T15:50:00Z/2024-10-23T19:10:00Z",
"properties": {
"baseParameter": "airtemp",
"measureType": "temp",
"observedPropId": 1,
"parameterName": "airtemp",
"thingId": 3,
"thingName": "LB00001"
},
"restricted": false
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Datastreams(3)",
"@iot.id": 3,
"name": "LB00001BVolt",
"description": "Average battery voltage ",
"observationType": "Instantaneous",
"unitOfMeasurement": {
"name": "volts",
"symbol": "V",
"definition": ""
},
"observedArea": {
"type": "LineString",
"coordinates": [
[-110.5897, 43.8592],
[-110.6641, 43.9334]
]
},
"phenomenonTime": "2023-07-10T15:50:00Z/2024-10-23T19:10:00Z",
"properties": {
"baseParameter": "vbat",
"measureType": "station",
"observedPropId": 3,
"parameterName": "vbat",
"thingId": 3,
"thingName": "LB00001"
},
"restricted": false
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Datastreams(4)",
"@iot.id": 4,
"name": "LB00001WSpd",
"description": "Surface wind speed",
"observationType": "Instantaneous",
"unitOfMeasurement": {
"name": "meters per second",
"symbol": "m/s",
"definition": "https://en.wikipedia.org/wiki/Metre_per_second"
},
"observedArea": {
"type": "LineString",
"coordinates": [
[-110.5897, 43.8592],
[-110.6641, 43.9334]
]
},
"phenomenonTime": "2023-07-10T15:50:00Z/2024-10-23T19:10:00Z",
"properties": {
"baseParameter": "wspd",
"measureType": "wind",
"observedPropId": 4,
"parameterName": "wspd",
"thingId": 3,
"thingName": "LB00001"
},
"restricted": false
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Datastreams(5)",
"@iot.id": 5,
"name": "LB00001WTemp1m",
"description": "Water temperature measured at 1 meter depth ",
"observationType": "Instantaneous",
"unitOfMeasurement": {
"name": "degrees Celsius",
"symbol": "°C",
"definition": ""
},
"observedArea": {
"type": "LineString",
"coordinates": [
[-110.5897, 43.8592],
[-110.6641, 43.9334]
]
},
"phenomenonTime": "2023-07-10T15:50:00Z/2024-10-23T19:10:00Z",
"properties": {
"baseParameter": "wTemp",
"depth": 1,
"measureType": "water",
"observedPropId": 9,
"parameterName": "wTemp_1m",
"thingId": 3,
"thingName": "LB00001"
},
"restricted": false
},
{
Controlling Content Length
When querying data, it’s essential to control both the length and specific content of the response. By tailoring your request, you can limit the returned information to only the fields that are necessary. For instance, if you’re working with Datastreams and only need an overview of each stream’s identifier and description, you can use the $select parameter. Adding $select to your query allows you to specify fields like id and description within parentheses.
https://wyseason.uwyo.edu/sta/v1.1/Things?
$select=@iot.id,description
&$expand=Datastreams($select=@iot.id,description)&$top=1
Response :
{
"@iot.count": 16,
"value": [
{
"@iot.id": 3,
"description": "LimnoTech lake buoy",
"Datastreams@iot.count": 35,
"Datastreams": [
{
"@iot.id": 1,
"description": "Outside ambient air temperature "
},
{
"@iot.id": 3,
"description": "Average battery voltage "
},
{
"@iot.id": 4,
"description": "Surface wind speed"
},
{
"@iot.id": 5,
"description": "Water temperature measured at 1 meter depth "
},
{
"@iot.id": 6,
"description": "Water temperature measured at 7 meter depth "
},
{
"@iot.id": 7,
"description": "Water temperature measured at 13 meter depth "
},
{
"@iot.id": 53,
"description": "Potential of hydrogen"
},
{
"@iot.id": 54,
"description": "Specific condunctance"
},
{
"@iot.id": 56,
"description": "Dissolved oxygen measured at 1 meter depth"
},
{
"@iot.id": 57,
"description": "Dissolved oxygen at saturation; calculated from dissolved oxygen measurement"
},
{
"@iot.id": 58,
"description": "Relative humidity measured inside the lake buoy enclosure"
},
{
"@iot.id": 59,
"description": "Air temperature measured inside the lake buoy enclosure"
},
{
"@iot.id": 60,
"description": "Oxidation-reduction potential (ORP)"
},
{
"@iot.id": 61,
"description": "Photosynthetically active radiation: average solar radiation"
},
{
"@iot.id": 62,
"description": "Photosynthetically active radiation measured at 9 meters depth"
},
{
"@iot.id": 63,
"description": "Relative humidity"
},
{
"@iot.id": 64,
"description": "Depth of sensor sonde"
},
{
"@iot.id": 65,
"description": "Compass direction from which the wind is blowing"
},
{
"@iot.id": 66,
"description": "Max speed at which wind gusts at the buoy"
},
{
"@iot.id": 67,
"description": "Water temperature measured at 4 meter depth "
},
{
"@iot.id": 68,
"description": "Water temperature measured at 10 meter depth "
},
{
"@iot.id": 69,
"description": "Water temperature measured at 15 meter depth "
},
{
"@iot.id": 70,
"description": "Dew point"
},
{
"@iot.id": 71,
"description": "Air pressure W.R.T. sea level"
},
{
"@iot.id": 80,
"description": "Average vapor pressure"
},
{
"@iot.id": 81,
"description": "Average wind direction (uncorrected)"
},
{
"@iot.id": 82,
"description": "Average compass heading"
},
{
"@iot.id": 83,
"description": "Water temperature measured by sonde at about .75m depth"
},
{
"@iot.id": 84,
"description": "Electrical conductivity"
},
{
"@iot.id": 87,
"description": "Pressure measured at 15 meter depth"
},
{
"@iot.id": 95,
"description": "Turbidity"
},
{
"@iot.id": 187,
"description": "Phycocyanin fluorescence"
},
{
"@iot.id": 188,
"description": "Phycocyanin concentration measured"
},
{
"@iot.id": 189,
"description": "Chlorophyll-a concentration measured"
},
{
"@iot.id": 190,
"description": "Chlorophyll-a fluorescence"
}
]
}
],
"@iot.nextLink": "https://wyseason.uwyo.edu/sta/v1.1/Things?$top=1&$skip=1&$select=%40iot.id,description&$expand=Datastreams%28%24select%3D%40iot.id%2Cdescription%3B%24orderby%3D%40iot.id+asc%29&$orderby=%40iot.id+asc&$skipFilter=%28%40iot.id+gt+3%29"
}
Selecting Distinct Properties
When viewing locations, it’s useful to have a distinct list of properties associated with each one. Using distinct properties allows for tailored customization of each location, ensuring that only relevant, unique data is displayed.
https://wyseason.uwyo.edu/sta/v1.1/Locations?
$select=distinct:properties/HUC,properties/thingID,properties/wcName,properties/county
Response :
{
"@iot.count": 8,
"value": [
{
"properties": {
"county": "Fremont",
"HUC": "100800010201",
"thingID": "LB00004"
}
},
{
"properties": {
"county": "Fremont",
"HUC": "100800010705"
}
},
{
"properties": {
"county": "Fremont",
"HUC": "100800050607",
"wcName": "Boysen",
"thingID": "LB00002"
}
},
{
"properties": {
"county": "Fremont",
"HUC": "100800050607",
"thingID": "LB00003"
}
},
{
"properties": {
"county": "Teton",
"HUC": "170401010406",
"wcName": "Jackson",
"thingID": "LB00001"
}
},
{
"properties": {
"county": "Teton",
"HUC": "170401010608"
}
},
{
"properties": {
"county": "Teton",
"HUC": "170401030104"
}
},
{
"properties": {
}
}
]
}
In this API query, the distinct select function filters the results to show only unique combinations of the specified properties, like HUC, thingID, wcName, and county. This ensures that each location’s data is presented without redundancy, highlighting only distinct sets of information.
Substring Filtering
In addition, this can be combined with other OData operators, such as substringof, which allows for more specific filtering. For example, substringof can be used to select all locations where the county property includes “Teton.”
https://wyseason.uwyo.edu/sta/v1.1/Locations?
$filter=substringof(tolower('Teton'), tolower(properties))
Response :
{
"@iot.count": 9,
"value": [
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(9)",
"@iot.id": 9,
"name": "Fire on the Mountain 1",
"description": "3 miles northeast of Jackson, WY: northeast-facing slope overlooking the National Elk Refuge immediately west of and adjacent to the National Museum of Wildlife Art",
"encodingType": "application/geo+json",
"location": {
"type": "Point",
"coordinates": [-110.7492912, 43.5201677]
},
"properties": {
"HUC": "170401030104",
"alias": "FOTM1",
"county": "Teton",
"state": "WY"
},
"restricted": false,
"GeneratedFeature@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(9)/GeneratedFeature",
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(9)/HistoricalLocations",
"Things@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(9)/Things"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(10)",
"@iot.id": 10,
"name": "Fire on the Mountain 2",
"description": "3 miles northeast of Jackson, WY: northeast-facing slope overlooking the National Elk Refuge immediately west of and adjacent to the National Museum of Wildlife Art",
"encodingType": "application/geo+json",
"location": {
"type": "Point",
"coordinates": [-110.7482241, 43.5217899]
},
"properties": {
"HUC": "170401030104",
"alias": "FOTM2",
"county": "Teton",
"state": "WY"
},
"restricted": false,
"GeneratedFeature@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(10)/GeneratedFeature",
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(10)/HistoricalLocations",
"Things@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(10)/Things"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(11)",
"@iot.id": 11,
"name": "Fire on the Mountain 3",
"description": "3 miles northeast of Jackson, WY: northeast-facing slope overlooking the National Elk Refuge immediately west of and adjacent to the National Museum of Wildlife Art",
"encodingType": "application/geo+json",
"location": {
"type": "Point",
"coordinates": [-110.7475309, 43.521411]
},
"properties": {
"HUC": "170401030104",
"alias": "FOTM3",
"county": "Teton",
"state": "WY"
},
"restricted": false,
"GeneratedFeature@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(11)/GeneratedFeature",
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(11)/HistoricalLocations",
"Things@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(11)/Things"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(12)",
"@iot.id": 12,
"name": "Fire on the Mountain 4",
"description": "3 miles northeast of Jackson, WY: northeast-facing slope overlooking the National Elk Refuge immediately west of and adjacent to the National Museum of Wildlife Art",
"encodingType": "application/geo+json",
"location": {
"type": "Point",
"coordinates": [-110.7491843, 43.5203149]
},
"properties": {
"HUC": "170401030104",
"alias": "FOTM4",
"county": "Teton",
"state": "WY"
},
"restricted": false,
"GeneratedFeature@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(12)/GeneratedFeature",
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(12)/HistoricalLocations",
"Things@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(12)/Things"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(13)",
"@iot.id": 13,
"name": "Fire on the Mountain 5",
"description": "3 miles northeast of Jackson, WY: northeast-facing slope overlooking the National Elk Refuge immediately west of and adjacent to the National Museum of Wildlife Art",
"encodingType": "application/geo+json",
"location": {
"type": "Point",
"coordinates": [-110.7480177, 43.5216138]
},
"properties": {
"HUC": "170401030104",
"alias": "FOTM5",
"county": "Teton",
"state": "WY"
},
"restricted": false,
"GeneratedFeature@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(13)/GeneratedFeature",
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(13)/HistoricalLocations",
"Things@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(13)/Things"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(14)",
"@iot.id": 14,
"name": "Jackson Lake 01",
"description": "Jackson Lake: north part of lake, near Leeks marina. NW Wyoming",
"encodingType": "application/geo+json",
"location": {
"type": "Point",
"coordinates": [-110.6641, 43.9334]
},
"properties": {
"HUC": "170401010406",
"county": "Teton",
"state": "WY",
"thingID": "LB00001",
"wcName": "Jackson"
},
"restricted": false,
"GeneratedFeature@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(14)/GeneratedFeature",
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(14)/HistoricalLocations",
"Things@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(14)/Things"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(19)",
"@iot.id": 19,
"name": "Teton Science School 1",
"description": "Sagebrush meadow between 2 aspen groves in a snowtography transect, North of Ditch Road, East of and adjacent to the Teton Science School Kelly campus, about 4 miles northeast of Kelly, WY",
"encodingType": "application/geo+json",
"location": {
"type": "Point",
"coordinates": [-110.5939449, 43.670531]
},
"properties": {
"HUC": "170401010608",
"alias": "TSS1",
"county": "Teton",
"state": "WY"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(19)/HistoricalLocations",
"Things@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(19)/Things"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(20)",
"@iot.id": 20,
"name": "Teton Science School 1",
"description": "Sagebrush meadow between 2 aspen groves in a snowtography transect, North of Ditch Road, East of and adjacent to the Teton Science School Kelly campus, about 4 miles northeast of Kelly, WY",
"encodingType": "application/geo+json",
"location": {
"type": "Point",
"coordinates": [-110.593491, 43.6704675]
},
"properties": {
"HUC": "170401010608",
"alias": "TSS2",
"county": "Teton",
"state": "WY"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(20)/HistoricalLocations",
"Things@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(20)/Things"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(21)",
"@iot.id": 21,
"name": "Teton Science School 3",
"description": "Sagebrush meadow between 2 aspen groves in a snowtography transect, North of Ditch Road, East of and adjacent to the Teton Science School Kelly campus, about 4 miles northeast of Kelly, WY",
"encodingType": "application/geo+json",
"location": {
"type": "Point",
"coordinates": [-110.593019, 43.6704]
},
"properties": {
"HUC": "170401010608",
"alias": "TSS3",
"county": "Teton",
"state": "WY"
},
"restricted": false,
"HistoricalLocations@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(21)/HistoricalLocations",
"Things@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Locations(21)/Things"
}
]
} Response Formats
DataArray
The SensorThings standard includes the Data Array Extension, which provides a more compact and efficient way to format Observation data. In the DataArray result format, JSON keys are removed from individual Observations and returned only once at the top of the response, significantly reducing data redundancy. This format is designed specifically for collections of Observations, where it optimizes data transmission and storage.
https://wyseason.uwyo.edu/sta/v1.1/Datastreams(1)/Observations?
$orderby=phenomenonTime&
$resultFormat=DataArray&
$top=2
Response :
{
"@iot.count": 33072,
"@iot.nextLink": "https://wyseason.uwyo.edu/sta/v1.1/Datastreams(1)/Observations?$top=2&$skip=2&$resultFormat=DataArray&$orderby=phenomenonTime+asc,phenomenonTime+asc,%40iot.id+asc&$skipFilter=%28phenomenonTime+gt+2023-07-10T16%3A00%3A00Z%29",
"value": [
{
"Datastream@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Datastreams(1)",
"components": [
"id",
"phenomenonTime",
"result",
"resultTime",
"resultQuality",
"validTime",
"parameters"
],
"dataArray@iot.count": 2,
"dataArray": [
[2140650, "2023-07-10T15:50:00Z",
"23.3925",
null, null, null, null],
[2140656, "2023-07-10T16:00:00Z",
"24.0375",
null, null, null, null]
]
}
]
}GeoJSON
The GeoJSON result format modifies the server response to GeoJSON, making it suitable for display on a web map. This format returns all “Things” within a specified bounding box, which we use on the monitoring location page maps. To fully structure the GeoJSON output, however, “Locations” data must be retrieved in addition to “Things.”
https://wyseason.uwyo.edu/sta/v1.1/Things(3)?
$expand=Locations($select=name,description,properties,location,@iot.id),Datastreams($select=name,description,@iot.id;
$expand=Observations($select=result,phenomenonTime,parameters,resultQuality,@iot.id;$orderby=phenomenonTime
desc;$top=2))&
$resultFormat=GeoJSON
Response :
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"id": 3,
"name": "LB00001",
"description": "LimnoTech lake buoy",
"properties/active": true,
"properties/contactEmail": "sarah.collins@uwyo.edu",
"properties/contactName": "Dr. Sarah Collins",
"properties/deployDate": "2023-07-12",
"properties/notes": "",
"properties/projectName": "season_buoys",
"properties/retireDate": "",
"properties/thingType": "lake buoy",
"properties/token": "",
"restricted": false,
"Locations/0/name": "Jackson Lake 01",
"Locations/0/description": "Jackson Lake: north part of lake, near Leeks marina. NW Wyoming",
"Locations/0/properties/HUC": "170401010406",
"Locations/0/properties/county": "Teton",
"Locations/0/properties/emptyProp2": "",
"Locations/0/properties/emptyProp3": "",
"Locations/0/properties/state": "WY",
"Locations/0/properties/thingID": "LB00001",
"Locations/0/properties/wcName": "Jackson",
"Locations/0/id": 14,
"Datastreams/0/name": "LB00001ATemp",
"Datastreams/0/description": "Outside ambient air temperature ",
"Datastreams/0/id": 1,
"Datastreams/0/Observations/0/result": "8.1",
"Datastreams/0/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/0/Observations/0/id": 8479142,
"Datastreams/0/Observations/1/result": "8.4",
"Datastreams/0/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/0/Observations/1/id": 8478789,
"Datastreams/1/name": "LB00001BVolt",
"Datastreams/1/description": "Average battery voltage ",
"Datastreams/1/id": 3,
"Datastreams/1/Observations/0/result": "13.3",
"Datastreams/1/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/1/Observations/0/id": 8479139,
"Datastreams/1/Observations/1/result": "13.3",
"Datastreams/1/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/1/Observations/1/id": 8478786,
"Datastreams/2/name": "LB00001WSpd",
"Datastreams/2/description": "Surface wind speed",
"Datastreams/2/id": 4,
"Datastreams/2/Observations/0/result": "6.3",
"Datastreams/2/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/2/Observations/0/id": 8479146,
"Datastreams/2/Observations/1/result": "8.3",
"Datastreams/2/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/2/Observations/1/id": 8478793,
"Datastreams/3/name": "LB00001WTemp1m",
"Datastreams/3/description": "Water temperature measured at 1 meter depth ",
"Datastreams/3/id": 5,
"Datastreams/3/Observations/0/result": "9.9",
"Datastreams/3/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/3/Observations/0/id": 8479155,
"Datastreams/3/Observations/1/result": "10",
"Datastreams/3/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/3/Observations/1/id": 8478802,
"Datastreams/4/name": "LB00001WTemp7m",
"Datastreams/4/description": "Water temperature measured at 7 meter depth ",
"Datastreams/4/id": 6,
"Datastreams/4/Observations/0/result": "9.9",
"Datastreams/4/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/4/Observations/0/id": 8479157,
"Datastreams/4/Observations/1/result": "9.9",
"Datastreams/4/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/4/Observations/1/id": 8478804,
"Datastreams/5/name": "LB00001WTemp13m",
"Datastreams/5/description": "Water temperature measured at 13 meter depth ",
"Datastreams/5/id": 7,
"Datastreams/5/Observations/0/result": "9.8",
"Datastreams/5/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/5/Observations/0/id": 8479159,
"Datastreams/5/Observations/1/result": "9.8",
"Datastreams/5/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/5/Observations/1/id": 8478806,
"Datastreams/6/name": "LB00001pH",
"Datastreams/6/description": "Potential of hydrogen",
"Datastreams/6/id": 53,
"Datastreams/6/Observations/0/result": "7.8",
"Datastreams/6/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/6/Observations/0/id": 8479153,
"Datastreams/6/Observations/1/result": "6.5",
"Datastreams/6/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/6/Observations/1/id": 8478800,
"Datastreams/7/name": "LB00001SpCond",
"Datastreams/7/description": "Specific condunctance",
"Datastreams/7/id": 54,
"Datastreams/7/Observations/0/result": "127.9",
"Datastreams/7/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/7/Observations/0/id": 8479150,
"Datastreams/7/Observations/1/result": "128",
"Datastreams/7/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/7/Observations/1/id": 8478797,
"Datastreams/8/name": "LB00001DO",
"Datastreams/8/description": "Dissolved oxygen measured at 1 meter depth",
"Datastreams/8/id": 56,
"Datastreams/8/Observations/0/result": "9.2",
"Datastreams/8/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/8/Observations/0/id": 8479152,
"Datastreams/8/Observations/1/result": "9.2",
"Datastreams/8/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/8/Observations/1/id": 8478799,
"Datastreams/9/name": "LB00001DOSat",
"Datastreams/9/description": "Dissolved oxygen at saturation; calculated from dissolved oxygen measurement",
"Datastreams/9/id": 57,
"Datastreams/9/Observations/0/result": "82",
"Datastreams/9/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/9/Observations/0/id": 8479151,
"Datastreams/9/Observations/1/result": "82",
"Datastreams/9/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/9/Observations/1/id": 8478798,
"Datastreams/10/name": "LB00001EncRH",
"Datastreams/10/description": "Relative humidity measured inside the lake buoy enclosure",
"Datastreams/10/id": 58,
"Datastreams/10/Observations/0/result": "19",
"Datastreams/10/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/10/Observations/0/id": 8479141,
"Datastreams/10/Observations/1/result": "18.8",
"Datastreams/10/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/10/Observations/1/id": 8478788,
"Datastreams/11/name": "LB00001EncTemp",
"Datastreams/11/description": "Air temperature measured inside the lake buoy enclosure",
"Datastreams/11/id": 59,
"Datastreams/11/Observations/0/result": "15.8",
"Datastreams/11/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/11/Observations/0/id": 8479140,
"Datastreams/11/Observations/1/result": "16.1",
"Datastreams/11/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/11/Observations/1/id": 8478787,
"Datastreams/12/name": "LB00001ORP",
"Datastreams/12/description": "Oxidation-reduction potential (ORP)",
"Datastreams/12/id": 60,
"Datastreams/12/Observations/0/result": "0",
"Datastreams/12/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/12/Observations/0/id": 8479154,
"Datastreams/12/Observations/1/result": "0",
"Datastreams/12/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/12/Observations/1/id": 8478801,
"Datastreams/13/name": "LB00001PAR",
"Datastreams/13/description": "Photosynthetically active radiation: average solar radiation",
"Datastreams/13/id": 61,
"Datastreams/13/Observations/0/result": "277.4",
"Datastreams/13/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/13/Observations/0/id": 8479149,
"Datastreams/13/Observations/1/result": "233.3",
"Datastreams/13/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/13/Observations/1/id": 8478796,
"Datastreams/14/name": "LB00001PAR9m",
"Datastreams/14/description": "Photosynthetically active radiation measured at 9 meters depth",
"Datastreams/14/id": 62,
"Datastreams/14/Observations/0/result": "27.8",
"Datastreams/14/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/14/Observations/0/id": 8479160,
"Datastreams/14/Observations/1/result": "17",
"Datastreams/14/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/14/Observations/1/id": 8478807,
"Datastreams/15/name": "LB00001RH",
"Datastreams/15/description": "Relative humidity",
"Datastreams/15/id": 63,
"Datastreams/15/Observations/0/result": "55.6",
"Datastreams/15/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/15/Observations/0/id": 8479143,
"Datastreams/15/Observations/1/result": "53.6",
"Datastreams/15/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/15/Observations/1/id": 8478790,
"Datastreams/16/name": "LB00001SonDep",
"Datastreams/16/description": "Depth of sensor sonde",
"Datastreams/16/id": 64,
"Datastreams/16/Observations/0/result": "0.344",
"Datastreams/16/Observations/0/phenomenonTime": "2023-11-09T11:20:00Z",
"Datastreams/16/Observations/0/id": 2384372,
"Datastreams/16/Observations/1/result": "0.344",
"Datastreams/16/Observations/1/phenomenonTime": "2023-11-09T11:10:00Z",
"Datastreams/16/Observations/1/id": 2384368,
"Datastreams/17/name": "LB00001WDir",
"Datastreams/17/description": "Compass direction from which the wind is blowing",
"Datastreams/17/id": 65,
"Datastreams/17/Observations/0/result": "194.4",
"Datastreams/17/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/17/Observations/0/id": 8479148,
"Datastreams/17/Observations/1/result": "183.2",
"Datastreams/17/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/17/Observations/1/id": 8478795,
"Datastreams/18/name": "LB00001WGst",
"Datastreams/18/description": "Max speed at which wind gusts at the buoy",
"Datastreams/18/id": 66,
"Datastreams/18/Observations/0/result": "8.7",
"Datastreams/18/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/18/Observations/0/id": 8479147,
"Datastreams/18/Observations/1/result": "11.9",
"Datastreams/18/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/18/Observations/1/id": 8478794,
"Datastreams/19/name": "LB00001WTemp4m",
"Datastreams/19/description": "Water temperature measured at 4 meter depth ",
"Datastreams/19/id": 67,
"Datastreams/19/Observations/0/result": "9.9",
"Datastreams/19/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/19/Observations/0/id": 8479156,
"Datastreams/19/Observations/1/result": "9.9",
"Datastreams/19/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/19/Observations/1/id": 8478803,
"Datastreams/20/name": "LB00001WTemp10m",
"Datastreams/20/description": "Water temperature measured at 10 meter depth ",
"Datastreams/20/id": 68,
"Datastreams/20/Observations/0/result": "9.8",
"Datastreams/20/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/20/Observations/0/id": 8479158,
"Datastreams/20/Observations/1/result": "9.8",
"Datastreams/20/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/20/Observations/1/id": 8478805,
"Datastreams/21/name": "LB00001WTemp15m",
"Datastreams/21/description": "Water temperature measured at 15 meter depth ",
"Datastreams/21/id": 69,
"Datastreams/21/Observations/0/result": "9.7",
"Datastreams/21/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/21/Observations/0/id": 8479161,
"Datastreams/21/Observations/1/result": "9.7",
"Datastreams/21/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/21/Observations/1/id": 8478808,
"Datastreams/22/name": "LB00001DwPnt",
"Datastreams/22/description": "Dew point",
"Datastreams/22/id": 70,
"Datastreams/22/Observations/0/result": "-0.2",
"Datastreams/22/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/22/Observations/0/id": 8479144,
"Datastreams/22/Observations/1/result": "-0.5",
"Datastreams/22/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/22/Observations/1/id": 8478791,
"Datastreams/23/name": "LB00001Baro",
"Datastreams/23/description": "Air pressure W.R.T. sea level",
"Datastreams/23/id": 71,
"Datastreams/23/Observations/0/result": "802.4",
"Datastreams/23/Observations/0/phenomenonTime": "2024-10-28T20:10:00Z",
"Datastreams/23/Observations/0/id": 8479145,
"Datastreams/23/Observations/1/result": "802.4",
"Datastreams/23/Observations/1/phenomenonTime": "2024-10-28T20:00:00Z",
"Datastreams/23/Observations/1/id": 8478792,
"Datastreams/24/name": "LB00001VPress",
"Datastreams/24/description": "Average vapor pressure",
"Datastreams/24/id": 80,
"Datastreams/24/Observations/0/result": "4.086167",
"Datastreams/24/Observations/0/phenomenonTime": "2023-11-09T11:20:00Z",
"Datastreams/24/Observations/0/id": 2303247,
"Datastreams/24/Observations/1/result": "4.11425",
"Datastreams/24/Observations/1/phenomenonTime": "2023-11-09T11:10:00Z",
"Datastreams/24/Observations/1/id": 2303244,
"Datastreams/25/name": "LB00001AvWDir",
"Datastreams/25/description": "Average wind direction (uncorrected)",
"Datastreams/25/id": 81,
"Datastreams/25/Observations/0/result": "336",
"Datastreams/25/Observations/0/phenomenonTime": "2023-11-09T11:20:00Z",
"Datastreams/25/Observations/0/id": 2248755,
"Datastreams/25/Observations/1/result": "340.8",
"Datastreams/25/Observations/1/phenomenonTime": "2023-11-09T11:10:00Z",
"Datastreams/25/Observations/1/id": 2248751,
"Datastreams/26/name": "LB00001AvComp",
"Datastreams/26/description": "Average compass heading",
"Datastreams/26/id": 82,
"Datastreams/26/Observations/0/result": "201.2",
"Datastreams/26/Observations/0/phenomenonTime": "2023-11-09T11:20:00Z",
"Datastreams/26/Observations/0/id": 2302959,
"Datastreams/26/Observations/1/result": "199.8",
"Datastreams/26/Observations/1/phenomenonTime": "2023-11-09T11:10:00Z",
"Datastreams/26/Observations/1/id": 2302956,
"Datastreams/27/name": "LB00001WTempSon",
"Datastreams/27/description": "Water temperature measured by sonde at about .75m depth",
"Datastreams/27/id": 83,
"Datastreams/27/Observations/0/result": "6.84",
"Datastreams/27/Observations/0/phenomenonTime": "2023-11-09T11:20:00Z",
"Datastreams/27/Observations/0/id": 2547484,
"Datastreams/27/Observations/1/result": "6.84",
"Datastreams/27/Observations/1/phenomenonTime": "2023-11-09T11:10:00Z",
"Datastreams/27/Observations/1/id": 2547481,
"Datastreams/28/name": "LB00001ElCond",
"Datastreams/28/description": "Electrical conductivity",
"Datastreams/28/id": 84,
"Datastreams/28/Observations/0/result": "109.79",
"Datastreams/28/Observations/0/phenomenonTime": "2023-11-09T11:20:00Z",
"Datastreams/28/Observations/0/id": 2587927,
"Datastreams/28/Observations/1/result": "109.8",
"Datastreams/28/Observations/1/phenomenonTime": "2023-11-09T11:10:00Z",
"Datastreams/28/Observations/1/id": 2587924,
"Datastreams/29/name": "LB00001Press15m",
"Datastreams/29/description": "Pressure measured at 15 meter depth",
"Datastreams/29/id": 87,
"Datastreams/29/Observations/0/result": "33.14",
"Datastreams/29/Observations/0/phenomenonTime": "2023-11-09T11:20:00Z",
"Datastreams/29/Observations/0/id": 2438647,
"Datastreams/29/Observations/1/result": "33.14",
"Datastreams/29/Observations/1/phenomenonTime": "2023-11-09T11:10:00Z",
"Datastreams/29/Observations/1/id": 2438643,
"Datastreams/30/name": "LB00001Turb",
"Datastreams/30/description": "Turbidity",
"Datastreams/30/id": 95,
"Datastreams/31/name": "LB00001BGAlgRFU",
"Datastreams/31/description": "Phycocyanin fluorescence",
"Datastreams/31/id": 187,
"Datastreams/32/name": "LB00001BGAlgCon",
"Datastreams/32/description": "Phycocyanin concentration measured",
"Datastreams/32/id": 188,
"Datastreams/33/name": "LB00001ChlrCon",
"Datastreams/33/description": "Chlorophyll-a concentration measured",
"Datastreams/33/id": 189,
"Datastreams/34/name": "LB00001ChlrRFU",
"Datastreams/34/description": "Chlorophyll-a fluorescence",
"Datastreams/34/id": 190
},
"geometry": {
"type": "Point",
"coordinates": [-110.6641, 43.9334]
},
"id": "3"
}
]
}This API query retrieves data for a specific “Thing” identified by the ID 3, the Jackson Lake buoy, expanding its associated “Locations” and “Datastreams” to provide detailed information, including the latest observations in GeoJSON format.
CSV
The CSV result format transforms the server’s response into CSV that conforms to RFC 4180 standards. However, mapping a deeply nested JSON data structure to a flat format like CSV can be quite complex, necessitating several compromises. For more detailed information about these compromises and the mapping process, please refer to the FROST-Server Documentation Site.
https://wyseason.uwyo.edu/sta/v1.1/Datastreams(1)/Observations?
$orderby=phenomenonTime&
$resultFormat=CSVFiltering
To filter data based on specific attribute values, the $filter request parameter allows you to request only the data that meets defined criteria. For example, to retrieve all “Outside Ambient Air Temperature” observations where the temperature is above 5.1°C:
https://wyseason.uwyo.edu/sta/v1.1/Datastreams(1)/Observations?
$orderby=phenomenonTime asc
&$filter=result gt '5.1'&$top=5
Response :
{
"@iot.count": 12736,
"value": [
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145845)",
"@iot.id": 2145845,
"phenomenonTime": "2023-07-21T00:00:00Z",
"resultTime": null,
"result": "null",
"Datastream@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145845)/Datastream",
"FeatureOfInterest@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145845)/FeatureOfInterest"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145848)",
"@iot.id": 2145848,
"phenomenonTime": "2023-07-21T00:10:00Z",
"resultTime": null,
"result": "null",
"Datastream@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145848)/Datastream",
"FeatureOfInterest@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145848)/FeatureOfInterest"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145852)",
"@iot.id": 2145852,
"phenomenonTime": "2023-07-21T00:20:00Z",
"resultTime": null,
"result": "null",
"Datastream@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145852)/Datastream",
"FeatureOfInterest@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145852)/FeatureOfInterest"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145856)",
"@iot.id": 2145856,
"phenomenonTime": "2023-07-21T00:30:00Z",
"resultTime": null,
"result": "null",
"Datastream@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145856)/Datastream",
"FeatureOfInterest@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145856)/FeatureOfInterest"
},
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145860)",
"@iot.id": 2145860,
"phenomenonTime": "2023-07-21T00:40:00Z",
"resultTime": null,
"result": "null",
"Datastream@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145860)/Datastream",
"FeatureOfInterest@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(2145860)/FeatureOfInterest"
}
],
"@iot.nextLink": "https://wyseason.uwyo.edu/sta/v1.1/Datastreams(1)/Observations?$top=5&$skip=5&$filter=%28result+gt+%275.1%27%29&$orderby=phenomenonTime+asc,phenomenonTime+asc,%40iot.id+asc&$skipFilter=%28phenomenonTime+gt+2023-07-21T00%3A40%3A00Z%29"
}There are extensive additonal filter options in SensorThings that allow for nearly unlimited flexibility in crafting a query. The following links are to specific components of the Frost Server documentation site .
Filtering
Counts
To determine the number of available objects of a specific type in the API, use the $count=true parameter. This parameter, when added to the request URL, returns an @iot.count attribute in the response, indicating the total number of objects available.
Additionally, the $top parameter can specify the maximum number of objects to return. For example, $top=4 limits the response to four objects.
In the following example, $orderby=phenomenonTime desc sorts observations by time in descending order, $top=1 retrieves only the latest observation, and $count=true provides the total count of available observations:
https://wyseason.uwyo.edu/sta/v1.1/Datastreams(1)/Observations?
$orderby=phenomenonTime
desc&$top=1&$count=true
Response :
{
"@iot.count": 33478,
"value": [
{
"@iot.selfLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(8706990)",
"@iot.id": 8706990,
"phenomenonTime": "2024-10-31T15:20:00Z",
"resultTime": null,
"result": "-3.1",
"Datastream@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(8706990)/Datastream",
"FeatureOfInterest@iot.navigationLink": "https://wyseason.uwyo.edu/sta/v1.1/Observations(8706990)/FeatureOfInterest"
}
],
"@iot.nextLink": "https://wyseason.uwyo.edu/sta/v1.1/Datastreams(1)/Observations?$top=1&$skip=1&$orderby=phenomenonTime+desc,phenomenonTime+asc,%40iot.id+asc&$count=true&$skipFilter=%28phenomenonTime+lt+2024-10-31T15%3A20%3A00Z%29"
}