The photoGeoExtractor package extracts geolocation metadata from JPEG photos and exports it to a .csv file, building on this code.

To use, start by uploading your photos to Google Photos, creating an album, and then downloading it via Google Takeout. This is a quick process with a handy tutorial. photoGeoExtractor takes as input either the resulting .zip file or an entire directory of images if unzipped.

Until this package is on PyPI, users can install it manually:

1. Create a virtual environment (here called yourenvname)

    python -m venv yourenvname
   

2. Activate your virtual environment

    source yourenvname/bin/activate # Mac
   
    .\yourenvname\Scripts\activate # Windows
   

3. Navigate to where you'd like to download this repository, and then get it from GitHub

    git clone https://github.com/scarioscia/photoGeoExtractor.git
   

4. Navigate into the newly created directory

    cd ./photoGeoExtractor/
   

5. Install the program

    pip install .
   

The photoGeoExtractor program uses the extract-metadata command to take GPS information and other metadata from photos downloaded via Google Takeout and export it to a table. It takes as input either a directory or a compressed (.zip) file containing the photos. The user defines a filename and location for metadata output.

Replace /path/to/album with your input (directory or .zip file) and /path/to/outfile.csv with your desired output filename and location:

python3 -m photoGeoExtractor extract-metadata --input=/path/to/album --output=/path/to/outfile.csv

By default, the resulting .csv will contain filename, datetime, and GPS columns.

Users can use the optional --all flag to output all available columns.

Users can also specify which columns to output using the optional --custom flag followed by comma-separated column names (e.g., --custom offset_time,offset_time_original,offset_time_digitized,shutter_speed_value).

An example of commands using these flags is included in the tutorial directory.

If you have any suggestions or requests please post an issue or PR, or reach out to Sara Carioscia (scarioscia).