NAME

       kml2gmt - Extract GMT table data from Google Earth KML files

SYNOPSIS

       kml2gmt  [ kmlfiles ] [ s|l|p ] [ [level] ] [  ] [ -bo<binary> ] [ -do<nodata> ] [ -:[i|o]
       ]

       Note: No space is allowed between the option flag and the associated arguments.

DESCRIPTION

       kml2gmt reads a Google Earth KML file and outputs a GMT table file.  Only KML  files  that
       contain  points, lines, or polygons can be processed.  This is a bare-bones operation that
       aims to extract coordinates and possibly the name and description tags  of  each  feature.
       The main use intended is to capture coordinates modified in Google Earth and then reinsert
       the modified data into the original GMT data  file.  For  a  more  complete  reformatting,
       consider using ogr2ogr -f "GMT" somefile.gmt somefile.kml.

REQUIRED ARGUMENTS

       None.

OPTIONAL ARGUMENTS

       kmlfiles
              Name  of one or more KML files to work on. If not are given, then standard input is
              read.

       -Fs|l|p
              Specify a particular feature type to output.  Choose  from  points  (s),  line,  or
              polygon.  By default we output all geometries.

       -Z     Output  the  altitude  coordinates  as  GMT z coordinates [Default will output just
              longitude and latitude].

       -V[level] (more ...)
              Select verbosity level [c].

       -bo[ncols][type] (more ...)
              Select native binary output.

       -donodata (more ...)
              Replace output columns that equal NaN with nodata.

       -:[i|o] (more ...)
              Swap 1st and 2nd column on input and/or output.

       -^ or just -
              Print a short message about the syntax of the command, then exits (NOTE: on Windows
              use just -).

       -+ or just +
              Print  an  extensive  usage  (help)  message,  including  the  explanation  of  any
              module-specific option (but not the GMT common options), then exits.

       -? or no arguments
              Print a complete usage (help) message, including the explanation of  options,  then
              exits.

       --version
              Print GMT version and exit.

       --show-datadir
              Print full path to GMT share directory and exit.

EXAMPLES

       To extract the lon,lat values from the KML file google.kml, try
          gmt kml2gmt google.kml -V > google.txt

       To separate the point and polygon geometries from the KML file google.kml, try
          gmt kml2gmt google.kml -Fp -V > polygons.txt gmt kml2gmt google.kml -Fs -V > points.txt

SEE ALSO

       gmt, gmt.conf, img2google, psconvert, gmt2kml

COPYRIGHT

       2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe