https://github.com/cobbzilla/vastra
privacy-respecting gps/map tools
https://github.com/cobbzilla/vastra
Last synced: 12 months ago
JSON representation
privacy-respecting gps/map tools
- Host: GitHub
- URL: https://github.com/cobbzilla/vastra
- Owner: cobbzilla
- License: apache-2.0
- Created: 2019-01-08T14:14:27.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-01-12T12:41:36.000Z (over 7 years ago)
- Last Synced: 2025-05-24T11:08:38.495Z (about 1 year ago)
- Language: JavaScript
- Size: 203 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# 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.
* You can download the data as a CSV at any time.
* GPS data is only stored in the browser session. You will lose all the data when you reload the page, unless you download it.
* Only your MapBox key is stored in HTML local storage on your device. You can clear it at any time.
#### 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 `<>/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):
* Draw a path on the map as you progress through your workout
* Display speed and elevation information
* Provide a CSV download of virtual (coalesced) data
* Allow you to save the workout to a named "routine"
* View aggregate statistics and pretty charts and graphs for your routines
* All data will be stored in HTML5 local storage, and can be cleared at any time.