tmaptools: rev_geocode_OSM – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

rev_geocode_OSM

Reverse geocodes a location using OpenStreetMap Nominatim

Description

Reverse geocodes a location (based on spatial coordinates) to an address. It uses OpenStreetMap Nominatim. For processing large amount of queries, please read the usage policy (https://operations.osmfoundation.org/policies/nominatim/).

Usage

rev_geocode_OSM(
  x,
  y = NULL,
  zoom = NULL,
  projection = 4326,
  as.data.frame = NA,
  server = "https://nominatim.openstreetmap.org"
)

Arguments

`x`	x coordinate(s), or a spatial points object (`sf` or `SpatialPoints`)
`y`	y coordinate(s)
`zoom`	zoom level
`projection`	projection in which the coordinates `x` and `y` are provided.
`as.data.frame`	return as data.frame (`TRUE`) or list (`FALSE`). By default a list, unless multiple coordinates are provided.
`server`	OpenStreetMap Nominatim server name. Could also be a local OSM Nominatim server.

Value

A data frame or a list with all attributes that are contained in the search result

Examples

## Not run: 
if (require(tmap)) {
    data(metro)

    # sample five cities from metro dataset
    set.seed(1234)
    five_cities <- metro[sample(length(metro), 5), ]

    # obtain reverse geocode address information
    addresses <- rev_geocode_OSM(five_cities, zoom = 6)
    five_cities <- sf::st_sf(data.frame(five_cities, addresses))

    # change to interactive mode
    current.mode <- tmap_mode("view")
    tm_shape(five_cities) +
    	tm_markers(text="name")

    # restore current mode
    tmap_mode(current.mode)
}

## End(Not run)

tmaptools

Thematic Map Tools

v3.1-1

GPL-3

Authors

Martijn Tennekes [aut, cre]

Initial release

2021-01-19