GPSBabel Documentation

iii

Table of ContentsIntroduction to GPSBabel ................................................................................................... xx

The Problem: Too many incompatible GPS file formats ................................................... xxThe Solution ............................................................................................................ xx

1. Getting or Building GPSBabel .......................................................................................... 1Downloading - the easy way. ....................................................................................... 1Building from source. .................................................................................................. 1

2. Usage ........................................................................................................................... 3Invocation ................................................................................................................. 3Suboptions ................................................................................................................ 4Advanced Usage ........................................................................................................ 4Route and Track Modes .............................................................................................. 5Working with predefined options .................................................................................. 6Realtime tracking ....................................................................................................... 7Batch mode (command files) ........................................................................................ 7List of Options ........................................................................................................... 8

3. The Formats ................................................................................................................. 10? Character Separated Values (xcsv) ............................................................................ 10

style option .................................................................................................. 10snlen option .................................................................................................. 10snwhite option .............................................................................................. 10snupper option .............................................................................................. 10snunique option ............................................................................................ 11urlbase option .............................................................................................. 11prefer_shortnames option .......................................................................... 11datum option .................................................................................................. 11

Alan Map500 tracklogs (.trl) (alantrl) ........................................................................... 11Alan Map500 waypoints and routes (.wpr) (alanwpr) ....................................................... 12All database fields on one tab-separated line (tabsep) ...................................................... 12Brauniger IQ Series Barograph Download (baroiq) ......................................................... 12Bushnell GPS Trail file (bushnell_trl) ........................................................................... 13Bushnell GPS Waypoint file (bushnell) ......................................................................... 13Cambridge/Winpilot glider software (cambridge) ............................................................ 14CarteSurTable data file (cst) ....................................................................................... 14Cetus for Palm/OS (cetus) .......................................................................................... 14

dbname option ................................................................................................ 14appendicon option ........................................................................................ 14

CoastalExplorer XML (coastexp) ................................................................................. 15Columbus/Visiontac V900 files (.csv) (v900) ................................................................. 15Comma separated values (csv) .................................................................................... 15CompeGPS data files (.wpt/.trk/.rte) (compegps) ............................................................ 16

deficon option .............................................................................................. 16index option .................................................................................................. 16radius option ................................................................................................ 17snlen option .................................................................................................. 17

CoPilot Flight Planner for Palm/OS (copilot) ................................................................. 17cotoGPS for Palm/OS (coto) ....................................................................................... 17

zerocat option .............................................................................................. 18Custom "Everything" Style (custom) ............................................................................ 18Data Logger iBlue747 csv (iblue747) ........................................................................... 18Data Logger iBlue757 csv (iblue757) ........................................................................... 18

INDEX ........................................................................................................... 19


iv

RCR ............................................................................................................... 19DATE ............................................................................................................. 19TIME .............................................................................................................. 19VALID ........................................................................................................... 19LATITUDE ..................................................................................................... 19N/S ................................................................................................................. 19LONGITUDE ................................................................................................... 19E/W ................................................................................................................ 20HEIGHT ......................................................................................................... 20SPEED ............................................................................................................ 20DISTANCE ..................................................................................................... 20Example File .................................................................................................... 20

Dell Axim Navigation System (.gpb) file format (axim_gpb) ............................................ 20DeLorme .an1 (drawing) file (an1) ............................................................................... 20

type option .................................................................................................... 21road option .................................................................................................... 21nogc option .................................................................................................... 22nourl option .................................................................................................. 22deficon option .............................................................................................. 22color option .................................................................................................. 23zoom option .................................................................................................... 23wpt_type option ............................................................................................ 23radius option ................................................................................................ 23

DeLorme GPL (gpl) .................................................................................................. 23DeLorme PN-20/PN-30/PN-40 USB protocol (delbin) ..................................................... 23

get_posn option ............................................................................................ 24logs option .................................................................................................... 24long_notes option ........................................................................................ 25nukewpt option .............................................................................................. 25nuketrk option .............................................................................................. 25nukerte option .............................................................................................. 25hint_at_end option ...................................................................................... 25gcsym option .................................................................................................. 25

DeLorme Street Atlas Plus (saplus) .............................................................................. 25DeLorme Street Atlas Route (saroute) .......................................................................... 26

turns_important option .............................................................................. 26turns_only option ........................................................................................ 26split option .................................................................................................. 26controls option ............................................................................................ 26times option .................................................................................................. 27

DeLorme XMap HH Native .WPT (xmap) .................................................................... 27DeLorme XMap/SAHH 2006 Native .TXT (xmap2006) ................................................... 27DeLorme XMat HH Street Atlas USA .WPT (PPC) (xmapwpt) ......................................... 27Destinator Itineraries (.dat) (destinator_itn) .................................................................... 29Destinator Points of Interest (.dat) (destinator_poi) .......................................................... 29Destinator TrackLogs (.dat) (destinator_trl) ................................................................... 29EasyGPS binary format (easygps) ................................................................................ 30Embedded Exif-GPS data (.jpg) (exif) .......................................................................... 30

