Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/josmarcristello/geokmlanalyzer

The Geo Kml Analyzer is a Python-based tool designed to process and analyze elevation data from KML files. Uses google maps to obtain elevation data (interpolates if necessary) and spherical trigonometry equations to calculate the distance.
https://github.com/josmarcristello/geokmlanalyzer

data-analysis geolocation geospatial gis google-maps-api gps kml python

Last synced: 11 days ago
JSON representation

Host: GitHub
URL: https://github.com/josmarcristello/geokmlanalyzer
Owner: josmarcristello
License: mit
Created: 2023-03-27T21:13:10.000Z (almost 2 years ago)
Default Branch: main
Last Pushed: 2023-12-21T23:31:10.000Z (about 1 year ago)
Last Synced: 2025-01-19T03:15:06.808Z (14 days ago)
Topics: data-analysis, geolocation, geospatial, gis, google-maps-api, gps, kml, python
Language: Python
Homepage:
Size: 693 KB
Stars: 3
Watchers: 1
Forks: 0
Open Issues: 2
Metadata Files:
- Readme: readme.md
- License: LICENSE.md

Awesome Lists containing this project

README

# Geo KML Analyzer

![Python](https://img.shields.io/badge/python-3.9-blue.svg)
![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)
![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)

## Overview

The Geo Kml Analyzer is a Python-based tool designed to process and analyze elevation data from KML files. The tool reads KML files, extracts latitude and longitude coordinates, calculates distances between consecutive points, fetches elevation data from the Google Maps Elevation API, and generates descriptive statistics and plots for elevation profiles. Additionally, it supports including pins from separate KML files, finding the closest points on the route to these pins, and displaying them on the plots. This project aims to help users visualize and understand elevation profiles of geographical paths, such as hiking trails, roads, or pipelines.

## Features

### Data Processing and Analysis
- Reads and processes KML files containing latitude and longitude data
- Supports optional KML files with pins for labeling specific points on the route
- Calculates distances between consecutive latitude and longitude pairs using the [Vincenty formula](https://en.wikipedia.org/wiki/Vincenty%27s_formulae)
- Fetches elevation data from the Google [Maps Elevation API](https://developers.google.com/maps/documentation/elevation/overview)
- Interpolates (up to 512 times) within the data to target a resolution distance of 1 meter
- Generates descriptive statistics for distance, elevation, latitude, and longitude
- Exports processed data to CSV files

### Visualization
- Creates plots for elevation profiles against sample count and distance
- Includes pin labels on plots, automatically adjusting their positions to avoid overlap

### User Interface
- Converts KML files to CSV format for easy data manipulation
- Saves plots as images
- Displays a progress bar to track the processing status

## TODO
- Optimize number of requests for the data size. Pass arrays of data and limit to [8192 characters](https://developers.google.com/maps/documentation/elevation/requests-elevation).

## Installation

1. Clone the repository to your local machine:
```
git clone https://github.com/josmarcristello/GeoKMLAnalyzer.git
```

2. Change into the project directory:
```
cd elevation-profile-analyzer
```
3. Create a virtual environment and activate it:

```
python3 -m venv venv
source venv/bin/activate
```
4. Install the required packages:
```
pip install -r requirements.txt
```

## Usage

1. Create a .env file and include your Google maps API key (`API_KEY`). Example is not a valid key.
```
API_KEY = 'DCzaXyRrSW1e-7Fx2YEZlSLv81cYc3__-5ndsfFG'
```

2. Place your KML files in the `data/kml` directory. I have included a source file for test purposes.

3. Run the main script:

```
python src/kmz_to_csv.py
```

4. Processed data and plot images will be stored in the `output` directory.

5. To run descriptive statistics run the notebook:
```
src/notebook/get-google-maps-altitude
```
You can explore the generated descriptive statistics and plots to analyze elevation profiles for your KML files.

## Sample Images
### Progress bar:

![Progress Bar](./public/progress_bar.gif)

### Altitude x Distance Plot:
![Altitude x Distance Plot](./public/altitude_x_distance_sample.png)

## Notes

[Google Maps](https://developers.google.com/maps/documentation/elevation/usage-and-billing) API charges approximately 5 USD / 1 000 requests, depending on volume. They also gives $200 USD in credits every month, so that translates to 40 000 free requests per month.

## Contributing

We welcome contributions to improve this project. Please submit a pull request with your proposed changes, and ensure your code follows the project's style guidelines and best practices.

## License

This project is licensed under the MIT License. Please see the `LICENSE` file for more information.