Differences

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

--- projects:tracker [2008/08/01 19:30] – 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]]
+==== Installation ====
+  * Run the following SQL command on your database which creates the positions table:
+<code>
+  CREATE TABLE IF NOT EXISTS `positions` (
+  `position_id` int(11) NOT NULL auto_increment,
+  `mission_id` int(11) NOT NULL default '0',
+  `vehicle` varchar(32) NOT NULL default '',
+  `server_time` timestamp NOT NULL default CURRENT_TIMESTAMP,
+  `gps_time` datetime NOT NULL default '0000-00-00 00:00:00',
+  `gps_lat` double NOT NULL default '0',
+  `gps_lon` double NOT NULL default '0',
+  `gps_alt` double NOT NULL default '0',
+  `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.
+  * 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 put it into $gmaps_key in config.php
+==== 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 HTTP GET or POST ===
+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):
+  vehicle=halo
+  time=233720
+  lat=5142.8844N
+  lon=00007.1758W
+  alt=123.9
+  heading=40
+  speed=20.5
+  pass=yourpass
+For example, you can do that by simply opening this URL:
+  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// (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:
+  picture=picture.jpg
+For example:
+  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