tmaptools (version 2.0-2)

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 (http://wiki.openstreetmap.org/wiki/Nominatim_usage_policy).

Usage

rev_geocode_OSM(x, y = NULL, zoom = NULL, projection = NULL,
  as.data.frame = NA, server = "http://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. Either a CRS object or a character value. If it is a character, it can either be a PROJ.4 character string or a shortcut. See get_proj4 for a list of shortcut values. By default latitude longitude coordinates.

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 frmame or a list with all atributes that are contained in the search result

See Also

geocode_OSM

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 <- append_data(five_cities, addresses, fixed.order = TRUE)

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

    # restore current mode
    tmap_mode(current.mode)
}
# }