filename option ............................................................................................ 30frame option .................................................................................................. 30name option .................................................................................................... 31overwrite option .......................................................................................... 31

Enigma binary waypoint file (.ert) (enigma) .................................................................. 31FAI/IGC Flight Recorder Data Format (igc) .................................................................. 31


v

IGC Data Format Notes ..................................................................................... 32Converting to IGC format .................................................................................. 32Converting from IGC format .............................................................................. 33Merging into IGC format ................................................................................... 33timeadj option .............................................................................................. 34

Flexible and Interoperable Data Transfer (FIT) Activity filefit (garmin_fit) .......................... 34FlySight GPS File (flysight) ....................................................................................... 34Franson GPSGate Simulation (gpssim) ......................................................................... 35

wayptspd option ............................................................................................ 35split option .................................................................................................. 35

Fugawi (fugawi) ....................................................................................................... 35G7ToWin data files (.g7t) (g7towin) ............................................................................ 36Garmin 301 Custom position and heartrate (garmin301) ................................................... 36Garmin Logbook XML (glogbook) .............................................................................. 36Garmin MapSource - gdb (gdb) ................................................................................... 37

cat option ...................................................................................................... 37bitscategory option .................................................................................... 37ver option ...................................................................................................... 37via option ...................................................................................................... 37roadbook option ............................................................................................ 38

Garmin MapSource - mps (mapsource) ......................................................................... 38snlen option .................................................................................................. 38snwhite option .............................................................................................. 39mpsverout option .......................................................................................... 39mpsmergeout option ...................................................................................... 39mpsusedepth option ...................................................................................... 39mpsuseprox option ........................................................................................ 39

Garmin MapSource - txt (tab delimited) (garmin_txt) ...................................................... 39date option .................................................................................................... 40datum option .................................................................................................. 40dist option .................................................................................................... 40grid option .................................................................................................... 40prec option .................................................................................................... 41temp option .................................................................................................... 41time option .................................................................................................... 41utc option ...................................................................................................... 41

Garmin PCX5 (pcx) .................................................................................................. 41deficon option .............................................................................................. 42cartoexploreur option ................................................................................ 42

Garmin POI database (garmin_poi) .............................................................................. 42Garmin Points of Interest (.gpi) (garmin_gpi) ................................................................. 42

alerts option ................................................................................................ 43bitmap option ................................................................................................ 43category option ............................................................................................ 43hide option .................................................................................................... 44descr option .................................................................................................. 44notes option .................................................................................................. 44position option ............................................................................................ 44proximity option .......................................................................................... 44sleep option .................................................................................................. 45speed option .................................................................................................. 45unique option ................................................................................................ 46units option .................................................................................................. 46

Garmin serial/USB protocol (garmin) ........................................................................... 46


vi

snlen option .................................................................................................. 49snwhite option .............................................................................................. 49deficon option .............................................................................................. 49get_posn option ............................................................................................ 50power_off option .......................................................................................... 50erase_t option .............................................................................................. 50resettime option .......................................................................................... 50category option ............................................................................................ 50bitscategory option .................................................................................... 51

Garmin Training Center (gtrnctr) ................................................................................. 51course option ................................................................................................ 52sport option .................................................................................................. 52

Garmin Training Center (.tcx) (gtrnctr) ......................................................................... 52course option ................................................................................................ 52sport option .................................................................................................. 52

Geocaching.com .loc (geo) .......................................................................................... 52deficon option .............................................................................................. 52nuke_placer option ...................................................................................... 53

GeocachingDB for Palm/OS (gcdb) .............................................................................. 53Geogrid-Viewer ascii overlay file (.ovl) (ggv_ovl) .......................................................... 53Geogrid-Viewer tracklogs (.log) (ggv_log) .................................................................... 54GEOnet Names Server (GNS) (geonet) ......................................................................... 54GeoNiche .pdb (geoniche) .......................................................................................... 54

dbname option ................................................................................................ 54category option ............................................................................................ 55

GlobalSat DG-100/BT-335 Download (dg-100) .............................................................. 55erase option .................................................................................................. 55erase_only option ........................................................................................ 55

GlobalSat DG-200 Download (dg-200) ......................................................................... 56erase option .................................................................................................. 56erase_only option ........................................................................................ 56

Google Earth (Keyhole) Markup Language (kml) ........................................................... 56deficon option .............................................................................................. 57lines option .................................................................................................. 57points option ................................................................................................ 57line_width option ........................................................................................ 58line_color option ........................................................................................ 58floating option ............................................................................................ 58extrude option .............................................................................................. 58track option .................................................................................................. 58trackdata option .......................................................................................... 58trackdirection option ................................................................................ 58units option .................................................................................................. 59labels option ................................................................................................ 59max_position_points option ...................................................................... 59

