======= AJAX Tracker =======

==== Description =====
AJAX tracker to track payloads. Locations can be submitted to the tracker via email or via HTTP GET. Google Earth is also supported.

{{projects:tracker-screenshot.png?400|Screenshot}}

==== 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 ===
1. 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
2. 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 ===

0.2 (2009-01-24)

  * Added picture down-link option

0.1 (2008-08-02)

  * Initial revision