geopic-tag-reader 1.1.1

GeoPicTagReader

GeoVisio is a complete solution for storing and serving your own 📍📷 geolocated pictures (like StreetView / Mapillary).

➡️ Give it a try at panoramax.ign.fr or geovisio.fr !

📦 Components

GeoVisio is modular and made of several components, each of them standardized and ♻️ replaceable.

All of them are 📖 open-source and available online:

🌐 Server	💻 Client
API	Website
Blur API	Web viewer
GeoPic Tag Reader	Command line

📷 GeoPic Tag Reader

This repository only contains the Python library to read and write standardized metadata from geolocated pictures EXIF metadata.

Features

This tool allows you to:

• 🔍 Analyse various EXIF variables to extract standardized metadata for geolocated pictures applications (coordinates, date, orientation, altitude...)
• ✏️ Edit a picture to change its EXIF variables through a simpler command
• 💻 Either as Python code or as a command-line utility

Install

The library can be installed easily, for a quick glance:

pip install geopic_tag_reader
geopic-tag-reader --help

To know more about install and other options, see install documentation.

If at some point you're lost or need help, you can contact us through issues or by email.

Usage

This library can be used both from command-line or as Python module.

As command-line

To see all available commands:

geopic-tag-reader --help

To read metadata from a single picture:

geopic-tag-reader read --image /path/to/my_image.jpg

To edit metadata of a single picture, for example change its capture date:

geopic-tag-reader write \
	--input /path/to/original_image.jpg \
	--capture-time "2023-01-01T12:56:38Z" \
	--output /path/to/edited_image.jpg

Full documentation is also available here.

As Python library

In your own script, for reading and writing a picture metadata, you can use:

from geopic_tag_reader import reader, writer, model

# Open image as binary file
img = open("my_picture.jpg", "rb")
imgBytes = img.read()
img.close()

# Read EXIF metadata
metadata = reader.readPictureMetadata(imgBytes)
print(metadata)

# Edit picture EXIF metadata
editedMetadata = writer.PictureMetadata(
	picture_type = model.PictureType.equirectangular,
	direction = writer.Direction(125)
)
editedImgBytes = writer.writePictureMetadata(imgBytes, editedMetadata)

# Save edited file
editedImg = open("my_new_picture.jpg", "wb")
editedImg.write(editedImgBytes)
editedImg.close()

Full documentation is also available here.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

More information about developing is available in documentation.

🤗 Special thanks

GeoVisio was made possible thanks to a group of ✨ amazing people ✨ :

• GéoVélo team, for 💶 funding initial development and for 🔍 testing/improving software
• Carto Cité team (in particular Antoine Riche), for 💶 funding improvements on viewer (map browser, flat pictures support)
• La Fabrique des Géocommuns (IGN) for offering long-term support and funding the Panoramax initiative and core team (Camille Salou, Mathilde Ferrey, Christian Quest, Antoine Desbordes, Jean Andreani, Adrien Pavie)
• Many many wonderful people who worked on various parts of GeoVisio or core dependencies we use : 🧙 Stéphane Péneau, 🎚 Albin Calais & Cyrille Giquello, 📷 Damien Sorel, Pascal Rhod, Nick Whitelegg...
• Adrien Pavie, for ⚙️ initial development of GeoVisio
• And you all ✨ GeoVisio users for making this project useful !

⚖️ License

Copyright (c) GeoVisio team 2022-2023, released under MIT license.