Metadata-Version: 1.0
Name: geocoder
Version: 1.5.1
Summary: Geocoder is a simple and consistent geocoding library.
Home-page: https://github.com/DenisCarriere/geocoder
Author: Denis Carriere
Author-email: carriere.denis@gmail.com
License: The MIT License
Download-URL: https://github.com/DenisCarriere/geocoder
Description: Geocoder: Simple, Consistent
        ============================
        
        .. image:: https://img.shields.io/pypi/v/geocoder.svg
            :target: https://pypi.python.org/pypi/geocoder
        
        .. image:: https://img.shields.io/pypi/dm/geocoder.svg
                :target: https://pypi.python.org/pypi/geocoder
        
        Simple and consistent geocoding library written in Python.
        
        Many online providers such as Google & Bing have geocoding services,
        these providers do not include Python libraries and have different
        JSON responses between each other.
        
        It can be very difficult sometimes to parse a particular geocoding provider 
        since each one of them have their own JSON schema. 
        
        Here is a typical example of retrieving a Lat & Lng from Google using Python, 
        things shouldn't be this hard.
        
        .. code-block:: python
        
            >>> import requests
            >>> url = 'https://maps.googleapis.com/maps/api/geocode/json'
            >>> params = {'sensor': 'false', 'address': 'Mountain View, CA'}
            >>> r = requests.get(url, params=params)
            >>> results = r.json()['results']
            >>> location = results[0]['geometry']['location']
            >>> location['lat'], location['lng']
            (37.3860517, -122.0838511)
        
        Now lets use Geocoder to do the same task.
        
        .. code-block:: python
        
            >>> import geocoder
            >>> g = geocoder.google('Mountain View, CA')
            >>> g.latlng
            (37.3860517, -122.0838511)
        
        API Overview
        ============
        
        Many properties are available once the geocoder object is created.
        
        Forward
        -------
        
        .. code-block:: python
        
            >>> import geocoder
            >>> g = geocoder.google('Mountain View, CA')
            >>> g.geojson
            >>> g.json
            >>> g.wkt
            >>> g.osm
            ...
        
        Reverse
        -------
        
        .. code-block:: python
        
            >>> g = geocoder.google([45.15, -75.14], method='reverse')
            >>> g.city
            >>> g.state
            >>> g.state_long
            >>> g.country
            >>> g.country_long
            ...
        
        House Addresses
        ---------------
        
        .. code-block:: python
        
            >>> g = geocoder.google("453 Booth Street, Ottawa ON")
            >>> g.housenumber
            >>> g.postal
            >>> g.street
            >>> g.street_long
            ...
        
        IP Addresses
        ------------
        
        .. code-block:: python
        
            >>> import geocoder
            >>> g = geocoder.ip('199.7.157.0')
            >>> g = geocoder.ip('me')
            >>> g.latlng
            >>> g.city
        
        Command Line Interface
        ----------------------
        
        .. code-block:: bash
        
            $ geocode "Ottawa, ON"  >> ottawa.geojson
            $ geocode "Ottawa, ON" \
                --provide google \
                --out geojson \
                --method geocode
        
        Providers
        =========
        
        .. csv-table::
           :header: Provider, Optimal, Access
           :widths: 20, 15, 15
        
            ArcGIS_, World
            Baidu_, China, API key
            Bing_, World, API key
            CanadaPost_, Canada, API key
            FreeGeoIP_, World
            `Geocoder.ca`_, North America, Rate Limit
            GeoNames_, World, Username
            GeoOttawa_, Ottawa
            Google_, World, Rate Limit
            HERE_, World, API key
            Mapbox_, World, API key
            MapQuest_, World, API key
            MaxMind_, World
            OpenCage_, World, API key
            OpenStreetMap_, World
            TomTom_, World, API key
            What3Words_, World, API key
            Yahoo_, World
            Yandex_, Russia
        
        Installation
        ============
        
        PyPi Install
        ------------
        
        To install Geocoder, simply:
        
        .. code-block:: python
        
            $ pip install geocoder
        
        GitHub Install
        --------------
        
        Installing the latest version from Github:
        
        .. code-block:: python
        
            $ git clone https://github.com/DenisCarriere/geocoder
            $ cd geocoder
            $ python setup.py install
        
        
        Documentation
        =============
        
        https://geocoder.readthedocs.org/
        
        Twitter
        =======
        
        Speak up on Twitter DenisCarriere_ and tell me how you use this Python Geocoder. New updates will be pushed to Twitter Hashtags python_.
        
        Topic not available?
        ====================
        
        If you cannot find a topic you are looking for, please feel free to ask me DenisCarriere_ or post them on the `Github Issues Page`_.
        
        Feedback
        ========
        
        Please feel free to give any feedback on this module. If you find any bugs or any enhancements to recommend please send some of your comments/suggestions to the `Github Issues Page`_.
        
        
        .. _DenisCarriere: https://twitter.com/DenisCarriere
        .. _python: https://twitter.com/search?q=%23python
        .. _`Github Issues Page`: https://github.com/DenisCarriere/geocoder/issues
        
        .. _`Distance Tool`: http://geocoder.readthedocs.org/en/latest/features/Distance/
        .. _Mapbox: http://geocoder.readthedocs.org/en/latest/providers/Mapbox/
        .. _Google: http://geocoder.readthedocs.org/en/latest/providers/Google/
        .. _Bing: http://geocoder.readthedocs.org/en/latest/providers/Bing/
        .. _OpenStreetMap: http://geocoder.readthedocs.org/en/latest/providers/OpenStreetMap/
        .. _HERE: http://geocoder.readthedocs.org/en/latest/providers/HERE/
        .. _TomTom: http://geocoder.readthedocs.org/en/latest/providers/TomTom/
        .. _MapQuest: http://geocoder.readthedocs.org/en/latest/providers/MapQuest/
        .. _OpenCage: http://geocoder.readthedocs.org/en/latest/providers/OpenCage/
        .. _Yahoo: http://geocoder.readthedocs.org/en/latest/providers/Yahoo/
        .. _ArcGIS: http://geocoder.readthedocs.org/en/latest/providers/ArcGIS/
        .. _Yandex: http://geocoder.readthedocs.org/en/latest/providers/Yandex/
        .. _`Geocoder.ca`: http://geocoder.readthedocs.org/en/latest/providers/Geocoder-ca/
        .. _Baidu: http://geocoder.readthedocs.org/en/latest/providers/Baidu/
        .. _GeoOttawa: http://geocoder.readthedocs.org/en/latest/providers/GeoOttawa/
        .. _FreeGeoIP: http://geocoder.readthedocs.org/en/latest/providers/FreeGeoIP/
        .. _MaxMind: http://geocoder.readthedocs.org/en/latest/providers/MaxMind/
        .. _What3Words: http://geocoder.readthedocs.org/en/latest/providers/What3Words/
        .. _CanadaPost: http://geocoder.readthedocs.org/en/latest/providers/CanadaPost/
        .. _GeoNames: http://geocoder.readthedocs.org/en/latest/providers/GeoNames/
        
        .. :changelog:
        
        Release History
        ---------------
        
        1.5.1 (2015-08-09)
        ++++++++++++++++++
        - Updated documentation look and feel
        - Simplified Travis CI testing
        
        1.5.1 (2015-07-31)
        ++++++++++++++++++
        
        **Improvements & Enhancements**
        
        - Added Mapbox Forward & Reverse Geocoding 
        
        **Bugfixes**
        
        - Fixed Bing issues, added user-agent in headers
        
        1.5.0 (2015-07-30)
        ++++++++++++++++++
        
        Converted all core Markdown documentation to RST
        
        **Bugfixes**
        
        - Updated W3W's url to HTTPS
        - Updated OSM's url to HTTPS
        - Added Google Road Long/Short attributes
Keywords: geocoder arcgis tomtom opencage google bing here
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Software Development :: Libraries :: Python Modules
