gpsbabel-1.4.2

GPSBabel Documentation


Table of ContentsIntroduction to GPSBabel .................................................................................................. xix The Problem: Too many incompatible GPS file formats .................................................. xix The Solution ........................................................................................................... xix 1. Getting or Building GPSBabel .......................................................................................... 1 Downloading - the easy way. ....................................................................................... 1 Building from source. .................................................................................................. 1 2. Usage ........................................................................................................................... 3 Invocation ................................................................................................................. 3 Suboptions ................................................................................................................ 4 Advanced Usage ........................................................................................................ 4 Route and Track Modes .............................................................................................. 5 Working with predefined options .................................................................................. 6 Realtime tracking ....................................................................................................... 7 Batch mode (command files) ........................................................................................ 7 List of Options ........................................................................................................... 8 3. The Formats ................................................................................................................. 10 ? Character Separated Values (xcsv) ............................................................................ 10 style option .................................................................................................. 10 snlen option .................................................................................................. 10 snwhite option .............................................................................................. 10 snupper option .............................................................................................. 10 snunique option ............................................................................................ 11 urlbase option .............................................................................................. 11 prefer_shortnames option .......................................................................... 11 datum option .................................................................................................. 11 Alan Map500 tracklogs (.trl) (alantrl) ........................................................................... 11 Alan Map500 waypoints and routes (.wpr) (alanwpr) ....................................................... 12 All database fields on one tab-separated line (tabsep) ...................................................... 12 Brauniger IQ Series Barograph Download (baroiq) ......................................................... 12 Bushnell GPS Trail file (bushnell_trl) ........................................................................... 13 Bushnell GPS Waypoint file (bushnell) ......................................................................... 13 Cambridge/Winpilot glider software (cambridge) ............................................................ 14 CarteSurTable data file (cst) ....................................................................................... 14 Cetus for Palm/OS (cetus) .......................................................................................... 14 dbname option ................................................................................................ 14 appendicon option ........................................................................................ 14 CoastalExplorer XML (coastexp) ................................................................................. 15 Columbus/Visiontac V900 files (.csv) (v900) ................................................................. 15 Comma separated values (csv) .................................................................................... 15 CompeGPS data files (.wpt/.trk/.rte) (compegps) ............................................................ 16 deficon option .............................................................................................. 16 index option .................................................................................................. 16 radius option ................................................................................................ 17 snlen option .................................................................................................. 17 CoPilot Flight Planner for Palm/OS (copilot) ................................................................. 17 cotoGPS for Palm/OS (coto) ....................................................................................... 17 zerocat option .............................................................................................. 18 Custom "Everything" Style (custom) ............................................................................ 18 Data Logger iBlue747 csv (iblue747) ........................................................................... 18 Dell Axim Navigation System (.gpb) file format (axim_gpb) ............................................ 18 DeLorme .an1 (drawing) file (an1) ............................................................................... 19

iii


type option .................................................................................................... road option .................................................................................................... nogc option .................................................................................................... nourl option .................................................................................................. deficon option .............................................................................................. color option .................................................................................................. zoom option .................................................................................................... wpt_type option ............................................................................................ radius option ................................................................................................ DeLorme GPL (gpl) .................................................................................................. DeLorme PN-20/PN-30/PN-40 USB protocol (delbin) ..................................................... get_posn option ............................................................................................ logs option .................................................................................................... long_notes option ........................................................................................ nukewpt option .............................................................................................. nuketrk option .............................................................................................. nukerte option .............................................................................................. hint_at_end option ...................................................................................... gcsym option .................................................................................................. DeLorme Street Atlas Plus (saplus) .............................................................................. DeLorme Street Atlas Route (saroute) .......................................................................... turns_important option .............................................................................. turns_only option ........................................................................................ split option .................................................................................................. controls option ............................................................................................ times option .................................................................................................. DeLorme XMap HH Native .WPT (xmap) .................................................................... DeLorme XMap/SAHH 2006 Native .TXT (xmap2006) ................................................... DeLorme XMat HH Street Atlas USA .WPT (PPC) (xmapwpt) ......................................... Destinator Itineraries (.dat) (destinator_itn) .................................................................... Destinator Points of Interest (.dat) (destinator_poi) .......................................................... Destinator TrackLogs (.dat) (destinator_trl) ................................................................... EasyGPS binary format (easygps) ................................................................................ Embedded Exif-GPS data (.jpg) (exif) .......................................................................... filename option ............................................................................................ frame option .................................................................................................. name option .................................................................................................... overwrite option .......................................................................................... Enigma binary waypoint file (.ert) (enigma) .................................................................. FAI/IGC Flight Recorder Data Format (igc) .................................................................. IGC Data Format Notes ..................................................................................... Converting to IGC format .................................................................................. Converting from IGC format .............................................................................. Merging into IGC format ................................................................................... timeadj option .............................................................................................. Franson GPSGate Simulation (gpssim) ......................................................................... wayptspd option ............................................................................................ split option .................................................................................................. Fugawi (fugawi) ....................................................................................................... G7ToWin data files (.g7t) (g7towin) ............................................................................ Garmin 301 Custom position and heartrate (garmin301) ................................................... Garmin Logbook XML (glogbook) .............................................................................. Garmin MapSource - gdb (gdb) ................................................................................... cat option ......................................................................................................

