Metadata-Version: 1.1
Name: openweathermap-requests
Version: 0.0.2
Summary: openweathermap requests fetch weather history Pandas DataFrame
Home-page: https://github.com/scls19fr/openweathermap_requests
Author: Sebastien Celles
Author-email: s.celles@gmail.com
License: BSD
Description: .. image:: https://pypip.in/version/openweathermap_requests/badge.svg
            :target: https://pypi.python.org/pypi/openweathermap_requests/
            :alt: Latest Version
        
        .. image:: https://pypip.in/py_versions/openweathermap_requests/badge.svg
            :target: https://pypi.python.org/pypi/openweathermap_requests/
            :alt: Supported Python versions
        
        .. image:: https://pypip.in/format/openweathermap_requests/badge.svg
            :target: https://pypi.python.org/pypi/openweathermap_requests/
            :alt: Download format
        
        .. image:: https://pypip.in/license/openweathermap_requests/badge.svg
            :target: https://pypi.python.org/pypi/openweathermap_requests/
            :alt: License
        
        .. image:: https://pypip.in/status/openweathermap_requests/badge.svg
            :target: https://pypi.python.org/pypi/openweathermap_requests/
            :alt: Development Status
        
        .. image:: https://readthedocs.org/projects/openweathermap-requests/badge/?version=latest
           :target: http://openweathermap-requests.readthedocs.org/en/latest/
           :alt: Documentation Status
        
        .. image:: https://sourcegraph.com/api/repos/github.com/scls19fr/openweathermap_requests/.badges/status.png
           :target: https://sourcegraph.com/github.com/scls19fr/openweathermap_requests
        
        .. image:: https://badges.gitter.im/Join%20Chat.svg
           :target: https://gitter.im/scls19fr/openweathermap_requests?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
        
        .. image:: https://travis-ci.org/scls19fr/openweathermap_requests.svg?branch=master
            :target: https://travis-ci.org/scls19fr/openweathermap_requests
        
        OpenWeatherMap Requests
        =======================
        
        `Python <https://www.python.org/>`__ package to fetch data from `OpenWeatherMap.org <http://openweathermap.org/>`__
        and get `Pandas DataFrame <http://pandas.pydata.org/>`__ with weather history.
        
        Command Line Interface Usage
        ----------------------------
        
        Current weather
        ~~~~~~~~~~~~~~~
        
        Get current weather data
        
        ::
        
            $ python openweathermap_requests.py --lon 0.34189 --lat 46.5798114
        
        
        Historical weather data
        ~~~~~~~~~~~~~~~~~~~~~~~
        
        Fetch historical weather data from nearest weather station of coordinates (lon=0.34189, lat=46.5798114) 
        from 2014/01/01 to 2014/12/01 using:
        
        ::
        
            $ python openweathermap_requests.py --lon 0.34189 --lat 46.5798114 --range 20140101:20141201
        
        
        Library Usage
        -------------
        
        ::
        
            import datetime
            import logging
            logger = logging.getLogger()
            logger.setLevel(logging.DEBUG)
            from openweathermap_requests import OpenWeatherMapRequests
        
            ow = OpenWeatherMapRequests(api_key='', cache_name='cache-openweathermap', expire_after=5*60)
        
            (lon, lat) = (0.34189, 46.5798114) # Poitiers
        
            data = ow.get_weather(lon=lon, lat=lat)  # display current weather data
            print(data)
        
            stations = ow.find_stations_near(lon=lon, lat=lat, cnt=10) # get 10 nearest stations from coordinates (lon, lat)
        
            station_id = stations.iloc[0]['station.id'] # get station_id of nearest station
        
            start_date = datetime.datetime(2014, 1, 1)
            end_date = datetime.datetime(2014, 6, 1)
        
            data = ow.get_historic_weather(station_id, start_date, end_date) # get historic weather from start date to end date
            print(data)
        
        
        Links
        -----
        
        - Documentation can be found at `Read The Docs <http://openweathermap-requests.readthedocs.org/>`__ ;
        - Source code and issue tracking can be found at `GitHub <https://github.com/scls19fr/openweathermap_requests>`__.
        
Keywords: data weather temperature history
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Cython
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Scientific/Engineering
Classifier: License :: OSI Approved :: BSD License
