# GPSBabel

(GDAL/OGR >= 1.8.0)

The GPSBabel driver for now that relies on the GPSBabel utility to access various GPS file formats.

The GPSBabel executable must be accessible through the PATH.

## Read support

The driver needs the GPX driver to be fully configured with read support (through Expat library) to be able to parse the output of GPSBabel, as GPX is used as the intermediate pivot format.

The returned layers can be waypoints, routes, route_points, tracks, track_points depending on the input data.

The syntax to specify an input datasource is : GPSBabel:gpsbabel_file_format[,gpsbabel_format_option]*:[features=[waypoints,][tracks,][routes]:]filename where :

- gpsbabel_file_format is one of the file formats handled by GPSBabel.
- gpsbabel_format_option is any option handled by the specified GPSBabel format (refer to the documentation of each GPSBabel format)
- features= can be used to modify the type of features that GPSBabel will import. waypoints matches the -w option of gpsbabel commmandline, tracks matches -t and routes matches -r. This option can be used to require full data import from GPS receivers that are slow and for which GPSBabel would only fetch waypoints by default. See the documentation on Route and Track modes for more details.
- filename can be an actual on-disk file, a file handled through the GDAL virtual file API, or a special device handled by GPSBabel such as "usb:", "/dev/ttyS0", "COM1:", etc.. What is actually supported depends on the used GPSBabel format.

Alternatively, for a few selected GPSBabel formats, just specifying the filename might be sufficient. The list includes for now :

- garmin_txt
- gdb
- magellan
- mapsend
- mapsource
- nmea
- osm
- ozi

The USE_TEMPFILE=YES configuration option can be used to create an on-disk temporary GPX file instead of a in-memory one, when reading big amount of data.

## Write support

The driver relies on the GPX driver to create an intermediate file that will be finally translated by GPSBabel to the desired GPSBabel format. (The GPX driver does not need to be configured for read support for GPSBabel write support.).

The support geometries, options and other creation issues are the ones of the GPX driver. Please refer to its documentation for more details.

The syntax to specify an output datasource is : GPSBabel:gpsbabel_file_format[,gpsbabel_format_option]*:filename where :

- gpsbabel_file_format is one of the file formats handled by GPSBabel.
- gpsbabel_format_option is any option handled by the specified GPSBabel format (refer to the documentation of each GPSBabel format)

Alternatively, you can just pass a filename as output datasource name and specify the dataset creation option GPSBABEL_DRIVER=gpsbabel_file_format[,gpsbabel_format_option]*

The USE_TEMPFILE=YES configuration option can be used to create an on-disk temporary GPX file instead of a in-memory one, when writing big amount of data.

### Examples

- Reading the waypoints from a Garmin USB receiver :

      ogrinfo -ro -al GPSBabel:garmin:usb:

- Converting a shapefile to Magellan Mapsend format :

      ogr2ogr -f GPSBabel GPSBabel:mapsend:out.mapsend in.shp

  ### See Also

  - GPSBabel Home Page

  - GPSBabel file formats

  - GPX driver page