19 19 20 20 20 21 21 21 21 21 21 22 22 22 23 23 23 23 23 23 24 24 24 24 24 25 25 25 25 27 27 27 28 28 28 28 29 29 29 29 30 30 31 31 32 32 32 32 33 33 34 34 34 34

iv


bitscategory option .................................................................................... 34 ver option ...................................................................................................... 35 via option ...................................................................................................... 35 roadbook option ............................................................................................ 35 Garmin MapSource - mps (mapsource) ......................................................................... 35 snlen option .................................................................................................. 36 snwhite option .............................................................................................. 36 mpsverout option .......................................................................................... 36 mpsmergeout option ...................................................................................... 36 mpsusedepth option ...................................................................................... 36 mpsuseprox option ........................................................................................ 37 Garmin MapSource - txt (tab delimited) (garmin_txt) ...................................................... 37 date option .................................................................................................... 37 datum option .................................................................................................. 37 dist option .................................................................................................... 38 grid option .................................................................................................... 38 prec option .................................................................................................... 38 temp option .................................................................................................... 38 time option .................................................................................................... 38 utc option ...................................................................................................... 39 Garmin PCX5 (pcx) .................................................................................................. 39 deficon option .............................................................................................. 39 cartoexploreur option ................................................................................ 39 Garmin POI database (garmin_poi) .............................................................................. 39 Garmin Points of Interest (.gpi) (garmin_gpi) ................................................................. 40 alerts option ................................................................................................ 40 bitmap option ................................................................................................ 41 category option ............................................................................................ 41 hide option .................................................................................................... 41 descr option .................................................................................................. 41 notes option .................................................................................................. 41 position option ............................................................................................ 42 proximity option .......................................................................................... 42 sleep option .................................................................................................. 42 speed option .................................................................................................. 43 unique option ................................................................................................ 43 units option .................................................................................................. 44 Garmin serial/USB protocol (garmin) ........................................................................... 44 snlen option .................................................................................................. 46 snwhite option .............................................................................................. 47 deficon option .............................................................................................. 47 get_posn option ............................................................................................ 47 power_off option .......................................................................................... 47 erase_t option .............................................................................................. 47 resettime option .......................................................................................... 48 category option ............................................................................................ 48 bitscategory option .................................................................................... 48 Garmin Training Center (gtrnctr) ................................................................................. 48 course option ................................................................................................ 49 sport option .................................................................................................. 49 Garmin Training Center (.tcx) (gtrnctr) ......................................................................... 49 course option ................................................................................................ 49 sport option .................................................................................................. 49 Geocaching.com .loc (geo) .......................................................................................... 49

v


deficon option .............................................................................................. nuke_placer option ...................................................................................... GeocachingDB for Palm/OS (gcdb) .............................................................................. Geogrid-Viewer ascii overlay file (.ovl) (ggv_ovl) .......................................................... Geogrid-Viewer tracklogs (.log) (ggv_log) .................................................................... GEOnet Names Server (GNS) (geonet) ......................................................................... GeoNiche .pdb (geoniche) .......................................................................................... dbname option ................................................................................................ category option ............................................................................................ GlobalSat DG-100/BT-335 Download (dg-100) .............................................................. erase option .................................................................................................. erase_only option ........................................................................................ Google Earth (Keyhole) Markup Language (kml) ........................................................... deficon option .............................................................................................. lines option .................................................................................................. points option ................................................................................................ line_width option ........................................................................................ line_color option ........................................................................................ floating option ............................................................................................ extrude option .............................................................................................. track option .................................................................................................. trackdata option .......................................................................................... trackdirection option ................................................................................ units option .................................................................................................. labels option ................................................................................................ max_position_points option ...................................................................... Google Maps XML (google) ....................................................................................... Google Navigator Tracklines (.trl) (gnav_trl) ................................................................. GoPal GPS track log (.trk) (gopal) ............................................................................... date option .................................................................................................... maxspeed option ............................................................................................ minspeed option ............................................................................................ clean option .................................................................................................. GpilotS (gpilots) ....................................................................................................... dbname option ................................................................................................ GPS TrackMaker (gtm) .............................................................................................. GPSBabel arc filter file (arc) ...................................................................................... GpsDrive Format (gpsdrive) ....................................................................................... GpsDrive Format for Tracks (gpsdrivetrack) .................................................................. GPSman (gpsman) .................................................................................................... GPSPilot Tracker for Palm/OS (gpspilot) ...................................................................... dbname option ................................................................................................ gpsutil (gpsutil) ........................................................................................................ GPX XML (gpx) ...................................................................................................... snlen option .................................................................................................. suppresswhite option .................................................................................. logpoint option ............................................................................................ urlbase option .............................................................................................. gpxver option ................................................................................................ humminbirdextensions option .................................................................... garminextensions option ............................................................................ HikeTech (hiketech) .................................................................................................. Holux (gm-100) .wpo Format (holux) ........................................................................... Holux M-241 (MTK based) Binary File Format (m241-bin) ..............................................

50 50 50 50 51 51 51 52 52 52 53 53 53 54 54 54 54 54 54 54 54 55 55 55 55 55 55 56 56 57 57 57 58 58 58 58 58 59 59 59 59 60 60 60 60 61 61 61 61 61 61 61 62 62

vi


