kml_lines: Read Lines out of a KML file.

In briatte/tidykml: Turn KML Files Into Tidy Data Frames

Description

Read Lines out of a KML file.

Usage

kml_lines(x, ns = "d1", verbose = TRUE, ...)

Arguments

x	A KML source. See kml_read.
ns	The name of the namespace to extract from: defaults to "d1".
verbose	Whether to report invalid coordinates and/or altitudes below sea level; defaults to TRUE. See kml_coords.
...	Arguments passed to read_xml. See kml_read.

Value

A tibble containing the folder (layer), name, description, styleUrl and geographic coordinates (longitude, latitude and altitude) of the first LineString contained within each Placemark element of the KML source. Other Placemark elements will be ignored.

If there are no LineStrings in the KML source, the function returns NULL. If there are no Folders in the KML source, the folder variable will be filled with NA.

Note

The function only extracts the first LineString out of each Placemark element. As a result, multi-LineStrings built into <MultiGeometry> elements are not fully supported: only the first LineString will be present in the results.

References

Google Developers. KML Reference: <Point> Element. https://developers.google.com/kml/documentation/kmlreference#linestring

Examples

# demo data: U.S. Civil War map
# see ?states for details
f <- system.file("extdata", "states.kml.zip", package = "tidykml")
kml_lines(f)

briatte/tidykml documentation built on May 13, 2019, 7:43 a.m.