geolocation-python 0.1.1a

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.


[](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).


2. Turn On Geocode API.


3. Get your 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).