R SDK quickstart

Requires: R with the sf package and an API key. Reading features over OGC is a Team / Enterprise plan capability. The SDK is in preview; the OGC API it wraps is generally available.

Install and create a client

Install topolab (it depends on sf for geometry handling) and set up a client with your key, read from the environment rather than committed to a script. Datasets are addressed by their table name.

install.packages("topolab")

library(topolab)

tl <- tl_client(api_key = Sys.getenv("TOPOLAB_API_KEY"))

Read a dataset into sf

tl_dataset() references a dataset by table; pipe it into as_sf() to materialize the features as an sf object with geometry in WGS84 (EPSG:4326). This reads from the OGC API, which is a Team / Enterprise plan capability.

poi <- tl_dataset(tl, "nl-domino-poi") |> as_sf()

plot(poi["city"])

GA equivalent while the SDK is in preview

sf::st_read can read the OGC items endpoint directly over HTTP via GDAL's OGC API - Features driver. Pass the key as an HTTP header through GDAL's config so it is not written to disk: Sys.setenv(GDAL_HTTP_HEADERS = "X-API-Key: tlb_prod_..."), then st_read("OAPIF:https://api.topolab.nl/v1/ogc/collections/nl-domino-poi"). Use sf::st_transform() for a projected CRS such as RD New (EPSG:28992).