https://github.com/israel-charles/geopoint-tracer-app
GeoPoint Tracer is a versatile application designed to handle geographical points, allowing users to add, edit, delete, and visualize these points on a map. The application supports both a graphical user interface (GUI) and a command-line interface (CLI), providing flexibility for different user preferences and scenarios.
https://github.com/israel-charles/geopoint-tracer-app
folium-maps geo-mapping geolocation geolocation-position python
Last synced: about 2 months ago
JSON representation
GeoPoint Tracer is a versatile application designed to handle geographical points, allowing users to add, edit, delete, and visualize these points on a map. The application supports both a graphical user interface (GUI) and a command-line interface (CLI), providing flexibility for different user preferences and scenarios.
- Host: GitHub
- URL: https://github.com/israel-charles/geopoint-tracer-app
- Owner: Israel-Charles
- Created: 2024-07-11T12:55:35.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-08-16T02:24:39.000Z (9 months ago)
- Last Synced: 2025-01-18T04:24:46.975Z (3 months ago)
- Topics: folium-maps, geo-mapping, geolocation, geolocation-position, python
- Language: Python
- Homepage: https://codepad.site/pad/97j0o4xx
- Size: 10.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GeoPoint-Tracer-App
GeoPoint Tracer is a versatile application designed to handle geographical points, allowing users to add, edit, delete, and visualize these points on a map. The application supports both a graphical user interface (GUI) and a command-line interface (CLI), providing flexibility for different user preferences and scenarios.
#### Demo GUI > https://codepad.site/pad/97j0o4xx
#### Demo CLI > https://codepad.site/pad/ayc32ryi
### Features
- Add Points: Add geographical points by specifying latitude and longitude.
- Edit Points: Modify existing points.
- Delete Points: Remove points from the list.
- Clear Points: Clear all points from the list.
- Load Points: Load points from a JSON file.
- Save Map: Visualize the points on a map and save it as an HTML file.
- Export Points: Export the points to a JSON file or bare Text file.
- Map Views: Choose between different map views, such as OpenStreetMap and Google Satellite.
# How to Use
***(Use `python`, `python2`, or `python3`, depending on what version of python you have. Same for pip, you might need to use `pip`, `pip2`, or `pip3`)***
## Command-Line Interface (CLI)
### Requirements
- Python 3.x
- folium library
### Installation
Install the required library using pip:
```
pip install folium
```
### Running the CLI Version
#### With Input File:
```
python geopoint_tracer_cli_v1.0.py inputfile.json
```
This command loads points from inputfile.json and then prompts you to select a map view or export the points as a JSON file.
#### Without Input File:
```
python geopoint_tracer_cli_v1.0.py
```
This command allows you to manually enter geographical points. Enter latitude and longitude values, typing 'x' to stop entering points. Afterward, you can select a map view or export the points.
#### Options after inputing the Geo Points:
- 1: OpenStreetMap
- 2: Google Satellite
- t: Export points as a Text file
- e: Export points as JSON file
- q: Quit the program
## Graphical User Interface (GUI)
### Requirements
- Python 3.x
- tkinter (comes pre-installed with Python)
- folium library
### Installation
Install the required library using pip:
```
pip install folium
```
### Running the Application:
```
python ggeopoint_tracer_gui_v1.0.py
```
This command opens the graphical user interface.
### Using the GUI:
- Add Point: Enter latitude and longitude in the respective fields and click "Add Point".
- Load Points: Click "Load Points from File" to select and load points from a JSON file.
- Edit Point: Select a point from the list and click "Edit Point" or double-click a point to modify it.
- Delete Point: Select a point from the list and click "Delete Point" to remove it.
- Clear Points: Click "Clear All Points" to remove all points from the list.
- Select Map View: Choose the desired map view from the dropdown menu.
- Save Map: Click "Save Map" to save the map with the points to an HTML file.
- Export Points: Click "Export Points as JSON" to save the points to a JSON file. Or "Bare" to export as a bare file
# Main Files
- geopoint_tracer_cli_v1.0.py: Contains the CLI version of the GeoPoint Tracer application.
- ggeopoint_tracer_gui_v1.0.py: Contains the GUI version of the GeoPoint Tracer application.
This dual-interface approach ensures that GeoPoint Tracer can be used efficiently in both graphical and terminal environments, making it a powerful tool for managing and visualizing geographical data.