Skip to main content

Google Maps API client

Project description

Build Status Coverage Status

python-gmaps

Google Maps API client. For full API documentation go to:

http://python-gmaps.readthedocs.org

Why yet another python google maps client?

There are a bunch of libraries for Google Maps Web Service. To name a few: * googlemaps * google.directions

What’s wrong with them? googlemaps uses deprecated google API and forces you to format your parameters instead of using native python datatypes. And what about google.directions? Just take a look inside it’s code…

So here is code for new Google Maps API endpoints. It requires requests, supports native python datatypes and is sweetened with some syntactic sugar. Nothing more. No bells and whistles.

Any contributions (code/issues) are welcome.

Instalation

pip install python-gmaps

Usage

Just import API endpoint of your choice and start querying:

from gmaps import Geocoding
api = Geocoding()

api.geocode("somwhere")
api.reverse(51.123, 21.123)

If you need to use Google Maps API for Business then instantiate your endpoint with api_key param

from gmaps import Geocoding
api = Geocoding(api_key='your_secret_api_key')

Each endpoint method raises adequate exception when status of query is different than OK. It also unpacks results list from Google API output dict so you have one key less to access but it does nothing more. So if Google geocoding api outputs something like:

{
    results: [
    ...
    ],
    status: 'OK'
}

You will get only get list that was inside result value. At least one element returned is always assured, otherwise gmnaps.errors.NoResults exception is raised.

For each API endpoint you can specify: * default sensor value * protocol (http/https) * api key (only for http)

Available endpoints: * Geocoding() * Directions() * Timezone() * Elevation()

For detailed documentation of each endpoint refer to dosctrings or this API documentation. If you need list of available values for some parameters (like geocoding components, languages, regions etc.) refer to Google Maps API docs. These values can change anytime so there is no reason to check for them in this lib - they will be checked anyway.

Changes

0.3.1 (2016-03-23)

  • updated list of trove classifiers

  • nicer long_description on PyPI

  • simplified requirements in setup.py script

0.3.0 (2015-08-31)

  • added two additional optional parameters to reverse geocoding that allow restricting type of results (result_type and location_type) thanks to @20tab

  • added gmaps.polyline.encode() utility function to encode paths using Encoded Polyline Algorithm Format

  • Elevation endpoint added implemented

0.2.1 (2014-11-11)

  • gmaps.errors.GmapException inherits from Exception instead of BaseException

0.2.0 (2014-10-02)

  • fixed lists serialization issue (#1) thanks to @feighter09

  • added pep8 compliance test using flake8

  • pep8 compliance

0.1.1 (2014-05-16)

  • python 3.3 support

0.1.0 (2014-05-09)

  • Timezone endpoint added

0.0.2 (2013-10-03)

  • Directions endpoint added

0.0.1 (2013-10-02)

  • initial release

  • Geocoding endpoint

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-gmaps-0.3.1.tar.gz (11.6 kB view details)

Uploaded Source

Built Distribution

python_gmaps-0.3.1-py2.py3-none-any.whl (13.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file python-gmaps-0.3.1.tar.gz.

File metadata

File hashes

Hashes for python-gmaps-0.3.1.tar.gz
Algorithm Hash digest
SHA256 95a31c6098d6df01211395034328232e38565c6c35cd111329bb0caccd719b63
MD5 8d1a529ba8501f10e35b54fc36a7ab06
BLAKE2b-256 f81a223335d0cd1ae3788b6b5e64325fb54ed8e36d996bfccae7e92774785e18

See more details on using hashes here.

File details

Details for the file python_gmaps-0.3.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for python_gmaps-0.3.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b2b4cd186f2db6e18a1afaff4a3136f97ddf27c250f9bc27c04c36b4b6b69301
MD5 54e347a2b56628c9ccff8e9f555150f4
BLAKE2b-256 711ab5ac46de53b009327e4ce4ae6598069fc60d57e006b86bc40f251a9c9959

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page