Google Maps XML (google) ....................................................................................... 59Google Navigator Tracklines (.trl) (gnav_trl) ................................................................. 60GoPal GPS track log (.trk) (gopal) ............................................................................... 60

date option .................................................................................................... 61maxspeed option ............................................................................................ 61minspeed option ............................................................................................ 61clean option .................................................................................................. 61

GpilotS (gpilots) ....................................................................................................... 61dbname option ................................................................................................ 62


vii

GPS Tracking Key Pro text (land_air_sea) .................................................................... 62GPS TrackMaker (gtm) .............................................................................................. 62GPSBabel arc filter file (arc) ...................................................................................... 62GpsDrive Format (gpsdrive) ....................................................................................... 63GpsDrive Format for Tracks (gpsdrivetrack) .................................................................. 63GPSman (gpsman) .................................................................................................... 63GPSPilot Tracker for Palm/OS (gpspilot) ...................................................................... 63

dbname option ................................................................................................ 64gpsutil (gpsutil) ........................................................................................................ 64GPX XML (gpx) ...................................................................................................... 64

snlen option .................................................................................................. 64suppresswhite option .................................................................................. 65logpoint option ............................................................................................ 65urlbase option .............................................................................................. 65gpxver option ................................................................................................ 65humminbirdextensions option .................................................................... 65garminextensions option ............................................................................ 65

HikeTech (hiketech) .................................................................................................. 66Holux (gm-100) .wpo Format (holux) ........................................................................... 66Holux M-241 (MTK based) Binary File Format (m241-bin) .............................................. 66

csv option ...................................................................................................... 67Holux M-241 (MTK based) download (m241) ............................................................... 67

erase option .................................................................................................. 67erase_only option ........................................................................................ 67log_enable option ........................................................................................ 67csv option ...................................................................................................... 68

Honda/Acura Navigation System VP Log File Format (vpl) .............................................. 68HSA Endeavour Navigator export File (hsandv) ............................................................. 68HTML Output (html) ................................................................................................. 69

stylesheet option ........................................................................................ 69encrypt option .............................................................................................. 69logs option .................................................................................................... 69degformat option .......................................................................................... 69altunits option ............................................................................................ 69

Humminbird tracks (.ht) (humminbird_ht) ..................................................................... 70Humminbird waypoints and routes (.hwr) (humminbird) .................................................. 70IGN Rando track files (ignrando) ................................................................................ 71

index option .................................................................................................. 71iGO2008 points of interest (.upoi) (igo2008_poi) ............................................................ 71IGO8 .trk (igo8) ........................................................................................................ 71

tracknum option ............................................................................................ 71title option .................................................................................................. 72description option ...................................................................................... 72

Jelbert GeoTagger data file (jtr) .................................................................................. 72Jogmap.de XML format (jogmap) ................................................................................ 72Kartex 5 Track File (ktf2) .......................................................................................... 72Kartex 5 Waypoint File (kwf2) ................................................................................... 73Kompass (DAV) Track (.tk) (kompass_tk) .................................................................... 73Kompass (DAV) Waypoints (.wp) (kompass_wp) ........................................................... 73KuDaTa PsiTrex text (psitrex) .................................................................................... 73Lowrance USR (lowranceusr) ..................................................................................... 74

ignoreicons option ...................................................................................... 74writeasicons option .................................................................................... 74merge option .................................................................................................. 74


viii

break option .................................................................................................. 74wversion option ............................................................................................ 74

Lowrance USR version 4 (lowranceusr4) ...................................................................... 75title option .................................................................................................. 75serialnum option .......................................................................................... 75description option ...................................................................................... 75

Magellan Explorist Geocaching (maggeo) ..................................................................... 75Magellan Mapsend (mapsend) ..................................................................................... 76

trkver option ................................................................................................ 76Magellan NAV Companion for Palm/OS (magnav) ......................................................... 76Magellan SD files (as for eXplorist) (magellanx) ............................................................ 77

deficon option .............................................................................................. 77maxcmts option .............................................................................................. 77

Magellan SD files (as for Meridian) (magellan) .............................................................. 77deficon option .............................................................................................. 78maxcmts option .............................................................................................. 78

Magellan serial protocol (magellan) ............................................................................. 78deficon option .............................................................................................. 80maxcmts option .............................................................................................. 80baud option .................................................................................................... 80noack option .................................................................................................. 80nukewpt option .............................................................................................. 80

MagicMaps IK3D project file (.ikt) (ik3d) ..................................................................... 81Map&Guide 'TourExchangeFormat' XML (tef) ........................................................ 81

routevia option ............................................................................................ 81Map&Guide to Palm/OS exported files (.pdb) (mag_pdb) .......................................... 81MapAsia track file (.tr7) (mapasia_tr7) ......................................................................... 82Mapopolis.com Mapconverter CSV (mapconverter) ......................................................... 82

