raster (version 2.0-05)

KML: Write a KML or KMZ file

Description

Export raster data to a KML file and an accompanying PNG image file. Multi-layer objects can be used to create an animation. The function attempts to combine these into a single (and hence more convenient) KMZ file (a zip file containing the KML and PNG files).

Usage

## S3 method for class 'RasterLayer':
KML(x, filename, col=rev(terrain.colors(255)), colNA=NA, maxpixels=100000, blur=1, zip='', ...)

## S3 method for class 'RasterStackBrick':
KML(x, filename, time=NULL, col=rev(terrain.colors(255)), colNA=NA, maxpixels=100000, blur=1, zip='', ...)

Arguments

x

Raster* object

filename

output filename

time

character vector with time lables for multilayer objects. The lenght of this vector should be nlayers(x) to indicate "when" or nlayers(x)+1 to indicate "begin-end"

col

color scheme to be used (see image)

colNA

The color to use for the backgournd (default is transparant)

maxpixels

maximum number of pixels. If ncell(raster) > maxpixels, sampleRegular is used to reduce the number of pixels

blur

Integer (default=1). Higher values help avoid blurring of isolated pixels (at the expense of a png file that is blur^2 times larger)

zip

If there is no zip program on your path (on windows), you can supply the full path to a zip.exe here, in order to make a KMZ file

...

Additional arguments that can be passed to image

Value

• None. Used for the side-effect files written to disk.

Examples

# Meuse data from the sp package
data(meuse.grid)
b <- rasterFromXYZ(meuse.grid)
projection(b) <- "+init=epsg:28992 +towgs84=565.237,50.0087,465.658,-0.406857,0.350733,-1.87035,4.0812
                  +proj=sterea +lat_0=52.15616055555555 +lon_0=5.38763888888889 +k=0.9999079 +x_0=155000
				  +y_0=463000 +ellps=bessel +units=m +no_defs"
				  
# transform to longitude/latitude
p <- projectRaster(b, crs="+proj=longlat +datum=WGS84", method='ngb')
KML(p, file='meuse.kml')