GeoPicTagReader
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for geopic_tag_reader-1.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7b6adcd807c9f210e2026677b08a27d267ad245256170e7676045422eb7c302f |
|
MD5 | c44f02822c05768f5861614a2863b1c5 |
|
BLAKE2b-256 | ed83250418cfc884ad1406a4e5cd4f01a0ae16b3a7ba208bceb655b01a2d0f4f |