Notes .............................................................................................................. 82MapTech Exchange Format (mxf) ................................................................................ 83Memory-Map Navigator overlay files (.mmo) (mmo) ...................................................... 83

locked option ................................................................................................ 83visible option .............................................................................................. 84ver option ...................................................................................................... 84

Microsoft AutoRoute 2002 (pin/route reader) (msroute) ................................................... 84Microsoft Streets and Trips (pin/route reader) (msroute) ................................................... 85Microsoft Streets and Trips 2002-2007 (s_and_t) ............................................................ 85MiniHomer, a skyTraq Venus 6 based logger (download tracks, waypoints and get/set POI)(miniHomer) ............................................................................................................ 85

baud option .................................................................................................... 86dump-file option .......................................................................................... 87erase option .................................................................................................. 87first-sector option .................................................................................... 87initbaud option ............................................................................................ 87last-sector option ...................................................................................... 88no-output option .......................................................................................... 88read-at-once option .................................................................................... 88Home option .................................................................................................... 88Car option ...................................................................................................... 89Boat option .................................................................................................... 89Heart option .................................................................................................. 89Bar option ...................................................................................................... 90

Mobile Garmin XT Track files (garmin_xt) ................................................................... 90ftype option .................................................................................................. 90


ix

trk_header option ........................................................................................ 90Motoactiv CSV (motoactv) ......................................................................................... 91Motorrad Routenplaner (Map&Guide) .bcr files (bcr) ................................................ 91

index option .................................................................................................. 91name option .................................................................................................... 92radius option ................................................................................................ 92prefer_shortnames option .......................................................................... 92

MS PocketStreets 2002 Pushpin (psp) .......................................................................... 92Frequently Asked Questions ............................................................................... 92

MTK Logger (iBlue 747,...) Binary File Format (mtk-bin) ................................................ 94csv option ...................................................................................................... 94

MTK Logger (iBlue 747,Qstarz BT-1000,...) download (mtk) ........................................... 95erase option .................................................................................................. 96erase_only option ........................................................................................ 96log_enable option ........................................................................................ 96csv option ...................................................................................................... 96

National Geographic Topo .tpg (waypoints) (tpg) ............................................................ 96datum option .................................................................................................. 97

National Geographic Topo 2.x .tpo (tpo2) ..................................................................... 97National Geographic Topo 3.x/4.x .tpo (tpo3) ................................................................ 97Navicache.com XML (navicache) ................................................................................ 97

noretired option .......................................................................................... 98Navigon Mobile Navigator .rte files (nmn4) ................................................................... 98

index option .................................................................................................. 98Navigon Waypoints (navigonwpt) ................................................................................ 98NaviGPS GT-11/BGT-11 Download (navilink) .............................................................. 98

nuketrk option .............................................................................................. 99nukerte option .............................................................................................. 99nukewpt option .............................................................................................. 99nukedlg option ............................................................................................ 100datalog option ............................................................................................ 100power_off option ......................................................................................... 100

NaviGPS GT-31/BGT-31 datalogger (.sbp) (sbp) .......................................................... 100NaviGPS GT-31/BGT-31 SiRF binary logfile (.sbn) (sbn) ............................................... 100Naviguide binary route file (.twl) (naviguide) ............................................................... 101

output option .............................................................................................. 101reorder option ............................................................................................ 101

Navitel binary track (.bin) (navitel_trk) ....................................................................... 101Navitrak DNA marker format (dna) ............................................................................ 101NetStumbler Summary File (text) (netstumbler) ............................................................ 102

nseicon option ............................................................................................ 102nsneicon option ........................................................................................... 102seicon option .............................................................................................. 102sneicon option ............................................................................................ 102snmac option ................................................................................................ 102

NIMA/GNIS Geographic Names File (nima) ................................................................ 103NMEA 0183 sentences (nmea) .................................................................................. 103

snlen option ................................................................................................ 103gprmc option ................................................................................................ 104gpgga option ................................................................................................ 104gpvtg option ................................................................................................ 104gpgsa option ................................................................................................ 104date option .................................................................................................. 104get_posn option ........................................................................................... 105


x

pause option ................................................................................................ 105append_positioning option ....................................................................... 105baud option .................................................................................................. 105gisteq option .............................................................................................. 105ignore_fix option ....................................................................................... 106

Nokia Landmark Exchange (lmx) ............................................................................... 106binary option .............................................................................................. 106

OpenStreetMap data files (osm) ................................................................................. 106tag option .................................................................................................... 107tagnd option ................................................................................................ 107created_by option ....................................................................................... 107

OziExplorer (ozi) .................................................................................................... 107pack option .................................................................................................. 108snlen option ................................................................................................ 108snwhite option ............................................................................................ 108snupper option ............................................................................................ 108snunique option ........................................................................................... 108wptfgcolor option ....................................................................................... 108wptbgcolor option ....................................................................................... 108proximity option ......................................................................................... 109altunit option ............................................................................................ 109proxunit option ........................................................................................... 109

