Metadata-Version: 1.1
Name: geocoder
Version: 1.7.2
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: Python Geocoder

        ===============

        

        .. 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

        

        .. image:: https://travis-ci.org/DenisCarriere/geocoder.svg?branch=master

                :target: https://travis-ci.org/DenisCarriere/geocoder

        

        .. image:: https://coveralls.io/repos/DenisCarriere/geocoder/badge.svg?branch=master&service=github

                :target: https://coveralls.io/github/DenisCarriere/geocoder?branch=master

        

        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
