Skip to main content

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

New Feature - SensorThings API

Feature used for better dashboard and device integration, real-time data access (less than 120 days old), and location metadata.

Date Posted August 3, 2023 Last Updated November 27, 2024
Author Shawna Gregory
Reading Time 1 minutes Share

SensorThings coming soon to WDFN.

Use the SensorThings API to access national-scale data for quicker application development and the ability to map those results. This API provides users with a flexible way to interconnect data, devices, and application over the Web.

Example of a live call showing the latest result for cubic feet per second discharge on the Missouri River.

Example of a live call showing the latest result for cubic feet per second discharge on the Missouri River.

The SensorThings API uses a subset of the Sensorthings data model, so you can pick and choose the information you would like to see.

A representation of the USGS implementation of SensorThings at this time. Each Monitoring Location is a Thing, which is at a location. There can be multiple datastreams of data collected at each Thing. Each datastream is tied to a single observed property and multiple observations.

A representation of the USGS implementation of SensorThings at this time. Each Monitoring Location is a Thing, which is at a location. There can be multiple datastreams of data collected at each Thing. Each datastream is tied to a single observed property and multiple observations.

What can I request?

  • Locations: The physical location of a Thing.
  • Things: A monitoring location or room where a sensor is mounted.
  • Datastreams: An entry point for a time series from a Thing with a sensor.
  • Observations: A single measurement value.
  • ObservedProperties: A description of what is being measured by a sensor at a specific location.

What are my result options?

The SensorThings API provides responses in a standard JSON format but optional parameters can return different formats.

  • DataArray
  • GeoJSON
  • CSV

Questions or Comments?

Our team uses user-centered design processes to determine design and priorities. Let us know if you have any comments about this new tool by emailing wdfn@usgs.gov .

Share:

Related Posts

  • New Feature - All Graphs

    June 6, 2023

    We are excited to announce that a new feature is now available to Monitoring Location Pages as part of our modernization efforts. The All Graphs page will show a series of individual graphs of all current sensor data collected at a single location.

  • New Feature - Explore USGS Water Data

    June 6, 2023

    Locating and filtering data by specific parameters is coming soon! Explore USGS Water Data provides users with a dynamic tool to customize and throttle targeted information to meet the needs of users.

  • New Feature - Combined Location Graphs

    April 19, 2023

    Graphing data for multiple locations on a single graph is here! As part of our modernization effort, we are happy to announce a new page from Water Data for the Nation.

  • New Feature - State Pages

    October 28, 2024

    We are excited to announce new State Pages in Water Data for the Nation. These pages allow users to see current water conditions from all monitoring locations in a state that collect continuous data.

  • New Feature - My Favorites

    March 8, 2024

    We are excited to announce a new page called My Favorites . This page allows users to create a custom list of monitoring locations that can be bookmarked and shared for repeated viewings of key locations.