Panoramax
Panoramax is a digital resource for sharing and using 📍📷 field photos. Anyone can take photographs of places visible from the public streets and contribute them to the Panoramax database. This data is then freely accessible and reusable by all. More information available at gitlab.com/panoramax and panoramax.fr.
📷 GeoPic Tag Reader
This repository only contains the Python library to read and write standardized metadata from geolocated pictures EXIF metadata. It can be used completely apart from all Panoramax components for your own projects and needs.
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.
⚖️ License
Copyright (c) Panoramax team 2022-2024, released under MIT license.
1 maintainer
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file geopic_tag_reader-1.8.1.tar.gz.
File metadata
- Download URL: geopic_tag_reader-1.8.1.tar.gz
- Upload date:
- Size: 108.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
python-requests/2.32.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5d4262721a8ebbc3617d0468279f0858981b4da3e100ffd474b054ca51c0f40d
|
|
| MD5 |
48b02ee6c443a6280b157474f32f1461
|
|
| BLAKE2b-256 |
22001a18be4d2d24e5ede469abb0353a0ef21b24c63149faeaa65ee6301c3b78
|
File details
Details for the file geopic_tag_reader-1.8.1-py3-none-any.whl.
File metadata
- Download URL: geopic_tag_reader-1.8.1-py3-none-any.whl
- Upload date:
- Size: 139.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
python-requests/2.32.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ca91cfd09aab17c5a57bd841613b656416646c7672d464ff14b624a09e5fbaa2
|
|
| MD5 |
9ce4c7530ab87484285e2d360b057227
|
|
| BLAKE2b-256 |
9f89d621249f0c85af2bfbd5b4606524a6d61317cc7bd770eb7bf06fdf7c0cab
|
