Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (testpypi.python.org).
Help us improve Python packaging - Donate today!

Geolocation is a simple and clever application which uses google maps api. This application allows you to easily and quickly get information about given localisation. Application returns such information as: country, city, route/street, street number, lat and lng.

Project Description
![Alt text](https://travis-ci.org/slawek87/geolocation-python.svg?branch=master)

[![PyPI version](https://badge.fury.io/py/geolocation-python.svg)](https://pypi.python.org/pypi/geolocation-python/0.1.0)

What is Geolocation?
=====================
Geolocation is a simple and clever application which uses google maps api.
This application allows you to easily and quickly get information about given location.
Application returns such information as:

* country,
* country short form,
* city,
* route/street,
* street number,
* postal code,
* formatted address,
* administrative areas,
* lat,
* lng.


What do You need?
-----------------
To use this application you need to have Google API key.
[Google Maps Documentation](https://developers.google.com/maps/documentation/geocoding/) -- Geocoding

1. Open [APIs console](https://code.google.com/apis/console).

![Alt text](https://github.com/slawek87/geolocation-python/blob/master/docs/images/geocode-1.png?raw=true "APIs console")

2. Turn On Geocode API.

![Alt text](https://github.com/slawek87/geolocation-python/blob/master/docs/images/geocode-2.png?raw=true "Geocode Api")

3. Get your API Key.

![Alt text](https://github.com/slawek87/geolocation-python/blob/master/docs/images/geocode-3.png?raw=true "API KEY")


How to install it?
-------------------
pip install geolocation-python


How to use it?
-----------------------
```python
# -*- coding: utf-8 -*-

from geolocation.google_maps import GoogleMaps

address = "New York City Wall Street 12"

google_maps = GoogleMaps(api_key='your_google_maps_key')

location = google_maps.query(location=address) # sends query to Google Maps.

print location.all() # returns all locations.

my_location = location.first() # returns only first location.

print my_location.city
print my_location.route
print my_location.street_number
print my_location.postal_code

for administrative_area in my_location.administrative_area:
print "%s: %s" % (administrative_area.area_type, administrative_area.name)

print my_location.country
print my_location.country_shortcut

print my_location.formatted_address

print my_location.lat
print my_location.lng
```

More examples you should find [here](https://github.com/slawek87/geolocation-python/tree/master/examples).
Release History

Release History

This version
History Node

0.1.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
geolocation-python3-0.1.1.tar.gz (4.6 kB) Copy SHA256 Checksum SHA256 Source Oct 23, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting