Add NWS observation api

earthobservations · Nov 20, 2022 · ce9eada · ce9eada
1 parent 03f56be
commit ce9eada
Show file tree

Hide file tree

Showing 15 changed files with 612 additions and 11 deletions.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -5,6 +5,7 @@ Development
 ***********
 
 - Fix bug where duplicates of acquired data would be dropped regarding only the date but not the parameter
+- Add NOAA NWS Observation API
 
 0.48.0 (11.11.2022)
 *******************

diff --git a/README.rst b/README.rst
@@ -151,6 +151,11 @@ EA (Environment Agency)
         - data of river network of UK
         - parameters flow and ground water stage
 
+NWS (NOAA National Weather Service)
+    - Observation
+        - recent observations (last week) of US weather stations
+        - currently the list of stations is not completely right as we use a diverging source!
+
 .. coverage_end_marker
 
 Features

diff --git a/docs/data/coverage/noaa/ghcn.rst b/docs/data/coverage/noaa/ghcn.rst
@@ -7,7 +7,7 @@ Overview
 ********
 
 NOAA Global Historical Climatology Network is a collection of **hourly** weather data put together from multiple weather
-services around the world, even those where at this moment no data is publicly offered. Resolution is fixed on hourly,
+services around the world, even those where at this moment no data is publicly offered. Resolution is fixed on daily,
 because this is the most common and maintainable resolution with most observations practiced all over the world.
 
 Special Parameters

diff --git a/docs/data/coverage/nws.rst b/docs/data/coverage/nws.rst
@@ -0,0 +1,26 @@
+NWS
+####
+
+National Oceanic and Atmospheric Administration - National Weather Service
+
+Overview
+********
+
+License
+*******
+
+Observations
+============
+
+The NOAA NWS Observations cover recent data (last week) of the US. The `NOAA NWS description`_ page
+includes more information on the usage, references, qualities etc.
+
+.. _NOAA NWS description: https://www.weather.gov/documentation/services-web-api
+
+Products
+********
+
+.. toctree::
+   :maxdepth: 1
+
+   nws/observation
diff --git a/docs/data/coverage/nws/observation.rst b/docs/data/coverage/nws/observation.rst
@@ -0,0 +1,23 @@
+Observation
+###########
+
+NWS Observations
+
+Overview
+********
+
+NOAA NWS Observation is a collection of **hourly** weather data from US weather stations. Resolution is fixed on hourly
+and data is provided for the last week.
+
+.. warning::
+
+    Currently we use a somewhat not correct list of stations. For some stations no data may be returned, as they
+    actually don't exist in the NWS Observation network!
+
+Structure
+*********
+
+.. toctree::
+   :maxdepth: 1
+
+   observation/hourly