Update documentation

- Added Mapquest, Maxmind, OpenCage, OpenStreetMap

Author: DenisCarriere

.gitignore

@@ -1,3 +1,5 @@
+
+geocoder/__pycache__/
 .coverage
 MANIFEST
 coverage.xml
@@ -14,11 +16,12 @@ geocoder.egg-info/
 *.pyc
 *.swp
 *.egg
+*.pyo
 env/
 
 .workon
 
 t.py
 
 t2.py
-dist
+dist

docs/index.rst

@@ -68,9 +68,13 @@ Detailed information about each individual provider that are within Geocoder.
     providers/ArcGIS.rst
     providers/Baidu.rst
     providers/Bing.rst
+    providers/CanadaPost.rst
     providers/Google.rst
     providers/Mapbox.rst
-    providers/CanadaPost.rst
+    providers/MapQuest.rst
+    providers/MaxMind.rst
+    providers/OpenCage.rst
+    providers/OpenStreetMap.rst
     providers/FreeGeoIP.rst
     providers/Geocoder-ca.rst
     providers/GeoOttawa.rst

docs/providers/IPInfo.rst

@@ -1,7 +1,7 @@
-IP Info.io (IP Address)
-=======================
+IP Info.io
+==========
 
-Use the ipinfo.io IP lookup API to quickly and simply integrate IP geolocation 
+Use the IPInfo.io IP lookup API to quickly and simply integrate IP geolocation 
 into your script or website. Save yourself the hassle of setting up local GeoIP 
 libraries and having to remember to regularly update the data.
 

docs/providers/MapQuest.md

@@ -0,0 +1,41 @@
+MapQuest
+========
+
+The geocoding service enables you to take an address and get the
+associated latitude and longitude. You can also use any latitude
+and longitude pair and get the associated address. Three types of
+geocoding are offered: address, reverse, and batch.
+Using Geocoder you can retrieve MapQuest's geocoded data from Geocoding Service.
+
+Examples
+~~~~~~~~
+
+Basic Geocoding
+---------------
+
+.. code-block:: python
+
+    >>> import geocoder
+    >>> g = geocoder.mapquest('San Francisco, CA')
+    >>> g.json
+    ...
+
+Command Line Interface
+----------------------
+
+.. code-block:: bash
+
+    $ geocode 'San Francisco, CA' --provider mapquest --out geojson
+
+Parameters
+----------
+
+- `location`: Your search location you want geocoded.
+- `method`: (default=geocode) Use the following:
+    - geocode
+
+References
+----------
+
+- `Mapquest Geocoding Service <http://www.mapquestapi.com/geocoding/>`_
+

docs/providers/MapQuest.rst

@@ -0,0 +1,62 @@
+MaxMind
+=======
+
+MaxMind's GeoIP2 products enable you to identify the location,
+organization, connection speed, and user type of your Internet
+visitors. The GeoIP2 databases are among the most popular and
+accurate IP geolocation databases available.
+Using Geocoder you can retrieve Maxmind's geocoded data from MaxMind's GeoIP2.
+
+Examples
+~~~~~~~~
+
+Basic Geocoding
+---------------
+
+.. code-block:: python
+
+    >>> import geocoder
+    >>> g = geocoder.maxmind('199.7.157.0')
+    >>> g.latlng
+    [45.413140, -75.656703]
+    >>> g.city
+    'Toronto'
+    >>> g.json
+    ...
+
+Lookup your own IP
+------------------
+
+To retrieve your own IP address, simply have `''` or `'me'` as the input.
+
+.. code-block:: python
+
+    >>> import geocoder
+    >>> g = geocoder.maxmind('')
+    >>> g.latlng
+    [45.413140, -75.656703]
+    >>> g.ip
+    '199.7.157.0'
+    >>> g.json
+    ...
+
+
+Command Line Interface
+----------------------
+
+.. code-block:: bash
+
+    $ geocode '8.8.8.8' --provider maxmind | jq .
+
+Parameters
+~~~~~~~~~~
+
+- `location`: Your search IP Address you want geocoded.
+- `location`: (optional) `'me'` will return your current IP address's location.
+- `method`: (default=geocode) Use the following:
+  - geocode
+
+References
+~~~~~~~~~~
+
+- `MaxMind's GeoIP2 <https://www.maxmind.com/en/geolocation_landing>`_

docs/providers/MaxMind.md

@@ -0,0 +1,42 @@
+Opencage
+========
+
+OpenCage Geocoder simple, easy, and open geocoding for the entire world
+Our API combines multiple geocoding systems in the background.
+Each is optimized for different parts of the world and types of requests.We aggregate the best results from open data sources and algorithms so you don't have to.
+Each is optimized for different parts of the world and types of requests.
+Using Geocoder you can retrieve OpenCage's geocoded data from OpenCage Geocoding Services.
+
+Examples
+~~~~~~~~
+
+Basic Geocoding
+---------------
+
+.. code-block:: python
+
+    >>> import geocoder
+    >>> g = geocoder.opencage('San Francisco, CA')
+    >>> g.json
+    ...
+
+Command Line Interface
+----------------------
+
+.. code-block:: bash
+
+    $ geocode 'San Francisco, CA' --provider opencage --out geojson | jq .
+
+Parameters
+----------
+
+- `location`: Your search location you want geocoded.
+- `key`: (optional) use your own API Key from OpenCage.
+- `method`: (default=geocode) Use the following:
+    - geocode
+
+References
+----------
+
+- `OpenCage Geocoding Services <http://geocoder.opencagedata.com/api.html>`_
+