https://github.com/cyclenerd/latrine

📡 Locus Map GPS Live Tracking Server Script
https://github.com/cyclenerd/latrine

location locus-map perl perl-script storage-location tracking

Last synced: 3 months ago
JSON representation

📡 Locus Map GPS Live Tracking Server Script

• Host: GitHub
• URL: https://github.com/cyclenerd/latrine
• Owner: Cyclenerd
• License: gpl-2.0
• Archived: true
• Created: 2013-07-30T09:54:47.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2016-11-06T14:41:24.000Z (about 8 years ago)
• Last Synced: 2024-09-28T19:01:16.797Z (3 months ago)
• Topics: location, locus-map, perl, perl-script, storage-location, tracking
• Language: HTML
• Homepage:
• Size: 11.7 KB
• Stars: 14
• Watchers: 7
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Latrine

=======

[Locus Map](http://www.locusmap.eu/) Android GPS live tracking server script

![ScreenShot](http://i.imgur.com/0QjqnmD.jpg)

Latrine is a minimalist GPS live tracking server script.

It is very easy to set up and requires no database.

All you need is a web server which can execute Perl scripts.

More information on the live tracking feature of Locus Map Pro can be found on its [documentation web page](http://docs.locusmap.eu/doku.php?id=manual:user_guide:functions:live_tracking#web_services).

Features

--------

* Tracking: Server receives data from Android device with Locus Pro installed and live tracking enabled.

* Live following: Data sent by Locus Pro is shown live on map.

* Multiple map layers: Currently you can choose between OpenStreetMap, OpenCylceMap, Hike and Bike (with Hillshading) and ESRI

* Multi-user: Authentication with key

Functions

---------

Authentication is done with a key. Anyone who knows the key can see and update the GPS location.

Your key must be at least 5 characters up to 15 characters `a-zA-Z0-9_`.

### Update

	http:///latrine.pl?key=&lat=&lon=&alt=&speed=&bearing=&acc=

Example:

	http://localhost/cgi-bin/latrine.pl?key=OnMyBike&lat=45.09&lon=6.07&acc=5&speed=4.16666667

### Get JSON

	http:///latrine.pl?key=&view=1

Example:

	http://localhost/cgi-bin/latrine.pl?key=OnMyBike&view=1

Reply:

	{

	  "lat": "45.09",

	  "lon": "6.07",

	  "alt": "0",

	  "speed": "4.16666667",

	  "bearing": "0",

	  "acc": "5",

	  "time": "1375194859",

	  "now": "1375195150"

	}

### Show map

	http:///latrine.html?#

Example:

	http://localhost/latrine.html?#OnMyBike

Installation

------------

1.) Adjust the storage location `my $store = '/tmp/latrine/';` in `latrine.pl`.

2.) Adjust the location (URL) to your Perl script `var perlScript = 'latrine.pl';` in `latrine.html`.

3.) Upload `latrine.pl` and `latrine.html` onto your web server. The Perl script `latrine.pl` must be executable by the web server.

4.) Configure Locus Map. Do not forget the key.

![LocusMap](http://i.imgur.com/m9jxS1t.png)

5.) Go out :+1: 

Sample Configuration for Mac OS X

---------------------------------

* Web Sharing must be [enabled](http://support.apple.com/kb/HT3323)

* Copy `latrine.html` to `/Library/WebServer/Documents/`

* Copy `latrine.pl` to `/Library/WebServer/CGI-Executables/` and run `chmod +x latrine.pl`

* Default storage location in `latrine.pl` is just fine

* Adjust the location (URL) in `latrine.html` to `var perlScript = '/cgi-bin/latrine.pl';`