PalmDoc Output (palmdoc) ....................................................................................... 109nosep option ................................................................................................ 109dbname option .............................................................................................. 109encrypt option ............................................................................................ 110logs option .................................................................................................. 110bookmarks_short option ............................................................................. 110

PathAway Database for Palm/OS (pathaway) ............................................................... 110date option .................................................................................................. 110dbname option .............................................................................................. 110dbicon option .............................................................................................. 110deficon option ............................................................................................ 111snlen option ................................................................................................ 111

PocketFMS breadcrumbs (pocketfms_bc) .................................................................... 111PocketFMS flightplan (.xml) (pocketfms_fp) ................................................................ 111PocketFMS waypoints (.txt) (pocketfms_wp) ............................................................... 111Quovadis (quovadis) ................................................................................................ 112

dbname option .............................................................................................. 112Raymarine Waypoint File (.rwf) (raymarine) ................................................................ 112

location option ........................................................................................... 112Ricoh GPS Log File (ricoh) ...................................................................................... 113See You flight analysis data (cup) .............................................................................. 113Skymap / KMD150 ascii files (skyforce) ..................................................................... 113SkyTraq Venus based loggers (download) (skytraq) ....................................................... 114

erase option ................................................................................................ 115targetlocation option ............................................................................... 115baud option .................................................................................................. 115initbaud option ........................................................................................... 115read-at-once option ................................................................................... 116first-sector option ................................................................................... 116last-sector option ..................................................................................... 116dump-file option ......................................................................................... 116no-output option ......................................................................................... 116


xi

SkyTraq Venus based loggers Binary File Format (skytraq-bin) ....................................... 117first-sector option ................................................................................... 117last-sector option ..................................................................................... 117

Sportsim track files (part of zipped .ssz files) (sportsim) ................................................. 117SubRip subtitles for video mapping (.srt) (subrip) ......................................................... 117

video_time option ....................................................................................... 118gps_time option ........................................................................................... 118gps_date option ........................................................................................... 118

Suunto Trek Manager (STM) .sdf files (stmsdf) ............................................................ 118index option ................................................................................................ 119

Suunto Trek Manager (STM) WaypointPlus files (stmwpp) ............................................. 119index option ................................................................................................ 120

