![GRASS logo](grass_logo.png)
NAME
v.out.kml - Creates a KML-file from GRASS point/line/polygon vectors
KEYWORDS
SYNOPSIS
v.out.kml
v.out.kml help
v.out.kml [-lypr] map=string [output=string] [ogrpath=string] [color=string] [transparency=string] [fcolor=string] [ftransparency=string] [size=string] [iconcode=string] [iconpalette=string] [iconcolor=string] [icontransparency=string] [iconurl=string] [linecolumn=string] [fillcolumn=string] [linetranscolumn=string] [filltranscolumn=string] [--verbose] [--quiet]
Flags:
- -l
- Force line-vector export: Areas are exported as lines/polylines (default).
- -y
- Force polygon export: Areas are exported as polygons with a fillcolor and fill-transparency.
- -p
- Point-vector (sites) export: Point data are exported.
- -r
- Random colors: All line and area colors (if needed) are set to random values.
- --verbose
- Verbose module output
- --quiet
- Quiet module output
Parameters:
- map=string
- Vector input map
- output=string
- Name/path of KML output
- ogrpath=string
- Optional path to ogr2ogr
- color=string
- hexcode triplet for line color (blue:green:red 00:00:00-255:255:255)
- Default: 00:200:00
- transparency=string
- integer for vector line transparency (0=invisible 255=opaque)
- Default: 255
- fcolor=string
- hexcode triplet for polygon fill color (blue:green:red 00:00:00-255:255:255)
- Default: 00:100:00
- ftransparency=string
- integer for polygon transparency (00=invisible 255=opaque)
- Default: 255
- size=string
- width of the vector lines (default is 1)
- Options: 0.5,1,1.5,2,2.5,3,3.5,4,4.5,5,5.5,6,6.5,7,7.5,8,8.5,9,9.5,10
- Default: 1
- iconcode=string
- Select an icons number within its palette for point-vectors
- Options: 1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45
- Default: 1
- iconpalette=string
- Select a KML palette of icons for point-vectors
- Options: 1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20
- Default: 1
- iconcolor=string
- hexcode color triplet for point-vectors (blue:green:red 00:00:00-255:255:255)
- Default: 00:200:00
- icontransparency=string
- integer for point-vector transparency (0=invisible 255=opaque 0-255)
- Default: 255
- iconurl=string
- Provide a URL pointing to a symbol for point-vectors
- linecolumn=string
- column name string for line color ([xxx]:xxx:xxx:xxx). Transparency should be provided as first value, unless 3-Flag is set.
- fillcolumn=string
- column name string for area fill color ([xxx]:xxx:xxx:xxx). Transparency should be provided as first value, unless 3-Flag is set.
- linetranscolumn=string
- column name string for line transparency (xxx). This option is overridden by the 'transparency'-option.
- filltranscolumn=string
- column name string for fill transparency (xxx). This option is overridden by the 'transparency'-option.
DESCRIPTION
v.out.kml creates KML files from GRASS vector data,
including color, fillcolor, transparency and icons.
If no parameters are provided, v.out.kml will ask for the source vector layer and all other parameters.
The script allows to select wether polygons will be reduced to lines or kept as polygons.
Transparency values can be set seperately for both lines and polygon area fills.
Icons for point data can be referenced by ID numbers from the Google Earth web site or by individual URLs.
The color values can also be randomized. The random-color-flag overrides any additional color settings.
Flags
- -l
- Force line-vector export: Areas are exported as lines/polylines
(default) without a fillcolor.
- -y
- Force polygon export: Areas are exported as polygons with a fillcolor
and fill-transparency.
- -p
- Point-vector (sites) export: Point data will be exported.
- -r
- Random colors: All line and area colors (if needed) are set to
random values
Parameters
- vector
- Vector input map.
- output
- Name/path of kml output.
- ogrpath
- optional path to ogr2ogr.
- color
- integer triplet for
line color (blue:green:red 00:00:00-255:255:255).
- transparency
- integer for vector line
transparency (0=invisible 255=opaque) Standard: 255.
- fcolor
- integer triplet for polygon fill
color (blue:green:red 00:00:00-255:255:255).
- ftransparency
- integer for polygon transparency
(00=invisible 255=opaque)
Standard: 255.
- size
- width of the vector lines
(default is 1).
- iconcode
- Select an icons number within its
palette for point-vectors. Options: 1-45.
- iconpalette
- Select a KML palette of
icons for point-vectors. Options: 1-20 .
- iconcolor
- hexcode color triplet for point-vectors
(blue:green:red 00:00:00-255:255:255) Standard: 00:200:00.
- icontransparency
- integer for point-vector
transparency (0=invisible 255=opaque 0-255) Standard: 255.
- iconurl
- Provide a URL pointing to a symbol for point-vectors
.
- linecolumn
- The name of a database column
providing the line color as an integer triplet (blue:green:red 0:0:0 - 255:255:255)
- linetranscolumn
- The name of a database column providing the line
transparency as an integer value (0-255 0=invisible 255=opaque)
- fillcolumn
- The name of a database column
providing the line color as an integer triplet (blue:green:red 0:0:0 - 255:255:255)
- filltranscolumn
- The name of a database column providing the line
transparency as an integer value (0-255 0=invisible 255=opaque)
Notes
The script only works for data layers of the current mapset. If "user" is
the current mapset, trying to access vectors from other mapsets (like
"PERMANENT") will cause ungraceful script termination.
The scrip requires an installation of GDAL/OGR supporting GML (Geographic Markup Language).
If for some reason this is not available, or the local GDAL/OGR does not provide GML, install
FWTools from http://fwtools.maptools.org. They provide GML support.
To point the script to such a FWtools installation, use the ogrpath-parameter (pointing to ogr2ogr in FWtools).
Once started with this option, the script will remember the path for the current mapset, so this ordeal is only necessary once.
To be done
Currently lacking database support for point data (color/transparency)
The same random value will be applied to all instances of a [transparency|geometry]-class.
There might be a slight offset between the generic EPSG 4326 and the "lat
lon" used by Google Earth. The author would be grateful for feedback on this
issue.
AUTHOR
Peter Loewe, GISIX.com
Main index - vector index - Full index
© 2003-2014 GRASS Development Team