Skip Navigation Links weather.gov 
NOAA logo-Select to go to the NOAA homepage NDBC Title GraphicClick to go to NDBC home page   Select to go to the NWS homepage
Home News Organization
 
 Observations
    IOOS® DIF Station List
    Sensor Observation Service
    Web Coverage Service
    Web Map Service

 Program Info
    About NDBC
     Met/Ocean
          Moored Buoy
          C-MAN
    TAO
    DART
    VOS
    CSP
    IOOS® DAC

 SOS Software/Documentation
 FAQ
 Contact Us
 Links
 
USA.gov is the U.S. government's official web portal to all federal, state and local government web resources and services.

IOOS Logo

IOOSŪ Sensor Observation Service (SOS)

Software

Link to SOS server:

Available Functions:

  • GetCapabilities - This function returns metadata about this service.
    Parameters include:
    • request = GetCapabilities
    • service = SOS
    • sections - (optional parameter) When specified, this idenitifies the sections of the GetCapabilities response to be returned to the client. The user may specify one or more values in a comma-separated list. If omitted, all sections are returned. Valid values are:
      • ServiceIdentification
      • ServiceProvider
      • OperationsMetadata
      • Contents
      • All

  • DescribeSensor - This function returns detailed sensor charactertistics.
    (Not fully implemented. Returns metadata for DART® stations, but only returns partial metadata for other stations.)
    Parameters include:
    • request = DescribeSensor
    • OutputFormat = text/xml;subtype="sensorML/1.0.1"
    • procedure = urn of sensor, station or network to describe (see procedure in GetCapabilities response)
    • service = SOS
    • version = 1.0.0

  • GetObservation - This function returns observation data of the specified type for the stations within the specified start and stop dates. GML responses are not provided for the new observed properties (air_pressure_at_sea_level, air_temperature and sea_water_electrical_conductivity).
    Parameters include:
    • request = GetObservation
    • service = SOS
    • version = 1.0.0
    • offering = urn:ioos:station:wmo::<station ID> for single station or urn:ioos:network:noaa.nws.ndbc:all for use with collections. Other networks may be added in the future.
    • observedproperty = one of the following:
      • air_pressure_at_sea_level
      • air_temperature
      • currents
      • sea_floor_depth_below_sea_surface (water level for tsunami stations)
      • sea_water_electrical_conductivity
      • sea_water_salinity
      • sea_water_temperature
      • waves
      • winds
    • responseformat = one of the following:
      • text/xml;subtype="om/1.0.0"
        provides SWE Common response with embedded CSV.
      • text/csv
        provides comma-separated-values (CSV) response.
      • text/tab-separated-values
        provides tab-separated-values (TSV) response.
      • application/vnd.google-earth.kml+xml
        provides KML/JSON response. Note that this KML/JSON response uses embedded Javascript which restricts it to Google Earth 5.
      • text/xml;schema="ioos/0.6.1"
        provideds GML response for display.
      • application/ioos+xml;version=0.6.1
        provides GML response for use in applications.
    • eventtime (optional parameter) = <DateTime or DateTime1/DateTime2 or latest>
      • DateTime is formatted as 2008-06-04-T00:00:00Z or 2008-06-04-T00:00Z. At this time, only the seconds are optional.
      • When this parameter is set to "latest", the most recent observation is returned.
      • Data requests are limited to 31 days.
    • featureofinterest (optional parameter) = one of the following:
      • A bounding box coded as: BBOX:<min_lon>,<min_lat>,<max_lon>,<max_lat>
      • A named feature of interest from the getCapabilities response. NDBC currently supports only DART® (tsunami event) features of interest. You can view data from these named features of interest on the Feature of Interest Demonstration Page.

Sample Requests

GetCapabilities

DescribeSensor

GetObservation for air_pressure_at_sea_level

