Differences

This shows you the differences between two versions of the page.

--- projects:tracker [2008/08/28 01:10] – Added usage instructions for the tracker. natrium42
+++ projects:tracker [2011/07/26 02:50] (current) – [Usage] natrium42
@@ Line 7: / Line 7: @@
 ==== Download ====
+[[http://natrium42.com/downloads/tracker-0.2.zip|tracker-0.2.zip]] (Current)
 [[http://natrium42.com/downloads/tracker-0.1.tar.bz2|tracker-0.1.tar.bz2]]
@@ Line 25: / Line 27: @@
   `gps_heading` double NOT NULL default '0',
   `gps_speed` double NOT NULL default '0',
+  `picture` varchar(32) NOT NULL default '',
   PRIMARY KEY  (`position_id`)
 ) ENGINE=MyISAM  DEFAULT CHARSET=latin1;
 </code>
-  *Copy all files to a folder on your server.
+  * Copy all files to a folder on your server.
-  *Edit config.php and track.kml
+  * Edit config.php
-  * Google maps requires an API Key for each domain, sign up for one at [[http://code.google.com/apis/maps/signup.html]] and replace the key in index.php
+  * Google maps requires an API Key for each domain, sign up for one at [[http://code.google.com/apis/maps/signup.html]] and put it into $gmaps_key in config.php
-==== Usage ====
+==== Customization ====
+  * Modify the Twitter section in index.php: you can remove it or put your own user name
+  * Modify the Mibbit IRC section in index.php: you can remove it or put your own IRC channel into it
+  * Modify the ustream section in index.php to enable live video feed
+  * If you don't need picture down-link, remove header div from index.php
+==== Usage ====
-=== Updates via Email ===
+=== Updates via HTTP GET or POST ===
-Send email to track@domain.com of the format:
+To send an update via HTTP, send a GET or POST request to http://domain.com/tracker/track.php with following variables (or any other variables supported by the tracker):
-  N:firefly,T:233720,Lat:5142.8844N,Lon:00007.1758W,Alt:123.9,H:40,S:20.5km/hr,P:yourpass
-It's also possible to omit "km/h" and/or use decimal lat/lon:
-  N:halo,T:233720,Lat:51.71474,Lon:0.119596,Alt:123.9,H:40,S:20.5,P:yourpass
-Note: Altitude is in meters, heading is in degrees, speed is in km/h, time format is hhmmss.
-=== Updates via HTTP GET ===
-To send an update via HTTP, send a GET request to http://domain.com/tracker/track.php with following variables (or any other variables supported by the tracker):
   vehicle=halo
   time=233720
@@ Line 56: / Line 57: @@
   http://domain.com/tracker/track.php?vehicle=halo&time=233720&lat=5142.8844N&lon=00007.1758W&alt=123.9&heading=40&speed=20.5&pass=yourpass
 The best way is to use //curl// instead.
+Note: Altitude is in meters, heading is in degrees, speed is in km/h, time format is hhmmss. Decimal lat/lon can be used, because the tracker auto-recognizes the format.
+=== Updates via Email ===
+Send email to track@domain.com of the format:
+  N:firefly,T:233720,Lat:5142.8844N,Lon:00007.1758W,Alt:123.9,H:40,S:20.5km/h,P:yourpass
+It's also possible to omit "km/h" and/or use decimal lat/lon:
+  N:halo,T:233720,Lat:51.71474,Lon:0.119596,Alt:123.9,H:40,S:20.5,P:yourpass
+Note: Altitude is in meters, heading is in degrees, speed is in km/h, time format is hhmmss.
 === Live Pictures ===
-. Upload picture using //curl//:
+. Upload picture using //curl// (make sure to use unique file names):
   curl -F userfile=@picture.jpg -F password=yourpass -F MAX_FILE_SIZE=1000000 http://domain.com/tracker/upload.php
 . Send HTTP GET request as above but with additional //picture// variable:
@@ Line 65: / Line 75: @@
   http://domain.com/tracker/track.php?vehicle=halo&time=233720&lat=5142.8844N&lon=00007.1758W&alt=123.9&heading=40&speed=20.5&pass=yourpass&picture=picture.jpg
 Note that this is used as "meta data" for the picture only and is ignored as a location for the tracking map.
+=== Administration ===
+Admin interface is available in http://domain.com/tracker/admin and can be used to delete tracks.
+=== Change Log ===
+.2 (2009-01-24)
+  * Added picture down-link option
+.1 (2008-08-02)
+  * Initial revision