Skip to main content

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

Project details

Download files

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

Source Distributions (22.4 kB view hashes)

Uploaded source

gpsimage-0.0.2.tar.gz (10.9 kB view hashes)

Uploaded source

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