**********************
** GeoPhoto Batcher **
**********************

The purpose of this command line tool is to update a directory of photographs with GPS coordinate information.  This is accomplished by either reading track information directly off your GPS, or by using .GPX files with track data and then updating the exif information in the photograph.  This works great very accurate as long as the time on your GPS and your camera match.  For best results I advise syncing your camera’s clock to your GPS before using this software.  If you plan on using this with flickr you need to allow flickr to update your photo’s position based on exif information.  You can do this here: http://www.flickr.com/account/geo/exif .  This implementation only works with jpg images.

The easiest way to use this program is to look at the 4 .bat files in this directory.  If you right click on them and go to edit you can change the directory where the photographs you want to update are or the .gpx file you want to use.

Here is the command to update images from a gpx file.
GeoPhotoBatcher.exe <GPX_File> <Photo_Directory> <GMT_Offset> <Threshold_In_Seconds>

Here is the command to update images from the track information on you GPS.  Make sure your GPS is connected to your computer and turned on before running this mode.
GeoPhotoBatcher.exe <GPS_Type> <Communications_Port> <Photo_Directory> <GMT_Offset> <Threshold_In_Seconds>

<GPS_Type> = Only Garmin and Magellan are valid GPS types at this time.

<Communications_Port> = For Garmin USB, com1, com2, com3, and com4 are valid.  For Magellan only com1, com2, com3, and com4 are valid.

<GPX_File> = The name of the .gpx file with your track information.

<Photo_Directory> = The directory where your photos are located.

<GMT_Offset> = GPS track information is stored in GTM.  If your camera's time is in GTM then you can just set this to 0, but most likely you'll need to set this to your time zone’s offset from GMT.  Some examples are:
Eastern Daylight Time is -4
Eastern Standard Time is -5
Pacific Standard Time is -8

<Threshold_In_Seconds> This is the maximum amount of time in seconds you want to allow your image's time to deviate from your track data.  For instance if you take pictures on three days of a vacation and only take the gps on the first and third days we probably don't want to update all photos from the second way with coordinates interpolated between the last coordinate recorded on day one and the first recorded on day three.  After running this you can GeoPhotoBatcher.exe you can look in ./tempData/LatLonCalculations.txt to see which images were updated with coordinates.  If some you want to be included are not getting updated then just increase this time.


---------

GeoPhoto Batcher makes direct use of Exiv2 (http://www.exiv2.org/) to update the exif information in the photo files.
GeoPhoto Batcher makes direct use of GPSBabel (http://www.gpsbabel.org/) read tracks files off of a GPS.

Both of these projects are under the GNU General public License (GPL) http://www.gnu.org/licenses/gpl.html.

The source for GeoPhoto Batcher should be included with this project and is in the open domain.