Skip to content

vast-ch/the-mountains-are-calling

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The mountains are calling

Idea

Based on the idea of simple, location sharing first introduced in Google Latitude, and then expanded in various other projects 1, 2 this app is here for outdoor enthusiasts that want to:

  • Give themselves peace of mind by not requiring to remember to enable live tracking. It can optionally be always on.
  • Having complete control over your data:
    • The dataset gathered is minimal to allow full functionality & prevent any spying.
    • No registration, login or any other PIIs are required.
    • No app installation necessary.
    • Although the default setup shares the location data to our servers, the project is fully Open Source with detailed manual on how to self host. So you can have the data completely under control.

Demo

https://the-mountains-are-calling.netlify.app/

Screenshots

Application Screenshot

Functionality

  • Allows audit of location history of a device.
    • This person went to the mountains and is not responding. What was their last known location? Where were they heading to? What is the expected location where they might be?
    • Their phone disappeared from the network for some time, did it come back online?
    • What is the accuracy of given data point?
  • Shows last known location of a device.
    • When was the last time location data were shared?
    • What is the accuracy of last known location point?
  • Is not useable for spying on people.
    • There is no direct functionality that shares live location data, only (location) data gathering and analysis. Given device has to intentionally send the data to the service. If your device already shares information about your position to other parties without your consent, then you have different kind of problems.
    • The app only works with minimum necessary data to provide useful information. See "Data" section.

Quickstart

Caution

This part of the README is intended to show a way to get started quickly. With this setup your Device will share location data with 3rd party Provider, which is controlled by us. And then we will be able to read your data. If you're looking for privacy focused solution, follow the guide on one of the providers.

Provider URL

Caution

Make sure to chose your deviceId to something unique and hard to guess. You don't need to memorise it, so:

  • Make it at least 16 characters long
  • Make it as random as possible

The provider URL is where the data will be stored the format is:

https://the-mountains-are-calling-default-rtdb.europe-west1.firebasedatabase.app/${deviceId}.json

Device

  1. Install OwnTracks app.
  2. In settings of the app set:
    1. Connection -> Mode -> HTTP
    2. Hostname -> Fill in whole Provider URL

Client

  1. Go to: https://the-mountains-are-calling.netlify.app/
  2. Click on Settings
  3. Fill in the Provider URL you got in previous step
  4. Click on Map
  5. Search for a date when the Device was sharing location.

Terminology

Device

Device is any electronic instrument that can:

  1. Collect information about it's current GPS location.
  2. Has a knowledge about current time.
  3. Is able to share that information over HTTP request.

Here device is the item whose location is being tracked.

Provider

A provider is a server that gathers location data from Devices and then provides (hence the name) them to Clients.

The application can, in theory, work using any technology as a Provider. Firebase instance, Box folder, MongoDb instance, ...

Currently implemented providers are:

Client

Client is the visualisation part of the system. Currently implemented as a simple web application. Even the hosted application does not track or collect any of your data, but if your want to feel more safe, you can build and deploy it on any webserver that can host static assets. For example: netlify.

Data

Name

The mountains are calling and I must go.

-- John Muir - letter to sister Sarah Muir Galloway (3 September 1873)

About

Simple location sharing, excluding the Big Brother.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published