Export sf objects into kml file that can be used with Google Earth, Google Maps, etc.
Attention: this function requires libkml.
ll_export_sf_to_kml( sf, path, name = NULL, keep_other_columns = TRUE, description = NULL, label_text = NULL, label_font = "Roboto Sans, Noto Sans, Helvetica", label_size = "24pt", label_placement = "m", label_scale = NULL, line_colour = "#ffffffff", line_width = "3px", icon_url = "", icon_colour = "#000000ff", icon_scale = NULL, fill_colour = NULL )
An object of class
Path where to save the .kml output.
Column to be used for names.
Logical, defaults to TRUE. If you don't want to keep in the output data columns present in the original
sfobject, set this to FALSE.
Column to be used for description.
Column to be used as label text. Defaults to NULL. Corresponds to "LABEL" element in OGR.
Font family to be used for the font. Defaults to "Roboto Sans, Noto Sans, Helvetica"
Size of the label. Defaults to "24pt"
Defaults to "m" (centre and middle-aligned). For more options, check: https://gdal.org/user/ogr_feature_style.html
Scale of label. Defaults to NULL. If given, changes label size (e.g. 1 = default, 2 = twice as big, 0.5, half as big, etc.)
Defaults to "#ffffffff" (i.e. white, with 100% opacity). Line corresponds to "PEN" in OGR. Accepts 8-digit hex codes to include transparency.
Defaults to "3pt". Line corresponds to "PEN" in OGR. Besides pt (points), other acceptable units are
g: Map Ground Units (whatever the map coordinate units are),
ptPoints (1/72 inch),
Defaults to "" for no URL. Corresponds to "SYMBOL" in OGR. In case of wrong inputs, Google Earth may show you an ugly yellow pushpin instead (i.e. default to http://maps.google.com/mapfiles/kml/pushpin/ylw-pushpin.png). Available icons offered by Google available at this link: http://kml4earth.appspot.com/icons.html
Defaults to "#000000ff" (i.e. black, with 100% opacity).
Defaults to NULL. If given, changes icon size (e.g. 1 = default, 2 = twice as big, 0.5, half as big, etc.)
Defaults to NULL. Fill corresponds to "BRUSH" in OGR. If given, colour to be used for filling polygons.
Attention: label styling is not currently functional, likely due to issues in passing arguments to libkml. In order to change label size, use label_scale, which directly edits the xml file.
For further details on the exact meaning of each of the parameters, please consult the documentation of OGR (used by GDAL to pass parameters to .kml): https://gdal.org/user/ogr_feature_style.html