Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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!


## Install

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

$ 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](
- [Android Samsung Galaxy](

## Python Example

>>> import gpsimage # pip install gpsimage
>>> img ='<image.jpg>')

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

# Altitude in Feet
>>> img.altitude

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

## JSON Results

This example was taken from a Android Samsung Galaxy

>>> import gpsimage # pip install gpsimage
>>> img ='<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

This version
History Node


History Node


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
(10.9 kB) Copy SHA256 Hash SHA256
Source None Aug 18, 2014
(22.4 kB) Copy SHA256 Hash SHA256
Source None Aug 18, 2014

Supported By

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 Google Google Cloud Servers DreamHost DreamHost Log Hosting