TypeStation SelectionTime SelectionOutput Format
GMLCSVTSVKMLSWE
Single pointStation 41012Most recent observation   CSV TSV KML SWE
Single pointStation 41012Observation for a specific time   CSV TSV KML SWE
Single pointStation 41012Observations for a time range   CSV TSV KML SWE
Collection of Single PointsAll stations in the networkMost recent observations   CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a specific time   CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a time range   CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WMost recent observations   CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WObservations for a specific time   CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WObservations for a time range   CSV TSV KML SWE

GetObservation for air_temperature

TypeStation SelectionTime SelectionOutput Format
GMLCSVTSVKMLSWE
Single pointStation 41012Most recent observation   CSV TSV KML SWE
Single pointStation 41012Observation for a specific time   CSV TSV KML SWE
Single pointStation 41012Observations for a time range   CSV TSV KML SWE
Collection of Single PointsAll stations in the networkMost recent observations   CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a specific time   CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a time range   CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WMost recent observations   CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WObservations for a specific time   CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WObservations for a time range   CSV TSV KML SWE

GetObservation for currents

TypeStation SelectionTime SelectionOutput Format
GMLCSVTSVKMLSWE
Single pointStation 46088Most recent observation GML CSV TSV KML SWE
Single pointStation 46088Observation for a specific time GML CSV TSV KML SWE
Single pointStation 46088Observations for a time range GML CSV TSV KML SWE
Vertical profileStation 41012Most recent observation GML CSV TSV KML SWE
Vertical profileStation 41012Observation for a specific time GML CSV TSV KML SWE
Vertical profileStation 41012Observations for a time range GML CSV TSV KML SWE
Vertical profileStation 42361 (MMS station)Most recent observation GML CSV TSV KML SWE
Collections of stationsAll stations in the networkMost recent observations GML CSV TSV KML SWE
Collections of stationsAll stations in the networkObservations for a specific time GML CSV TSV KML SWE
Collections of stationsAll stations in the network within a bounding box starting at 28N 89.5W and ending at 28.5N 89WMost recent observations GML CSV TSV KML SWE
Collections of stationsAll stations in the network within a bounding box starting at 28N 89.5W and ending at 28.5N 89WObservations for a specific time GML CSV TSV KML SWE
Collections of stationsAll stations in the network within a bounding box starting at 28N 89.5W and ending at 28.5N 89WObservations for a time range GML CSV TSV KML SWE

The GML response for MMS ADCP data and the CSV/TSV responses for all ADCP data contain nine quality flags. These nine quality flags represent the results of the following quality tests based on their position (left to right) in the flags field:

  • Flag 1 represents the overall bin status.
  • Flag 2 represents the ADCP Built-In Test (BIT) status.
  • Flag 3 represents the Error Velocity test status.
  • Flag 4 represents the Percent Good test status.
  • Flag 5 represents the Correlation Magnitude test status.
  • Flag 6 represents the Vertical Velocity test status.
  • Flag 7 represents the North Horizontal Velocity test status.
  • Flag 8 represents the East Horizontal Velocity test status.
  • Flag 9 represents the Echo Intensity test status.

Valid flag values are:

  • 0 = quality not evaluated;
  • 1 = failed quality test;
  • 2 = questionable or suspect data;
  • 3 = good data/passed quality test; and
  • 9 = missing data.

GetObservation for sea_floor_depth_below_sea_surface

TypeStation SelectionTime SelectionOutput Format
GMLCSVTSVKMLSWE
Single pointStation 46403Most recent observation GML CSV TSV KML SWE
Single pointStation 46403Observation for a specific time GML CSV TSV KML SWE
Single pointStation 46403Observations for a time range GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkMost recent observations GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a specific time GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a time range GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 35N 65WMost recent observations GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 35N 65WObservations for a specific time GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 35N 65WObservations for a time range GML CSV TSV KML SWE

GetObservation for sea_water_electrical_conductivity

