Merge pull request r-spatial#2464 from kadyb/main

enhance `st_as_text()` docs (for r-spatial#2361)
rsbivand · Oct 30, 2024 · 0d1a48b · 0d1a48b
2 parents 13a42be + a621f1d
commit 0d1a48b
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 0 deletions.
diff --git a/R/wkt.R b/R/wkt.R
@@ -85,6 +85,11 @@ prnt.GEOMETRYCOLLECTION = function(x, ..., EWKT = TRUE) {
 #' \href{https://www.ogc.org/standard/sfa/}{simple features access} specification and extensions
 #' (known as EWKT, supported by PostGIS and other simple features implementations for addition of 
 #' a SRID to a WKT string).
+#' @note To improve conversion performance, the lwgeom package can be used (it must be installed
+#' beforehand) and set the \code{Sys.setenv("LWGEOM_WKT" = "true")} environment variable. This
+#' will also result in faster printing of complex geometries. Note that the representation as WKT is
+#' different from the sf package and may cause reproducibility problems. An alternative solution is
+#' to use the [lwgeom::st_astext()] or [wk::as_wkt()] functions.
 #'
 #' @export
 st_as_text = function(x, ...) UseMethod("st_as_text")

diff --git a/man/st_as_text.Rd b/man/st_as_text.Rd