Stations
========

Nearest Station
---------------

Stations are sorted nearest to farthest and include the distance from the requested point in kilometers.

::

    GET /stations/{latitude}/{longitude}

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

========== ========= ==================================================== ===================================== ================================== ==============
Name       Type      Description                                          Accepted Values / Range               Default                            Example
========== ========= ==================================================== ===================================== ================================== ==============
limit      number    The maximum number of results to return.             10, 20, 30                            10                                 40
radius     number    Range limit in kilometers of stations from point.    10, 50, 100                           100                                50
start      IS0 8601  Earliest date/time of interest for station obs.      Any valid ISO 8601 date/time string   24 hours before latest observation ``2016-01-01``
end        IS0 8601  Latest date/time of interest for station obs.        Any valid ISO 8601 date/time string   Date/time of latest observation    ``2016-12-31``
========== ========= ==================================================== ===================================== ================================== ==============

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

::

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

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

::

        [{
          "distance": 37.1076508903,
          "location": {
            "latitude": 34.804,
            "elevation": 309.7,
            "longitude": -96.671
          },
          "id": "722044-53930",
          "earliest_recorded_at": "2006-01-01T00:00:00Z",
          "latest_recorded_at": "2016-11-24T00:00:00Z",
          "description": "ADA MUNICIPAL AIRPORT US OK KADH"
         },
         ...,
         {
          "distance": 48.4865803519,
          "location": {
            "latitude": 35.233,
            "elevation": 345,
            "longitude": -97.45
          },
          "id": "723570-99999",
          "earliest_recorded_at": "2000-02-10T00:00:00Z",
          "latest_recorded_at": "2005-12-31T00:00:00Z",
          "description": "NORMAN/MAX WESTHEIM US OK KOUN"
        }]