Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

Retrieves GPS data from Geo-referenced images made easy

Project Description

# GPSImage Library

Retrieves GPS data from Geo-referenced Photos.

GPS Image will find all available geo-referenced information from the image.

Every task made easy!

![GPSImage](https://raw.githubusercontent.com/DenisCarriere/gpsimage/master/gpsimage/images/gpsimage.jpg)

## Install

**Requires** PIL module installed, for issues with Windows try to download Pillow.

```bash
$ pip install gpsimage
```

## GPS-Camera Devices

The following GPS-Camera devices have been tested with this GPSImage python module.

If your device is not listed, feel free to send me a photo taken from your device and I will be glad to troubleshoot it.

- [Garmin Montana 650](http://sites.garmin.com/montana/)
- [Android Samsung Galaxy](http://www.samsung.com/us/topic/our-galaxy-smartphones)

## Python Example

```python
>>> import gpsimage # pip install gpsimage
>>> img = gpsimage.open('<image.jpg>')

# Coordinates Latitude & Longitude in Degrees
>>> img.lat, img.lng
45.413140 -75.656703

# Altitude in Feet
>>> img.altitude
142.04025779

# From 0 to 360 Degrees
>>> img.direction
165.974436341
...
```

## JSON Results

This example was taken from a Android Samsung Galaxy

```python
>>> import gpsimage # pip install gpsimage
>>> img = gpsimage.open('<image.jpg>')
>>> img.json

# JSON Results
{'altitude': 79.0,
'datum': 'WGS-84',
'direction': 321.0,
'geometry': {'coordinates': [-76.4515263888889, 44.24509527777778],
'type': 'POINT'},
'height': 2592,
'make': u'Samsung',
'model': u'Galaxy Nexus',
'status': 'OK',
'timestamp': u'2014:08:06 15:29:41',
'width': 1944}
```

## Attributes

### GPS data
- **lat** or **y** - Latitude (Degrees)
- **lng** or **x** - Longitude (Degrees)
- **geometry** - GeoJSON Point
- **altitude** - Elevation Above Mean Sea Level
- **datum** - Coordinate system (Typically WGS84)
- **direction** - Camera orientation (0-360 degrees)
- **ok** - True or False if coordinates exists

### Device Specific
- **timestamp ** - Calendar dates (YYYY-MM-DD HH:MM:SS)
- **model** - Device model (Galaxy Nexus)
- **make** - Device manufacturer (Samsung)

### Standard
- **status** - Checks if everything is ok
- **width** - Dimension of image (Pixels)
- **height** - Dimension of image (Pixels)

## Functions
- **debug** - Generates a report of all the attributes available

Release history Release notifications

This version
History Node

0.0.2

History Node

0.0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
gpsimage-0.0.2.tar.gz (10.9 kB) Copy SHA256 hash SHA256 Source None Aug 18, 2014
gpsimage-0.0.2.zip (22.4 kB) Copy SHA256 hash SHA256 Source None Aug 18, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page