Title:	Geocoding for the Netherlands
Version:	0.2.2
Description:	Interface to the open location server API of 'Publieke Diensten Op de Kaart' (http://www.pdok.nl). It offers geocoding, address suggestions and lookup of geographical objects. Included is an utility function for displaying leaflet tiles restricted to the Netherlands.
Depends:	R (≥ 3.4)
License:	GPL-2
BugReports:	https://github.com/uRosConf/nlgeocoder/issues
URL:	https://github.com/uRosConf/nlgeocoder, https://urosconf.github.io/nlgeocoder/
Encoding:	UTF-8
LazyData:	true
RoxygenNote:	7.3.3
Suggests:	testthat, knitr, rmarkdown, sf, shiny, leaflet
VignetteBuilder:	knitr
Imports:	jsonlite
NeedsCompilation:	no
Packaged:	2025-12-10 21:35:03 UTC; edwin
Author:	Willy Tadema [aut], Egge-Jan Pollé [aut], Edwin de Jonge [aut, cre], Juris Breidaks [ctb]
Maintainer:	Edwin de Jonge <edwindjonge@gmail.com>
Repository:	CRAN
Date/Publication:	2025-12-16 14:40:02 UTC

nlgeocoder package

Description

The nlgeocoder package provides a R wrapper around the pdok webservice.

Details

it allows to geocode data using the following functions:

• nl_geocode(): geocode a vector of addresses.

• nl_free(): find possible matches for one address.

• nl_suggest(): find possible suggestions for one address.

• nl_lookup(): lookup information of object found in nl_suggest.

Author(s)

Maintainer: Edwin de Jonge edwindjonge@gmail.com (ORCID)

Authors:

• Willy Tadema

• Egge-Jan Pollé

Other contributors:

• Juris Breidaks [contributor]

See Also

Useful links:

• https://github.com/uRosConf/nlgeocoder

• https://urosconf.github.io/nlgeocoder/

• Report bugs at https://github.com/uRosConf/nlgeocoder/issues

Leaflet function to add pdok tiles

Description

This function adds PDOK tile layers to leaflet::leaflet(). It is a small wrapper around leaflet::addTiles() that sets the correct urls for the layers.

Usage

addPdokTiles(
  map,
  type = c("brt", "aerial", "pastel", "gray"),
  group = match.arg(type),
  options,
  ...
)

Arguments

Details

PDOK provides tiles that can be used as a tile layer in several geovisualization tools including leaflet. The layers differ from other tile layers such as Openstreetmap, Google and cartomap in the following manner:

• The tiles are restricted to the Netherlands: tiles accross the Dutch border are "grayed out". This is useful for cartographic applications that are restricted to Dutch geo-information.

• The tiles are open source and based on open sourced geo-information.

Value

A leaflet::leaflet() map with the PDOK tile layer added.

Several Points of Interest (POI) that are included for test purposes.

Description

• POI, points of interest

• Address, Uncleaned address information.

Usage

addresses

Format

An object of class data.frame with 5 rows and 2 columns.

Free geocoding search

Description

This function wraps the "free" pdok service, and allows for free search. For syntax and examples see the documentation of pdok. A more easy/convenient but simpler function for geocoding is nl_geocode().

Usage

nl_free(
  q,
  rows = NULL,
  start = NULL,
  fq = NULL,
  lat = NULL,
  lon = NULL,
  type = NULL,
  fl = NULL,
  df = NULL,
  ...,
  verbose = FALSE
)

Arguments

Value

The result of the pdok free webservice converted to a R list object.

See Also

nl_geocode()

Examples

if (requireNamespace("sf", quietly = TRUE)){
  l <- nl_free("Henri Faasdreef 312")
  l$response$numFound
  l$response$docs["weergavenaam"]
}

Geocode adresses

Description

nl_geocode returns for a vector of addresses the most probable object/location. This function is more user friendly than the barebones webservices (nl_free()), and uses the same function signature as ggmap::geocode.

Usage

nl_geocode(
  location,
  output = c("wgs84", "rd", "data.frame"),
  messaging = FALSE,
  type = "adres",
  ...,
  verbose = messaging
)

nl_geocode_rd(
  location,
  messaging = FALSE,
  type = "adres",
  ...,
  verbose = messaging
)

nl_geocode_df(
  location,
  messaging = FALSE,
  type = "adres",
  ...,
  verbose = messaging
)

Arguments

Details

type can be one or more of the following: "provincie", "gemeente" , "woonplaats", "weg", "postcode", "adres", "perceel", "hectometerpaal", "wijk", "buurt", "waterschapsgrens", "appartementsrecht".

Value

The return type can be specified and can be of type "sf" or "data.frame", depending on the value of output.

Examples

data("addresses")
r <- nl_geocode(addresses$Address, output = "data.frame")
r["weergavenaam"]
names(r)

# or if you have sf installed
if (requireNamespace("sf", quietly = TRUE)){
  r_sf <- nl_geocode(addresses$Address, output = "wgs84")
  print(r_sf)
}

Look up a geo object

Description

Retrieve detailed properties of a geo object found with nl_suggest() or nl_free().

Usage

nl_lookup(id, ..., output = c("list", "raw"), verbose = FALSE)

Arguments

Value

Depending on the value of output the raw search results in R format or the properties of the specific object as a R list object.

Examples

obj <- nl_lookup("weg-f633e85f07eda4e68a00fb13f9d128f5", output = "list")
names(obj)
obj$weergavenaam

experimental reverse api

Description

experimental reverse api

Usage

nl_reverse()

Get a list of suggestions for geolocations in NL

Description

nl_suggest returns a list of suggestions for a location description.

Usage

nl_suggest(
  q,
  ...,
  rows = NULL,
  type = NULL,
  verbose = FALSE,
  fl = NULL,
  sort = NULL,
  qf = NULL,
  bq = NULL
)

Arguments

Details

type can be one or more of the following: "provincie", "gemeente" , "woonplaats", "weg", "postcode", "adres", "perceel", "hectometerpaal", "wijk", "buurt", "waterschapsgrens", "appartementsrecht".

Value

The result of the pdok suggest webservice converted to a R list object.

Examples

sug <- nl_suggest("Henri Faasdreef")

# how many objects have a score?
sug$response$numFound

# get suggestions
sug$response$docs

Dummy function only used for describing common api parameters

Description

Dummy function only used for describing common api parameters

Usage

query(
  rows = NULL,
  start = NULL,
  fq = NULL,
  lat = NULL,
  lon = NULL,
  indent = NULL,
  wt = "json"
)

Arguments