csv option ...................................................................................................... 63 Holux M-241 (MTK based) download (m241) ............................................................... 63 erase option .................................................................................................. 63 erase_only option ........................................................................................ 63 log_enable option ........................................................................................ 63 csv option ...................................................................................................... 63 Honda/Acura Navigation System VP Log File Format (vpl) .............................................. 64 HSA Endeavour Navigator export File (hsandv) ............................................................. 64 HTML Output (html) ................................................................................................. 64 stylesheet option ........................................................................................ 65 encrypt option .............................................................................................. 65 logs option .................................................................................................... 65 degformat option .......................................................................................... 65 altunits option ............................................................................................ 65 Humminbird tracks (.ht) (humminbird_ht) ..................................................................... 65 Humminbird waypoints and routes (.hwr) (humminbird) .................................................. 66 IGN Rando track files (ignrando) ................................................................................ 66 index option .................................................................................................. 67 iGO2008 points of interest (.upoi) (igo2008_poi) ............................................................ 67 IGO8 .trk (igo8) ........................................................................................................ 67 tracknum option ............................................................................................ 67 title option .................................................................................................. 67 description option ...................................................................................... 68 Jelbert GeoTagger data file (jtr) .................................................................................. 68 Jogmap.de XML format (jogmap) ................................................................................ 68 Kartex 5 Track File (ktf2) .......................................................................................... 68 Kartex 5 Waypoint File (kwf2) ................................................................................... 68 Kompass (DAV) Track (.tk) (kompass_tk) .................................................................... 69 Kompass (DAV) Waypoints (.wp) (kompass_wp) ........................................................... 69 KuDaTa PsiTrex text (psitrex) .................................................................................... 69 Lowrance USR (lowranceusr) ..................................................................................... 69 ignoreicons option ...................................................................................... 70 writeasicons option .................................................................................... 70 merge option .................................................................................................. 70 break option .................................................................................................. 70 wversion option ............................................................................................ 70 Magellan Explorist Geocaching (maggeo) ..................................................................... 71 Magellan Mapsend (mapsend) ..................................................................................... 71 trkver option ................................................................................................ 71 Magellan NAV Companion for Palm/OS (magnav) ......................................................... 71 Magellan SD files (as for eXplorist) (magellanx) ............................................................ 72 deficon option .............................................................................................. 72 maxcmts option .............................................................................................. 73 Magellan SD files (as for Meridian) (magellan) .............................................................. 73 deficon option .............................................................................................. 73 maxcmts option .............................................................................................. 73 Magellan serial protocol (magellan) ............................................................................. 74 deficon option .............................................................................................. 75 maxcmts option .............................................................................................. 75 baud option .................................................................................................... 75 noack option .................................................................................................. 75 nukewpt option .............................................................................................. 76 MagicMaps IK3D project file (.ikt) (ik3d) ..................................................................... 76 Map&Guide 'TourExchangeFormat' XML (tef) ........................................................ 76

vii


routevia option ............................................................................................ Map&Guide to Palm/OS exported files (.pdb) (mag_pdb) .......................................... MapAsia track file (.tr7) (mapasia_tr7) ......................................................................... Mapopolis.com Mapconverter CSV (mapconverter) ......................................................... Notes .............................................................................................................. MapTech Exchange Format (mxf) ................................................................................ Memory-Map Navigator overlay files (.mmo) (mmo) ...................................................... locked option ................................................................................................ visible option .............................................................................................. ver option ...................................................................................................... Microsoft AutoRoute 2002 (pin/route reader) (msroute) ................................................... Microsoft Streets and Trips (pin/route reader) (msroute) ................................................... Microsoft Streets and Trips 2002-2007 (s_and_t) ............................................................ Mobile Garmin XT Track files (garmin_xt) ................................................................... ftype option .................................................................................................. trk_header option ........................................................................................ Motorrad Routenplaner (Map&Guide) .bcr files (bcr) ................................................ index option .................................................................................................. name option .................................................................................................... radius option ................................................................................................ prefer_shortnames option .......................................................................... MS PocketStreets 2002 Pushpin (psp) .......................................................................... Frequently Asked Questions ............................................................................... MTK Logger (iBlue 747,...) Binary File Format (mtk-bin) ................................................ csv option ...................................................................................................... MTK Logger (iBlue 747,Qstarz BT-1000,...) download (mtk) ........................................... erase option .................................................................................................. erase_only option ........................................................................................ log_enable option ........................................................................................ csv option ...................................................................................................... National Geographic Topo .tpg (waypoints) (tpg) ............................................................ datum option .................................................................................................. National Geographic Topo 2.x .tpo (tpo2) ..................................................................... National Geographic Topo 3.x/4.x .tpo (tpo3) ................................................................ Navicache.com XML (navicache) ................................................................................ noretired option .......................................................................................... Navigon Mobile Navigator .rte files (nmn4) ................................................................... index option .................................................................................................. Navigon Waypoints (navigonwpt) ................................................................................ NaviGPS GT-11/BGT-11 Download (navilink) .............................................................. nuketrk option .............................................................................................. nukerte option .............................................................................................. nukewpt option .............................................................................................. nukedlg option .............................................................................................. datalog option .............................................................................................. power_off option .......................................................................................... NaviGPS GT-31/BGT-31 datalogger (.sbp) (sbp) ............................................................ NaviGPS GT-31/BGT-31 SiRF binary logfile (.sbn) (sbn) ................................................ Naviguide binary route file (.twl) (naviguide) ................................................................ output option ................................................................................................ reorder option .............................................................................................. Navitel binary track (.bin) (navitel_trk) ......................................................................... Navitrak DNA marker format (dna) ............................................................................. NetStumbler Summary File (text) (netstumbler) ..............................................................

