Metadata-Version: 1.1
Name: geocoder
Version: 1.6.4
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
            IPInfo_, World
            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/features/Distance/
        .. _Mapbox: http://geocoder.readthedocs.org/providers/Mapbox.html
        .. _Google: http://geocoder.readthedocs.org/providers/Google.html
        .. _Bing: http://geocoder.readthedocs.org/providers/Bing.html
        .. _OpenStreetMap: http://geocoder.readthedocs.org/providers/OpenStreetMap.html
        .. _HERE: http://geocoder.readthedocs.org/providers/HERE.html
        .. _TomTom: http://geocoder.readthedocs.org/providers/TomTom.html
        .. _MapQuest: http://geocoder.readthedocs.org/providers/MapQuest.html
        .. _OpenCage: http://geocoder.readthedocs.org/providers/OpenCage.html
        .. _Yahoo: http://geocoder.readthedocs.org/providers/Yahoo.html
        .. _ArcGIS: http://geocoder.readthedocs.org/providers/ArcGIS.html
        .. _Yandex: http://geocoder.readthedocs.org/providers/Yandex.html
        .. _`Geocoder.ca`: http://geocoder.readthedocs.org/providers/Geocoder-ca.html
        .. _Baidu: http://geocoder.readthedocs.org/providers/Baidu.html
        .. _GeoOttawa: http://geocoder.readthedocs.org/providers/GeoOttawa.html
        .. _FreeGeoIP: http://geocoder.readthedocs.org/providers/FreeGeoIP.html
        .. _MaxMind: http://geocoder.readthedocs.org/providers/MaxMind.html
        .. _What3Words: http://geocoder.readthedocs.org/providers/What3Words.html
        .. _CanadaPost: http://geocoder.readthedocs.org/providers/CanadaPost.html
        .. _GeoNames: http://geocoder.readthedocs.org/providers/GeoNames.html
        .. _IPInfo: http://geocoder.readthedocs.org/providers/IPInfo.html
        
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
