This project was originally created for Ghana to help them categorize and locate their dumpingsites, which unfortunately can be found everywhere in the country. You will see this at some places in the app (some things are labeled "dumpingsite" instead of "waypoint", you can choose a dumpingsity type, ...). But of course you can also use this project to categorize other coordinates from pictures into locations.
- import (folders with) images by dragging and dropping them onto the map
- any errors while uploading images are indicated
- change map representation (Default, OSM, Satellite, Hybrid)
- change app behavior in the settings menu
- view all dumpingsites with their information in a table
- get information about one location on the sidebar panel
- zoom and move the map
- move the waypoints, the app will dynamically update the coordinates
- inform yourself about the features in the tutorial
- system for logging errors while importing images
- start map and import images via console
- activate/deactivate logging via console
- the app saves the state of itself when a user closes it, so no information is lost if you open the app the next time
- load map via an api
- images are grouped to dumpingsites
- take a screenshot of the map without the UI
Drag and drop pictures with GPS-Information from your local explorer onto the map, the program will show you where they were taken.
| shortcut | option | argument 1 | description |
|---|---|---|---|
| -h | --help | prints help message and exits | |
| -l | --log-file | /path/to/file | enables logging and sets log file accordingly |
| -d | --image-directory | /path/to/directory | sets image directory accordingly |
We use this library, so we can support many file types at once with little effort.
This library helps us to draw the maps from OpenStreetMap.
In order to parse command line arguments, we use this library.
We are using this library to easily read and write CSV files.
This project uses Maven to manage its dependencies. The next instructions can only be followed if Maven has been successfully installed onto your system.
The following commands should provide you a running build.
Works on most GNU+Linux based operating systems (Build + Execute):
/path/to/geoimageviewer/build.sh
cd /path/to/geoimageviewer
mvn clean package
java -jar target/geoimageviewer-1.0-SNAPSHOT.jarYou can also use the executable file from the Releases tab in GitHub to execute this project
Latest UML diagram:
The UML diagrams for this project are stored here.
Feel free to contact me via the following options:
- Discord Server: https://discord.gg/deftTGQzb2
- E-Mail: [email protected]
or create an Issue