layer.STTDF: Write a space-time trajectory to KML

In Envirometrix/plotKML: Visualization of Spatial and Spatio-Temporal Objects in Google Earth

Write a space-time trajectory to KML

Description

Writes an object of class "STTDF" to a KML file with a possibility to parse attribute variables using several aesthetics arguments.

Usage

kml_layer.STTDF(obj, id.name = names(obj@data)[which(names(obj@data)== "burst")],
    dtime, extrude = FALSE, 
    start.icon = paste(get("home_url", envir = plotKML.opts),
         "3Dballyellow.png", sep = ""), 
    end.icon = paste(get("home_url", envir = plotKML.opts), 
          "golfhole.png", sep = ""), 
    LabelScale = 0.8 * get("LabelScale", envir = plotKML.opts), z.scale = 1,
    metadata = NULL, html.table = NULL, ... )

Arguments

obj	space-time object of class "STTDF" (spatio-temporal irregular data.frames trajectory)
id.name	trajectory ID column name
dtime	temporal support size (in seconds)
extrude	logical; extrude GPS vertices?
start.icon	start icon name (3Dballyellow.png)
end.icon	destination icon name (golfhole.png)
LabelScale	the default size of icons
z.scale	vertical exaggeration
metadata	(optional) specify the metadata object
html.table	optional description block (html) for each GPS point (vertices)
...	other optional arguments

Details

The dateTime is defined as yyyy-mm-ddThh:mm:sszzzzzz, where T is the separator between the date and the time, and the time zone is either Z (for UTC) or zzzzzz, which represents ±hh:mm in relation to UTC. For more info on how Time Stamps work see https://developers.google.com/kml/documentation/kml_tut. If the time is measured at block support, then:

<TimeStamp><begin> </begin><end> </end></TimeStamp>

tags will be inserted. Temporal support for any spacetime class, if not specified by the user, is determined as a difference between the "time" (indicating begin time) and "endTime" slots.

Author(s)

Tomislav Hengl

References

• Pebesma, E. (2012) Classes and Methods for Spatio-Temporal Data in R. Journal of Statistical Software. 51(7): 1-30.

• spacetime package (https://CRAN.R-project.org/package=spacetime)

See Also

readGPX, plotKML-method

Envirometrix/plotKML documentation built on June 13, 2022, 11:21 p.m.