TypeStation SelectionTime SelectionOutput Format
GMLCSVTSVKMLSWE
Single pointStation 41012Most recent observation   CSV TSV KML SWE
Single pointStation 41012Observation for a specific time   CSV TSV KML SWE
Single pointStation 41012Observations for a time range   CSV TSV KML SWE
Collection of Single PointsAll stations in the networkMost recent observations   CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a specific time   CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a time range   CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 80WMost recent observations   CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 80WObservations for a specific time   CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 80WObservations for a time range   CSV TSV KML SWE

GetObservation for sea_water_salinity

TypeStation SelectionTime SelectionOutput Format
GMLCSVTSVKMLSWE
Single pointStation 41012Most recent observation GML CSV TSV KML SWE
Single pointStation 41012Observation for a specific time GML CSV TSV KML SWE
Single pointStation 41012Observations for a time range GML CSV TSV KML SWE
Single pointStation 48900 (glider)Most recent observation   CSV TSV   SWE
Single pointStation 48900 (glider)Observation for a specific time   CSV TSV   SWE
TrajectoryStation 48900 (glider)Observations for a time range   CSV TSV   SWE
Gliders are not available in GML and KML collections.
Collection of Single PointsAll stations in the networkMost recent observations GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a specific time GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a time range GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 35N 70WMost recent observations GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 35N 70WObservations for a specific time GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 35N 70WObservations for a time range GML CSV TSV KML SWE

GetObservation for sea_water_temperature

TypeStation SelectionTime SelectionOutput Format
GMLCSVTSVKMLSWE
Single pointStation 41012Most recent observation GML CSV TSV KML SWE
Single pointStation 41012Observation for a specific time GML CSV TSV KML SWE
Single pointStation 41012Observations for a time range GML CSV TSV KML SWE
Single pointStation 48900 (glider)Most recent observation   CSV TSV   SWE
Single pointStation 48900 (glider)Observation for a specific time   CSV TSV   SWE
TrajectoryStation 48900 (glider)Observations for a time range   CSV TSV   SWE
Gliders are not available in GML and KML collections.
Collection of Single PointsAll stations in the networkMost recent observations GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a specific time GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a time range GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WMost recent observations GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WObservations for a specific time GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WObservations for a time range GML CSV TSV KML SWE

GetObservation for waves

TypeStation SelectionTime SelectionOutput Format
GMLCSVTSVKMLSWE
Single pointStation 42040Most recent observation GML CSV TSV KML SWE
Single pointStation 42040Observation for a specific time GML CSV TSV KML SWE
Single pointStation 42040Observations for a time range GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkMost recent observations GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a specific time GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a time range GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WMost recent observations GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WObservations for a specific time GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WObservations for a time range GML CSV TSV KML SWE

GetObservation for winds

TypeStation SelectionTime SelectionOutput Format
GMLCSVTSVKMLSWE
Single pointStation 41012Most recent observation GML CSV TSV KML SWE
Single pointStation 41012Observation for a specific time GML CSV TSV KML SWE
Single pointStation 41012Observations for a time range GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkMost recent observations GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a specific time GML CSV TSV KML SWE
Collection of Single PointsAll stations in the networkObservations for a time range GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WMost recent observations GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WObservations for a specific time GML CSV TSV KML SWE
Collection of Single PointsAll stations in the network within a bounding box starting at 25N 90W and ending at 30N 85WObservations for a time range GML CSV TSV KML SWE

Sample page using XSL

There is a sample page which fetches the most recent ocean currents observation for a given station via a GET method and transforms the XML via XSL to HTML for display in the browser. Some sample links are:

Station List

IOOS® DIF Station List

PowerPoint Presentation

NDBC presentation on IOOS® DIF SOS project

Alternate Data Access

Access data via map
Access data via KML (Temporary Demo)


U.S. Dept. of Commerce
National Oceanic and Atmospheric Administration
National Weather Service
National Data Buoy Center
    Bldg. 3205
    Stennis Space Center, MS 39529
Feedback
Page last modified: February 14, 2014
Disclaimer
Credits
Glossary
Privacy Policy
About Us
Career Opportunities