77 77 77 77 78 78 78 79 79 79 79 80 80 81 81 81 81 81 82 82 82 82 82 84 84 85 86 86 86 86 86 87 87 87 87 87 88 88 88 88 89 89 89 89 90 90 90 90 90 91 91 91 91 91

viii


nseicon option .............................................................................................. 92 nsneicon option ............................................................................................ 92 seicon option ................................................................................................ 92 sneicon option .............................................................................................. 92 snmac option .................................................................................................. 92 NIMA/GNIS Geographic Names File (nima) ................................................................. 92 NMEA 0183 sentences (nmea) .................................................................................... 93 snlen option .................................................................................................. 93 gprmc option .................................................................................................. 93 gpgga option .................................................................................................. 94 gpvtg option .................................................................................................. 94 gpgsa option .................................................................................................. 94 date option .................................................................................................... 94 get_posn option ............................................................................................ 94 pause option .................................................................................................. 94 append_positioning option ........................................................................ 95 baud option .................................................................................................... 95 gisteq option ................................................................................................ 95 Nokia Landmark Exchange (lmx) ................................................................................ 95 binary option ................................................................................................ 96 OpenStreetMap data files (osm) .................................................................................. 96 tag option ...................................................................................................... 96 tagnd option .................................................................................................. 97 created_by option ........................................................................................ 97 OziExplorer (ozi) ...................................................................................................... 97 pack option .................................................................................................... 97 snlen option .................................................................................................. 98 snwhite option .............................................................................................. 98 snupper option .............................................................................................. 98 snunique option ............................................................................................ 98 wptfgcolor option ........................................................................................ 98 wptbgcolor option ........................................................................................ 98 proximity option .......................................................................................... 98 altunit option .............................................................................................. 98 proxunit option ............................................................................................ 99 PalmDoc Output (palmdoc) ........................................................................................ 99 nosep option .................................................................................................. 99 dbname option ................................................................................................ 99 encrypt option .............................................................................................. 99 logs option .................................................................................................... 99 bookmarks_short option .............................................................................. 99 PathAway Database for Palm/OS (pathaway) ............................................................... 100 date option .................................................................................................. 100 dbname option .............................................................................................. 100 dbicon option .............................................................................................. 100 deficon option ............................................................................................ 100 snlen option ................................................................................................ 100 PocketFMS breadcrumbs (pocketfms_bc) .................................................................... 101 PocketFMS flightplan (.xml) (pocketfms_fp) ................................................................ 101 PocketFMS waypoints (.txt) (pocketfms_wp) ............................................................... 101 Quovadis (quovadis) ................................................................................................ 101 dbname option .............................................................................................. 102 Raymarine Waypoint File (.rwf) (raymarine) ................................................................ 102 location option ........................................................................................... 102

ix


