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 is 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 independently from other 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 simple command
- 💻 Use it as either 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 from both the command-line or as a 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 the metadata of a single picture, for example to 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
Metadata
1 maintainer
Release files for geopic-tag-reader 1.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| geopic_tag_reader-1.10.1.tar.gz | 114.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| geopic_tag_reader-1.10.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 266.8 kB
Release files / geopic_tag_reader-1.10.1.tar.gz
| Download URL | geopic_tag_reader-1.10.1.tar.gz |
|---|---|
| Size | 114.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
800ca5aef45a393d0e7e188a968c0377bf9658171fd879be2613d3b0d0476f47
|
|
BLAKE2b-256 checksum How to use checksums |
d732cc684c7af999b2760e904e46fc7583d4a3b5fa8ecb6f39a982bcc6eef9cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.32.5
|
Release files / geopic_tag_reader-1.10.1-py3-none-any.whl
| Download URL | geopic_tag_reader-1.10.1-py3-none-any.whl |
|---|---|
| Size | 152.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f0c55da75d75e02c1c63ca6e5e3f211e25fd016c5af05319c428492d9c6cd761
|
|
BLAKE2b-256 checksum How to use checksums |
08b938ff93803269298742044b625e6b8d296f323f9b0f4271b1cd685764adf8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.32.5
|
