gpx2kml 0.1.3

A library to combine gpx files exported from runkeeper.com to kml files

gpx2kml

gpx2kml is a library for combining gpx files exported from Runkeeper to kml files. Below is a screenshot of the generated kml file in Google Earth.

Introduction

Runkeeper is one of many mobile apps that can track exercises. Usually they provide UI for displaying individual activity (like biking, running, etc.) with route map and statistics, and the functionality to bulk export archive files.

gpx2kml can combine all the gpx files exported from Runkeeper into a single kml file so that it can be displayed in the Google Earth. The motivation is mainly to prepare data for my bike journey webpage.

User scenario

I use Runkeeper to track my biking and walking activities. Tracking is a long term activity, so file generation and archive is an incremental process.

I export the gpx files once per month, and generate kml files from the gpx files with the format YYYY-MM.kml. After that, all the kml files are combined into a single kml file, usually named after the city or the event related with those activities.

Installation

pip install gpx2kml

How to use it

1. Accumulate a few activities using Runkeeper.
2. Export the acitives from the Runkeeper web UI and download the file. The demo folder provides a sample zip file.
3. Open a terminal, and change the working directory to the one that contains the zip file.
4. Run gpx-archive in the terminal. This will create an archive folder under the working directory, with all the gpx files inside.

gpx-archive

5. Run kml-gen in the terminal. This will create a kml folder under the working directory, with the generated kml files organized by month.

kml-gen

Alternatively, kml-gen can take an argument for filtering the type of gpx files, for example to only generate kml from "Cycling" gpx files,

kml-gen Cycling

6. Move the kml in the kml/XXX folder, and run kml-combine XXX in the terminal. This will create a `XXX.kml`` file that includes all the kml files in the kml/XXX folder.

kml-combine XXX

Other than running the commands in the terminal, there is a demo.py that demonstrates how to call the methods in a python file.