Ricoh GPS Log File (ricoh) ...................................................................................... See You flight analysis data (cup) .............................................................................. Skymap / KMD150 ascii files (skyforce) ..................................................................... SkyTraq Venus based loggers (download) (skytraq) ....................................................... erase option ................................................................................................ targetlocation option ............................................................................... baud option .................................................................................................. initbaud option ........................................................................................... read-at-once option ................................................................................... first-sector option ................................................................................... last-sector option ..................................................................................... dump-file option ......................................................................................... no-output option ......................................................................................... SkyTraq Venus based loggers Binary File Format (skytraq-bin) ....................................... first-sector option ................................................................................... last-sector option ..................................................................................... Sportsim track files (part of zipped .ssz files) (sportsim) ................................................. SubRip subtitles for video mapping (.srt) (subrip) ......................................................... video_time option ....................................................................................... gps_time option ........................................................................................... gps_date option ........................................................................................... Suunto Trek Manager (STM) .sdf files (stmsdf) ............................................................ index option ................................................................................................ Suunto Trek Manager (STM) WaypointPlus files (stmwpp) ............................................. index option ................................................................................................ Swiss Map 25/50/100 (.xol) (xol) ............................................................................... Tab delimited fields useful for OpenOffice, Ploticus etc. (openoffice) ............................... Teletype [ Get Jonathon Johnson to describe (teletype) ................................................... Textual Output (text) ............................................................................................... nosep option ................................................................................................ encrypt option ............................................................................................ logs option .................................................................................................. degformat option ......................................................................................... altunits option ........................................................................................... splitoutput option ..................................................................................... TomTom Itineraries (.itn) (tomtom_itn) ....................................................................... TomTom Places Itineraries (.itn) (tomtom_itn_places) .................................................... TomTom POI file (.asc) (tomtom_asc) ........................................................................ TomTom POI file (.ov2) (tomtom) ............................................................................. TopoMapPro Places File (tmpro) ............................................................................... TrackLogs digital mapping (.trl) (dmtlog) .................................................................... index option ................................................................................................ U.S. Census Bureau Tiger Mapping Service (tiger) ........................................................ nolabels option ........................................................................................... genurl option .............................................................................................. margin option .............................................................................................. snlen option ................................................................................................ oldthresh option ......................................................................................... oldmarker option ......................................................................................... newmarker option ......................................................................................... suppresswhite option ................................................................................. unfoundmarker option ................................................................................. xpixels option ............................................................................................ ypixels option ............................................................................................

102 103 103 103 104 105 105 105 105 106 106 106 106 106 107 107 107 107 108 108 108 108 109 109 109 110 110 110 110 111 111 111 111 111 111 112 112 112 112 112 113 113 113 113 114 114 114 114 114 115 115 115 115 115

x


iconismarker option ................................................................................... Universal csv with field structure in first line (unicsv) .................................................... datum option ................................................................................................ grid option .................................................................................................. utc option .................................................................................................... format option .............................................................................................. filename option ........................................................................................... Vcard Output (for iPod) (vcard) ................................................................................. encrypt option ............................................................................................ VidaOne GPS for Pocket PC (.gpb) (vidaone) .............................................................. ver option .................................................................................................... Vito Navigator II tracks (vitosmt) .............................................................................. Vito SmartMap tracks (.vtt) (vitovtt) ........................................................................... WiFiFoFum 2.0 for PocketPC XML (wfff) .................................................................. aicicon option ............................................................................................ aioicon option ............................................................................................ ahcicon option ............................................................................................ ahoicon option ............................................................................................ snmac option ................................................................................................ Wintec TES file (wintec_tes) .................................................................................... Wintec WBT-100/200 Binary File Format (wbt-bin) ...................................................... Wintec WBT-100/200 GPS Download (wbt) ................................................................ erase option ................................................................................................ Wintec WBT-201/G-Rays 2 Binary File Format (wbt-tk1) .............................................. XAiOX iTrackU Logger (itracku) .............................................................................. backup option .............................................................................................. new option .................................................................................................... XAiOX iTrackU Logger Binary File Format (itracku-bin) ............................................... backup option .............................................................................................. new option .................................................................................................... Yahoo Geocode API data (yahoo) .............................................................................. addrsep option ............................................................................................ 4. Data Filters ................................................................................................................ Include Only Points Inside Polygon (polygon) .............................................................. file option ...................................................................................................... exclude option ................................................................................................ Include Only Points Within Distance of Arc (arc) ......................................................... file option ...................................................................................................... distance option ................................................................................................ exclude option ................................................................................................ points option .................................................................................................. Include Only Points Within Radius (radius) ................................................................. lat option ....................................................................................................... lon option ...................................................................................................... distance option ................................................................................................ exclude option ................................................................................................ nosort option .................................................................................................. maxcount option ............................................................................................. asroute option ................................................................................................. Interpolate between trackpoints (interpolate) ................................................................ time option .................................................................................................... distance option ................................................................................................ route option .................................................................................................... Manipulate altitudes (height) .....................................................................................

115 115 118 118 118 118 119 119 119 119 120 120 120 121 121 121 121 122 122 122 122 123 123 123 124 124 124 125 125 125 125 126 127 127 128 128 128 129 129 129 130 130 130 130 130 131 131 131 131 131 132 132 132 133

xi


add option ...................................................................................................... wgs84tomsl option .......................................................................................... Manipulate track lists (track) ..................................................................................... move option ................................................................................................... pack option .................................................................................................... split option ..................................................................................................... sdistance option .............................................................................................. merge option .................................................................................................. name option ................................................................................................... start option ..................................................................................................... stop option ..................................................................................................... title option ..................................................................................................... fix option ....................................................................................................... course option .................................................................................................. speed option ................................................................................................... seg2trk option ................................................................................................. trk2seg option ................................................................................................. segment option ............................................................................................... faketime option ............................................................................................... Rearrange waypoints by resorting (sort) ...................................................................... gcid option ..................................................................................................... shortname option ............................................................................................. description option ............................................................................................ time option .................................................................................................... Remove all waypoints, tracks, or routes (nuketypes) ...................................................... waypoints option ............................................................................................. tracks option .................................................................................................. routes option .................................................................................................. Remove Duplicates (duplicate) .................................................................................. shortname option ............................................................................................. location option ................................................................................................ all option ....................................................................................................... correct option ................................................................................................. Remove Points Within Distance (position) ................................................................... distance option ................................................................................................ all option ....................................................................................................... time option .................................................................................................... Remove unreliable points with high hdop or vdop (discard) ............................................ hdop option .................................................................................................... vdop option .................................................................................................... hdopandvdop option ........................................................................................ sat option ....................................................................................................... fixnone option ................................................................................................ fixunknown option .......................................................................................... elemin option ................................................................................................. elemax option ................................................................................................. Reverse stops within routes (reverse) .......................................................................... Save and restore waypoint lists (stack) ........................................................................ push option .................................................................................................... pop option ..................................................................................................... swap option .................................................................................................... copy option .................................................................................................... append option ................................................................................................. discard option .................................................................................................

133 133 133 133 134 134 134 135 135 135 136 136 136 136 136 137 137 137 137 138 138 138 138 138 138 139 139 139 139 139 140 140 140 140 141 141 141 141 142 142 142 142 142 142 142 143 143 143 144 144 144 144 144 144

xii


replace option ................................................................................................. 145 depth option ................................................................................................... 145 Simplify routes (simplify) ......................................................................................... 145 count option ................................................................................................... 145 error option .................................................................................................... 145 crosstrack option ............................................................................................. 146 length option .................................................................................................. 146 relative option ................................................................................................ 146 Swap latitude and longitude of all loaded points (swap) .................................................. 146 Transform waypoints into a route, tracks into routes, ... (transform) .................................. 146 wpt option ..................................................................................................... 147 rte option ....................................................................................................... 147 trk option ....................................................................................................... 147 del option ...................................................................................................... 147 A. Supported Datums ....................................................................................................... 149 B. Garmin Icons ............................................................................................................. 150 C. GPSBabel XCSV Style Files ......................................................................................... 152 Introduction to GPSBabel Styles ................................................................................ 152 Style file overview .................................................................................................. 152 Internal Constants ................................................................................................... 153 WHITESPACE ............................................................................................... 154 COMMENTS ................................................................................................. 154 Global Properties of the File ..................................................................................... 154 DESCRIPTION .............................................................................................. 154 EXTENSION ................................................................................................. 154 ENCODING ................................................................................................... 154 DATUM ........................................................................................................ 155 DATATYPE ................................................................................................... 155 GPSBabel Behavior Directives .................................................................................. 155 SHORTLEN ................................................................................................... 155 SHORTWHITE .............................................................................................. 155 Defining the Layout of the File ................................................................................. 155 FIELD_DELIMITER ....................................................................................... 155 RECORD_DELIMITER ................................................................................... 156 BADCHARS .................................................................................................. 156 PROLOGUE .................................................................................................. 156 EPILOGUE .................................................................................................... 156 Defining Fields Within the File ................................................................................. 156 IGNORE ....................................................................................................... 157 CONSTANT .................................................................................................. 157 INDEX .......................................................................................................... 157 SHORTNAME ............................................................................................... 158 DESCRIPTION .............................................................................................. 158 NOTES ......................................................................................................... 158 URL ............................................................................................................. 158 URL_LINK_TEXT .......................................................................................... 158 ICON_DESCR ................................................................................................ 158 LAT_DECIMAL ............................................................................................. 159 LON_DECIMAL ............................................................................................ 159 LAT_INT32DEG ............................................................................................ 159 LON_INT32DEG ............................................................................................ 159 LAT_DECIMALDIR / LAT_DIRDECIMAL ........................................................ 159 LON_DECIMALDIR / LON_DIRDECIMAL ....................................................... 159 LAT_DIR / LON_DIR ..................................................................................... 159

xiii


LAT_HUMAN_READABLE ............................................................................ 160 MAP_EN_BNG .............................................................................................. 160 LON_HUMAN_READABLE ............................................................................ 160 LATLON_HUMAN_READABLE ..................................................................... 160 LAT_NMEA .................................................................................................. 160 LAT_DDMMDIR ............................................................................................ 161 LON_NMEA .................................................................................................. 161 LON_DDMMDIR ........................................................................................... 161 LAT_10EX / LON_10EX ................................................................................. 161 UTM ............................................................................................................. 161 UTM_EASTING ............................................................................................. 162 UTM_NORTHING .......................................................................................... 162 UTM_ZONE .................................................................................................. 162 UTM_ZONEC ................................................................................................ 162 .................................................................................................................... 162 ALT_FEET .................................................................................................... 162 ALT_METERS ............................................................................................... 162 HEART_RATE ............................................................................................... 163 CADENCE .................................................................................................... 163 EXCEL_TIME ................................................................................................ 163 TIMET_TIME ................................................................................................ 163 YYYYMMDD_TIME ...................................................................................... 163 GMT_TIME ................................................................................................... 163 LOCAL_TIME ............................................................................................... 164 HMSG_TIME ................................................................................................. 164 HMSL_TIME ................................................................................................. 164 ISO_TIME ..................................................................................................... 164 ISO_TIME_MS .............................................................................................. 164 NET_TIME .................................................................................................... 164 GEOCACHE_DIFF ......................................................................................... 165 GEOCACHE_TERR ........................................................................................ 165 GEOCACHE_CONTAINER ............................................................................. 165 GEOCACHE_TYPE ........................................................................................ 165 GEOCACHE_PLACER .................................................................................... 165 GEOCACHE_ISAVAILABLE .......................................................................... 165 GEOCACHE_ISARCHIVED ............................................................................ 166 GEOCACHE_LAST_FOUND ........................................................................... 166 GEOCACHE_HINT ........................................................................................ 166 PATH_DISTANCE_MILES .............................................................................. 166 PATH_DISTANCE_KM .................................................................................. 166 PATH_SPEED ................................................................................................ 166 PATH_SPEED_KPH ....................................................................................... 167 PATH_SPEED_MPH ....................................................................................... 167 PATH_SPEED_KNOTS ................................................................................... 167 PATH_COURSE ............................................................................................. 167 GPS_HDOP / GPS_VDOP / GPS_PDOP ............................................................. 167 GPS_SAT ...................................................................................................... 167 GPS_FIX ....................................................................................................... 167 TRACK_NEW ................................................................................................ 168 TRACK_NAME ............................................................................................. 168 ROUTE_NAME .............................................................................................. 168 STREET_NAME ............................................................................................ 168 CITY ............................................................................................................ 168 COUNTRY .................................................................................................... 168

xiv


FACILITY ..................................................................................................... PHONE_NR ................................................................................................... POSTAL_CODE ............................................................................................. FILENAME ................................................................................................... FORMAT ...................................................................................................... Examples ............................................................................................................... Miscellaneous Notes ................................................................................................ Default Values ................................................................................................ Glossary ........................................................................................................................

169 169 169 169 169 169 170 170 171

xv

List of Tables3.1. 3.2. 3.3. 3.4. 3.5. 3.6. 3.7. 3.8. Grid values for garmin_txt ........................................................................................... 38 Supported distance units (garmin_gpi) ............................................................................ 42 Supported speed units (garmin_gpi) ............................................................................... 43 Track point structure (16 bytes) ..................................................................................... 56 Devices supported by MTK module ............................................................................... 85 Devices supported by skytraq module ........................................................................... 104 Vito SmartMap track file header (8 bytes) ..................................................................... 120 Vito SmartMap track point (32 bytes) ........................................................................... 120

xvi

List of Examples2.1. Command showing Linux download from Magellan serial and writing to .loc file ..................... 3 2.2. Command showing Windows download from Magellan serial and writing to .loc file ................. 4 2.3. Merging multiple files into one ....................................................................................... 5 2.4. Merging multiple files of differing types. .......................................................................... 5 2.5. Writing the same data in multiple output formats. .............................................................. 5 2.6. Read realtime positioning from Garmin USB, write to Keyhole Markup .................................. 7 2.7. Read realtime positioning from Wintec WBT-201 via Bluetooth on Mac, write to Keyhole Markup ............................................................................................................................. 7 3.1. Command showing writing to Bushnell files .................................................................... 13 3.2. Conversion of a v900 csv log file to a gpx format ............................................................. 15 3.3. Conversion of a v900 csv log file to a gpx 1.1 format ........................................................ 15 3.4. Example 'csv' file ....................................................................................................... 16 3.5. Command to send a pocket query (GPX) to a Delorme PN device ....................................... 22 3.6. Example for gdb bitcategory option to put all waypoints in categories 1 and 16. ...................... 35 3.7. Using gdb option roadbook to create simple html roadbook ............................................. 35 3.8. Command showing garmin_txt output with all options ....................................................... 37 3.9. Command showing garmin_gpi output example ................................................................ 40 3.10. Read GPX file, create GPI to alert when you're 1/2 mile from a speed camera. ...................... 42 3.11. Example for garmin bitcategory option to put all waypoints in categories 1 and 16. ................ 48 3.12. Command showing DG-100 download and erase on Linux ................................................ 52 3.13. Command showing DG-100 erase_only option on Linux .................................................. 52 3.14. Forcing creation of old Mobile Mapper files .................................................................. 79 3.15. Sample BCR command with all options ........................................................................ 81 3.16. Convert MTK binary trackpoints to GPX ...................................................................... 84 3.17. Command showing MTK download track and waypoints and erase on Linux ........................ 86 3.18. Command showing skytraq download of tracks and erasing the logger on Linux .................. 104 3.19. Command showing skytraq erasing the logger without download on Linux ......................... 104 3.20. Command showing skytraq download tracks via bluetooth on Linux .................................. 104 3.21. Set the target location of the Skytraq location finder ...................................................... 105 3.22. Command showing how to read data from an erased device ............................................. 106 3.23. Example for splitoutput option to text format ................................................................ 111 3.24. Example for unicsv format option to write names of input formats. ................................... 118 3.25. Example for unicsv filename option to write filenames of input formats. ............................ 119 3.26. Command showing conversion of a Wintec binary file to GPX ........................................ 122 3.27. Command showing WBT-200 download and erase over Bluetooth on Mac OS X ................. 123 3.28. Command showing conversion of a Wintec binary file to GPX ........................................ 123 3.29. Command showing a download from itracku connected to com14. .................................... 124 3.30. Command showing a download from itracku with automatic port detection. ........................ 124 3.31. Download from the data logger while and append the new binary logger data to a backup file. Read the contents of the backup file. ............................................................................ 124 3.32. Download from the data logger and append the new logger data to a backup file. Output only the new waypoints. .......................................................................................................... 125 3.33. Command showing reading an itracku data file. ............................................................ 125 4.1. Using the polygon filter ............................................................................................. 128 4.2. Using the polygon and arc filters to find points in or nearly in a polygon ............................. 128 4.3. Using the arc filter .................................................................................................... 129 4.4. Using the radius filter to find points close to a given point ................................................ 130 4.5. Using the interpolate filter .......................................................................................... 132 4.6. This option subtracts the WGS84 geoid height from every altitude. For GPS receivers like the iBlue747 the result is the height above mean see level. .......................................................... 133 4.7. This options adds a constant value to every altitude. ........................................................ 133

xvii


4.8. Time-shifting a track with the track filter ...................................................................... 4.9. Merging tracks with the track filter .............................................................................. 4.10. Extracting a period of time with the track filter ............................................................. 4.11. Replace time values of a track ................................................................................... 4.12. Add time values to a track ........................................................................................ 4.13. Filtering data types with nuketypes ............................................................................. 4.14. Using the duplicate filter to suppress points with the same name and location ...................... 4.15. Using the duplicate filter to implement an "ignore list." .................................................. 4.16. Using the duplicate filter to correct the locations of "puzzle" geocaches ............................. 4.17. Using the position filter to suppress close points ........................................................... 4.18. Using the discard filter for HDOP and VDOP. ............................................................. 4.19. Using the discard filter to require at least three satellites. ............................................... 4.20. Converting a track to a sequence of waypoints .............................................................. 4.21. Converting a pile of waypoints to a GPX route ............................................................. 4.22. Converting a pile of waypoints to a GPX track ............................................................. 4.23. Convert a GPX track to GPX waypoints, tossing the original track ....................................

134 135 136 137 138 139 139 140 140 141 141 142 147 147 147 148

xviii

Introduction to GPSBabelThe Problem: Too many incompatible GPS file formatsThere are simply too many gratuitously different file formats to hold waypoint, track, and route information in various programs used by computers and GPS receivers. GPX [http://www.topografix.com/gpx.asp] defines a standard in XML to contain all the data, but there are too many programs that don't understand it yet and too much data in alternate formats. Perhaps you have an Explorist 600 and your friend has a StreetPilot 2720. You've collected a list of your favorite locations as waypoints and you'd like to be able to share them. Unfortunately, his copy of Garmin Mapsource won't read data created by your copy of Magellan Mapsend DirectRoute. What you need is a program that converts data bewteen the two programs. GPSBabel actually solves that problem for you and much more...

The SolutionThe original author of GPSBabel, Robert Lipe [/people/robertlipe.html], needed to convert waypoints between a couple of formats, so he whipped up a converter and designed it upon an extensible foundation so that it was easy to add new formats and made the program freely available. Many others [/people/ index.html] have contributed to the program since then. Most file formats added so far have taken under 200 lines of reasonable ISO C so they can be stamped out pretty trivially. Formats that are ASCII text delimited in some fixed way can be added with no programming at all via our style mechanism.

xix

Chapter 1. Getting or Building GPSBabelDownloading - the easy way.GPSBabel is distributed "ready to run" on most common operating systems via the download page [http:// www.gpsbabel.org/download.html]. As GPSBabel runs on a wide variety of operating systems, be sure to visit the OS-Specific notes [http:// www.gpsbabel.org/osnotes.html] for additional information.

Building from source.For operating systems where no binary is provided or if you want the latest development version, you will have to build it from source. The code should be compilable on any system with ISO C89 compilers. It's been tested on UnixWare, OpenServer, OS/X, Linux, Solaris, and a variety of processors and compilers. You can grab a release from the GPSBabel download page [http://www.gpsbabel.org/download.html], but if you're going to be doing any development, you'll find that working from the GPSBabel CVS tree [http:// sourceforge.net/cvs/?group_id=58972] is easier. In most cases, the code is as simple to build as running: ./configure && make Expat [http://expat.sourceforge.net] is strongly recommended for source builds as it is required for reading all the XML formats such as GPX. Fedora users may need to 'yum install expat-devel'. Ubuntu users may need to 'apt-get install expat libexpat-dev'. libusb [http://libusb.sourceforge.net] is recommended for OS/X and Linux if you want to use a USB Garmin. Fedora users may need to 'yum install libusb-devel'. Ubuntu users may need to 'apt-get install libusb-dev'. There are additional flags that can be passed to configure to customize your build of GPSBabel. ./configure --help lists all the supported options, but of interest we have: --disable-shapefile Excludes the shapefile support. --disable-pdb Excludes the Palm database support and all formats that rely on it. --disable-csv Excludes all support for our something-separated formats. --disable-filters Excludes all filter support. --enable-efence Activate debugging mode for gpsbabel-debug. --with-doc=dir Specifies that the doc should be created and installed in dir.

1

Getting or Building GPSBabel

--without-libusb Disables use of libusb, even it's it's available. --with-zlib=(included)|system|no By default, we use our own version of zlib. If you specify system the system zlib is used. A value of no (or --without-zlib) disables zlib.

2

Chapter 2. UsageInvocationIf you're using GPSBabel, you will need to know how to do at least two things: read data from a file, and write it to another file. There are four basic options you need to know to do those things: Command: -i format Meaning: Set input format Command: -f filename Meaning: Read file Command: -o format Meaning: Set output format Command: -F filename Meaning: Write output file

ImportantCase matters. Notably -f (lowercase) sets the input file. -F (uppercase) sets the output file. The format parameters in the above list refer to the names of formats or file types supported by GPSBabel. gpsbabel -? will always show you the supported file types. In this document, the various supported formats are listed in Chapter 3, The Formats. The name that you would use on the command line follows the format name in parentheses. Options are always processed in order from left to right. In practical terms, this means that things you want to read should appear in the command before things you want to write. This sometimes surprises new users as adding options to turn on debugging at the end, for example, doesn't work as the debugging is turned on after all the interesting work is done. The reason for this strict ordering becomes more apparent once you learn about mixing formats and filters. The filename parameters specify the name of a file to be read or written. To use GPSBabel in its simplest form, just tell it what you're reading, where to read it from, what you're writing, and what to write it to. For example: gpsbabel -i geo -f /tmp/geocaching.loc -o gpx -F /tmp/geocaching.gpx tells it to read the file /tmp/geocaching.loc in geocaching.com format and create a new file /tmp/ geocaching.gpx in GPX format. It's important to note that the names have nothing to do with the formats actually used. This command will read from a Magellan unit attached to the first serial port on a Linux system (device names will vary on other OSes; typically COMx: on WIndows) and write them as a geocaching loc file.

Example 2.1. Command showing Linux download from Magellan serial and writing to .loc filegpsbabel -i magellan -f /dev/ttyS0 -o geo -F mag.loc

3

Usage

This second command does the same on Microsoft Windows.

Example 2.2. Command showing Windows download from Magellan serial and writing to .loc filegpsbabel -i magellan -f com1

gpsbabel-1.4.2

Documents

mountain bike

lowest common

suunto trek

snunique optionmake

automatic

snupper optionuppercase

national geographic

mobile mapper