Observations
============

By Station
----------

You can retrieve up to one month of observations for a station at a time. For a station that reports observations hourly, this is approximately 720 observations.
If no start/end is given, the default date range is the last 24 hours of obs.

::

    GET /stations/{station-id}/observations

Query String Parameters (Optional)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

========== ========= ================================= =========================
Name       Type      Description                       Example
========== ========= ================================= =========================
start      IS0 8601  start date/time string            ``2016-06-01T00:00:00Z``
end        IS0 8601  end date/time string              ``2016-06-02T00:00:00Z``
parameters string    Filter obs with given parameters. precipitation,temperature
========== ========= ================================= =========================

Request Example
~~~~~~~~~~~~~~~

::

    $ curl -n -X GET "https://historical-obs.api.wdtinc.com/stations/722590-03927/observations
      -H "Accept: application/vnd.wdt+json; version=1"

Response Example
~~~~~~~~~~~~~~~~

::

        [{
          "metar": "METAR KADH 010015Z AUTO 35003KT 10SM CLR 03/00 A3042 RMK AO2=",
          "measurements": [
            {
              "parameter": "wind_direction",
              "unit": "degrees",
              "value": 350
            },
            {
              "parameter": "wind_speed",
              "unit": "meters_per_second",
              "value": 1.5
            },
            {
              "parameter": "visibility",
              "unit": "meters",
              "value": 16093
            },
            {
              "parameter": "temperature",
              "unit": "celsius",
              "value": 3
            },
            {
              "parameter": "dewpoint",
              "unit": "celsius",
              "value": 0
            },
            {
              "parameter": "altimeter",
              "unit": "millibars",
              "value": 1030.1
            }
          ],
          "recorded_at": "2016-01-01T00:15:00Z"
         },
         ...,
         {
          "metar": "01/01/16 17:55:02 METAR KADH 012355Z 32003KT 10SM CLR 05/M05 A3047 RMK AO2",
          "measurements": [
            {
              "parameter": "wind_direction",
              "unit": "degrees",
              "value": 320
            },
            {
              "parameter": "wind_speed",
              "unit": "meters_per_second",
              "value": 1.5
            },
            {
              "parameter": "visibility",
              "unit": "meters",
              "value": 16093
            },
            {
              "parameter": "temperature",
              "unit": "celsius",
              "value": 5
            },
            {
              "parameter": "dewpoint",
              "unit": "celsius",
              "value": -5
            },
            {
              "parameter": "cloud_cover",
              "unit": "percent",
              "value": 0
            },
            {
              "parameter": "altimeter",
              "unit": "millibars",
              "value": 1031.8
            }
          ],
          "recorded_at": "2016-01-01T23:55:00Z"
        }]