Swiss Map 25/50/100 (.xol) (xol) ............................................................................... 120Tab delimited fields useful for OpenOffice, Ploticus etc. (openoffice) ............................... 120Teletype [ Get Jonathon Johnson to describe (teletype) ................................................... 120Textual Output (text) ............................................................................................... 121

nosep option ................................................................................................ 121encrypt option ............................................................................................ 121logs option .................................................................................................. 121degformat option ......................................................................................... 121altunits option ........................................................................................... 121splitoutput option ..................................................................................... 121

TomTom Itineraries (.itn) (tomtom_itn) ....................................................................... 122TomTom Places Itineraries (.itn) (tomtom_itn_places) .................................................... 122TomTom POI file (.asc) (tomtom_asc) ........................................................................ 122TomTom POI file (.ov2) (tomtom) ............................................................................. 122TopoMapPro Places File (tmpro) ............................................................................... 123TrackLogs digital mapping (.trl) (dmtlog) .................................................................... 123

index option ................................................................................................ 123U.S. Census Bureau Tiger Mapping Service (tiger) ........................................................ 123

nolabels option ........................................................................................... 124genurl option .............................................................................................. 124margin option .............................................................................................. 124snlen option ................................................................................................ 124oldthresh option ......................................................................................... 124oldmarker option ......................................................................................... 125newmarker option ......................................................................................... 125suppresswhite option ................................................................................. 125unfoundmarker option ................................................................................. 125xpixels option ............................................................................................ 125ypixels option ............................................................................................ 125iconismarker option ................................................................................... 125

Universal csv with field structure in first line (unicsv) .................................................... 126datum option ................................................................................................ 128grid option .................................................................................................. 128utc option .................................................................................................... 128format option .............................................................................................. 128filename option ........................................................................................... 129

Vcard Output (for iPod) (vcard) ................................................................................. 129encrypt option ............................................................................................ 129

VidaOne GPS for Pocket PC (.gpb) (vidaone) .............................................................. 129ver option .................................................................................................... 130

Vito Navigator II tracks (vitosmt) .............................................................................. 130Vito SmartMap tracks (.vtt) (vitovtt) ........................................................................... 130


xii

WiFiFoFum 2.0 for PocketPC XML (wfff) .................................................................. 131aicicon option ............................................................................................ 131aioicon option ............................................................................................ 131ahcicon option ............................................................................................ 132ahoicon option ............................................................................................ 132snmac option ................................................................................................ 132

Wintec TES file (wintec_tes) .................................................................................... 132Wintec WBT-100/200 Binary File Format (wbt-bin) ...................................................... 132Wintec WBT-100/200 GPS Download (wbt) ................................................................ 133

erase option ................................................................................................ 133Wintec WBT-201/G-Rays 2 Binary File Format (wbt-tk1) .............................................. 133XAiOX iTrackU Logger (itracku) .............................................................................. 134

backup option .............................................................................................. 134new option .................................................................................................... 134

XAiOX iTrackU Logger Binary File Format (itracku-bin) ............................................... 135backup option .............................................................................................. 135new option .................................................................................................... 135

Yahoo Geocode API data (yahoo) .............................................................................. 135addrsep option ............................................................................................ 136

4. Data Filters ................................................................................................................ 137Add points before and after bends in routes (bend) ........................................................ 137

distance option ................................................................................................ 137minangle option .............................................................................................. 137

Include Only Points Inside Polygon (polygon) .............................................................. 138file option ...................................................................................................... 139exclude option ................................................................................................ 139

Include Only Points Within Distance of Arc (arc) ......................................................... 139file option ...................................................................................................... 140rte option ....................................................................................................... 140trk option ....................................................................................................... 140distance option ................................................................................................ 140exclude option ................................................................................................ 140points option .................................................................................................. 141project option ................................................................................................. 141

Include Only Points Within Radius (radius) ................................................................. 141lat option ....................................................................................................... 141lon option ...................................................................................................... 141distance option ................................................................................................ 141exclude option ................................................................................................ 142nosort option .................................................................................................. 142maxcount option ............................................................................................. 142asroute option ................................................................................................. 142

Interpolate between trackpoints (interpolate) ................................................................ 142time option .................................................................................................... 143distance option ................................................................................................ 143route option .................................................................................................... 143

Manipulate altitudes (height) ..................................................................................... 144add option ...................................................................................................... 144wgs84tomsl option .......................................................................................... 144

Manipulate track lists (track) ..................................................................................... 144move option ................................................................................................... 144pack option .................................................................................................... 145split option ..................................................................................................... 145sdistance option .............................................................................................. 145


xiii

merge option .................................................................................................. 146name option ................................................................................................... 146start option ..................................................................................................... 146stop option ..................................................................................................... 147title option ..................................................................................................... 147fix option ....................................................................................................... 147course option .................................................................................................. 147speed option ................................................................................................... 148seg2trk option ................................................................................................. 148trk2seg option ................................................................................................. 148segment option ............................................................................................... 148faketime option ............................................................................................... 148discard option ................................................................................................. 149

Rearrange waypoints by resorting (sort) ...................................................................... 149gcid option ..................................................................................................... 149shortname option ............................................................................................. 149description option ............................................................................................ 149time option .................................................................................................... 150

Remove all waypoints, tracks, or routes (nuketypes) ...................................................... 150waypoints option ............................................................................................. 150tracks option .................................................................................................. 150routes option .................................................................................................. 150

Remove Duplicates (duplicate) .................................................................................. 150shortname option ............................................................................................. 151location option ................................................................................................ 151all option ....................................................................................................... 151correct option ................................................................................................. 151

Remove Points Within Distance (position) ................................................................... 152distance option ................................................................................................ 152all option ....................................................................................................... 152time option .................................................................................................... 152

Remove unreliable points with high hdop or vdop (discard) ............................................ 153hdop option .................................................................................................... 153vdop option .................................................................................................... 153hdopandvdop option ........................................................................................ 153sat option ....................................................................................................... 154fixnone option ................................................................................................ 154fixunknown option .......................................................................................... 154elemin option ................................................................................................. 154elemax option ................................................................................................. 154

Reverse stops within routes (reverse) .......................................................................... 154Save and restore waypoint lists (stack) ........................................................................ 154

push option .................................................................................................... 155pop option ..................................................................................................... 155swap option .................................................................................................... 155copy option .................................................................................................... 156append option ................................................................................................. 156discard option ................................................................................................. 156replace option ................................................................................................. 156depth option ................................................................................................... 156

Simplify routes (simplify) ......................................................................................... 156count option ................................................................................................... 157error option .................................................................................................... 157crosstrack option ............................................................................................. 157


xiv

length option .................................................................................................. 157relative option ................................................................................................ 157

Swap latitude and longitude of all loaded points (swap) .................................................. 158Transform waypoints into a route, tracks into routes, ... (transform) .................................. 158

wpt option ..................................................................................................... 158rte option ....................................................................................................... 158trk option ....................................................................................................... 159del option ...................................................................................................... 159

A. Supported Datums ....................................................................................................... 160B. Garmin Icons ............................................................................................................. 161C. GPSBabel XCSV Style Files ......................................................................................... 163

Introduction to GPSBabel Styles ................................................................................ 163Style file overview .................................................................................................. 163Internal Constants ................................................................................................... 164

WHITESPACE ............................................................................................... 165COMMENTS ................................................................................................. 165

Global Properties of the File ..................................................................................... 165DESCRIPTION .............................................................................................. 165EXTENSION ................................................................................................. 165ENCODING ................................................................................................... 165DATUM ........................................................................................................ 166DATATYPE ................................................................................................... 166

GPSBabel Behavior Directives .................................................................................. 166SHORTLEN ................................................................................................... 166SHORTWHITE .............................................................................................. 166

Defining the Layout of the File ................................................................................. 166FIELD_DELIMITER ....................................................................................... 166FIELD_ENCLOSER ........................................................................................ 167RECORD_DELIMITER ................................................................................... 167BADCHARS .................................................................................................. 167PROLOGUE .................................................................................................. 167EPILOGUE .................................................................................................... 168

Defining Fields Within the File ................................................................................. 168IGNORE ....................................................................................................... 168CONSTANT .................................................................................................. 168INDEX .......................................................................................................... 169SHORTNAME ............................................................................................... 169DESCRIPTION .............................................................................................. 169NOTES ......................................................................................................... 169URL ............................................................................................................. 169URL_LINK_TEXT .......................................................................................... 169ICON_DESCR ................................................................................................ 170LAT_DECIMAL ............................................................................................. 170LON_DECIMAL ............................................................................................ 170LAT_INT32DEG ............................................................................................ 170LON_INT32DEG ............................................................................................ 170LAT_DECIMALDIR / LAT_DIRDECIMAL ........................................................ 170LON_DECIMALDIR / LON_DIRDECIMAL ....................................................... 171LAT_DIR / LON_DIR ..................................................................................... 171LAT_HUMAN_READABLE ............................................................................ 171MAP_EN_BNG .............................................................................................. 171LON_HUMAN_READABLE ............................................................................ 171LATLON_HUMAN_READABLE ..................................................................... 171LAT_NMEA .................................................................................................. 172


xv

LAT_DDMMDIR ............................................................................................ 172LON_NMEA .................................................................................................. 172LON_DDMMDIR ........................................................................................... 172LAT_10EX / LON_10EX ................................................................................. 172UTM ............................................................................................................. 173UTM_EASTING ............................................................................................. 173UTM_NORTHING .......................................................................................... 173UTM_ZONE .................................................................................................. 173UTM_ZONEC ................................................................................................ 173.................................................................................................................... 173ALT_FEET .................................................................................................... 174ALT_METERS ............................................................................................... 174HEART_RATE ............................................................................................... 174CADENCE .................................................................................................... 174POWER ........................................................................................................ 174TEMPERATURE ............................................................................................ 174TEMPERATURE_F ........................................................................................ 174EXCEL_TIME ................................................................................................ 175TIMET_TIME ................................................................................................ 175TIMET_TIME_MS .......................................................................................... 175YYYYMMDD_TIME ...................................................................................... 175GMT_TIME ................................................................................................... 175LOCAL_TIME ............................................................................................... 176HMSG_TIME ................................................................................................. 176HMSL_TIME ................................................................................................. 176ISO_TIME ..................................................................................................... 176ISO_TIME_MS .............................................................................................. 176NET_TIME .................................................................................................... 176GEOCACHE_DIFF ......................................................................................... 177GEOCACHE_TERR ........................................................................................ 177GEOCACHE_CONTAINER ............................................................................. 177GEOCACHE_TYPE ........................................................................................ 177GEOCACHE_PLACER .................................................................................... 177GEOCACHE_ISAVAILABLE .......................................................................... 177GEOCACHE_ISARCHIVED ............................................................................ 178GEOCACHE_LAST_FOUND ........................................................................... 178GEOCACHE_HINT ........................................................................................ 178PATH_DISTANCE_MILES .............................................................................. 178PATH_DISTANCE_KM .................................................................................. 178PATH_DISTANCE_METERS ........................................................................... 178PATH_SPEED ................................................................................................ 178PATH_SPEED_KPH ....................................................................................... 179PATH_SPEED_MPH ....................................................................................... 179PATH_SPEED_KNOTS ................................................................................... 179PATH_COURSE ............................................................................................. 179GPS_HDOP / GPS_VDOP / GPS_PDOP ............................................................. 179GPS_SAT ...................................................................................................... 179GPS_FIX ....................................................................................................... 180TRACK_NEW ................................................................................................ 180TRACK_NAME ............................................................................................. 180ROUTE_NAME .............................................................................................. 180STREET_NAME ............................................................................................ 180CITY ............................................................................................................ 180COUNTRY .................................................................................................... 180


xvi

FACILITY ..................................................................................................... 181PHONE_NR ................................................................................................... 181POSTAL_CODE ............................................................................................. 181FILENAME ................................................................................................... 181FORMAT ...................................................................................................... 181

Examples ............................................................................................................... 181Miscellaneous Notes ................................................................................................ 182

Default Values ................................................................................................ 182Glossary ........................................................................................................................ 183

xvii

List of Tables3.1. Grid values for garmin_txt ........................................................................................... 403.2. Supported distance units (garmin_gpi) ............................................................................ 453.3. Supported speed units (garmin_gpi) ............................................................................... 463.4. Track point structure (16 bytes) ..................................................................................... 603.5. Devices supported by miniHomer module ....................................................................... 863.6. Devices supported by MTK module ............................................................................... 953.7. Devices supported by skytraq module ........................................................................... 1143.8. Vito SmartMap track file header (8 bytes) ..................................................................... 1303.9. Vito SmartMap track point (32 bytes) ........................................................................... 131

xviii

List of Examples2.1. Command showing Linux download from Magellan serial and writing to .loc file ..................... 32.2. Command showing Windows download from Magellan serial and writing to .loc file ................. 42.3. Merging multiple files into one ....................................................................................... 52.4. Merging multiple files of differing types. .......................................................................... 52.5. Writing the same data in multiple output formats. .............................................................. 52.6. Read realtime positioning from Garmin USB, write to Keyhole Markup .................................. 72.7. Read realtime positioning from Wintec WBT-201 via Bluetooth on Mac, write to KeyholeMarkup ............................................................................................................................. 73.1. Command showing writing to Bushnell files .................................................................... 133.2. Conversion of a v900 csv log file to a gpx format ............................................................. 153.3. Conversion of a v900 csv log file to a gpx 1.1 format ........................................................ 153.4. Example 'csv' file ....................................................................................................... 163.5. Command to send a pocket query (GPX) to a Delorme PN device ....................................... 243.6. Example for gdb bitcategory option to put all waypoints in categories 1 and 16. ...................... 373.7. Using gdb option roadbook to create simple html roadbook ............................................. 383.8. Command showing garmin_txt output with all options ....................................................... 403.9. Command showing garmin_gpi output example ................................................................ 433.10. Read GPX file, create GPI to alert when you're 1/2 mile from a speed camera. ...................... 453.11. Example for garmin bitcategory option to put all waypoints in categories 1 and 16. ................ 513.12. Command showing DG-100 download and erase on Linux ................................................ 553.13. Command showing DG-100 erase_only option on Linux .................................................. 553.14. Command showing DG-200 download and erase on Linux ................................................ 563.15. Command showing DG-200 erase_only option on Linux .................................................. 563.16. Forcing creation of old Mobile Mapper files .................................................................. 843.17. Command showing miniHomer download of tracks and erasing the logger on Linux ............... 863.18. Command showing miniHomer erasing the logger without download on Linux ..................... 863.19. Command showing miniHomer setting Car and Home POI ............................................... 863.20. Command showing how to read data from an erased device .............................................. 873.21. Set the target location of the miniHomer Home POI ........................................................ 883.22. Set the target location of the miniHomer Car POI ........................................................... 893.23. Set the target location of the miniHomer Boat POI .......................................................... 893.24. Set the target location of the miniHomer Heart POI ......................................................... 903.25. Set the target location of the miniHomer Bar POI ........................................................... 903.26. Sample BCR command with all options ........................................................................ 913.27. Convert MTK binary trackpoints to GPX ...................................................................... 943.28. Command showing MTK download track and waypoints and erase on Linux ........................ 963.29. Command showing skytraq download of tracks and erasing the logger on Linux .................. 1143.30. Command showing skytraq erasing the logger without download on Linux ......................... 1143.31. Command showing skytraq download tracks via bluetooth on Linux .................................. 1153.32. Set the target location of the Skytraq location finder ...................................................... 1153.33. Command showing how to read data from an erased device ............................................. 1163.34. Example for splitoutput option to text format ................................................................ 1223.35. Example for unicsv format option to write names of input formats. ................................... 1283.36. Example for unicsv filename option to write filenames of input formats. ............................ 1293.37. Command showing conversion of a Wintec binary file to GPX ........................................ 1333.38. Command showing WBT-200 download and erase over Bluetooth on Mac OS X ................. 1333.39. Command showing conversion of a Wintec binary file to GPX ........................................ 1343.40. Command showing a download from itracku connected to com14. .................................... 1343.41. Command showing a download from itracku with automatic port detection. ........................ 1343.42. Download from the data logger while and append the new binary logger data to a backupfile. Read the contents of the backup file. ............................................................................ 134


xix

3.43. Download from the data logger and append the new logger data to a backup file. Output onlythe new waypoints. .......................................................................................................... 1353.44. Command showing reading an itracku data file. ............................................................ 1354.1. Using the polygon filter ............................................................................................. 1384.2. Using the polygon and arc filters to find points in or nearly in a polygon ............................. 1384.3. Using the arc filter .................................................................................................... 1404.4. Using the radius filter to find points close to a given point ................................................ 1414.5. Using the interpolate filter .......................................................................................... 1434.6. This option su

GPSBabel Documentation

Documents