cobbzilla / vastra

privacy-respecting gps/map tools
Apache License 2.0
1 stars 0 forks source link

Vastra

Vastra aims to provide privacy-first GPS tracking tools for fitness purposes.

Runners, cyclists and many other athletes enjoy the power of commercial GPS services. But how hard are they really? It's GPS and a map at the end of the day. This is not rocket science. Why are we so comfortable giving our data to third parties?

Data Privacy

Vastra is self-hosted and does not send your data to any third party. Vastra uses MapBox for loading map tiles from OpenStreetMap. For the truly paranoid, you could host your own map tiles; I'm OK with MapBox knowing which map tiles I load, for now.

Vastra Tools

Vastra offers two different tools, one low-level and one higher-level.

Vastra Collect

Vastra Collect is a low-level GPS data collection tool. It is a simple static website that you can host anywhere. If you wondered how easy it could be to put GPS dots on a map, this makes a decent starter kit.

MapBox

Upon first load, you'll be asked for your MapBox API key. You can get a free one from MapBox. If you don't enter an API key, the GPS tracking will still work, but you won't see the map.

How it works

Vastra Collect tracks your location on a map, and puts a red circle on the map every time it is notified of a change.

Installation

On some webserver that you have access to:

git clone https://github.com/cobbzilla/vastra.git

After cloning the repo, copy or symlink the vastra/site to someplace accessible via your web server. If you copied vastra/site to <<docroot>>/vastra, the Vastra Collector can be accessed via https://yoursite.example.com/vastra/collect.html

WIP: Vastra Workout

Vastra Workout is a work in progress. Load workout.html to see it in action. It's pretty basic so far.

Vastra Workout extends Vastra Collect to coalesce raw GPS measurements into digested locations using Kalman filtering.

Vastra Workout will (eventually):