The lookup API allows to query the address and other details of one or
multiple OSM objects like node, way or relation. This function returns the
tibble
associated with the query, see
geo_address_lookup_sf()
for retrieving the data as a spatial object
(sf
format).
Arguments
- osm_ids
Vector of OSM identifiers as numeric (
c(00000, 11111, 22222)
).- type
Vector character of the type of the OSM type associated to each
osm_ids
. Possible values are node ("N"
), way ("W"
) or relation ("R"
). If a single value is provided it would be recycled.- lat
Latitude column name in the output data (default
"lat"
).- long
Longitude column name in the output data (default
"long"
).- full_results
Returns all available data from the API service. If
FALSE
(default) only latitude, longitude and address columns are returned. See alsoreturn_addresses
.- return_addresses
Return input addresses with results if
TRUE
.- verbose
If
TRUE
then detailed logs are output to the console.- nominatim_server
The URL of the Nominatim server to use. Defaults to
"https://nominatim.openstreetmap.org/"
.- custom_query
A named list with API-specific parameters to be used (i.e.
list(countrycodes = "US")
). See Details.
Value
A tibble
with the results found by the query.
Details
See https://nominatim.org/release-docs/develop/api/Lookup/ for additional
parameters to be passed to custom_query
.
See also
Address Lookup API:
geo_address_lookup_sf()
Geocoding:
geo_address_lookup_sf()
,
geo_amenity()
,
geo_amenity_sf()
,
geo_lite()
,
geo_lite_sf()
,
geo_lite_struct()
,
geo_lite_struct_sf()
Examples
# \donttest{
ids <- geo_address_lookup(osm_ids = c(46240148, 34633854), type = "W")
ids
#> # A tibble: 2 × 4
#> query lat lon address
#> <chr> <dbl> <dbl> <chr>
#> 1 W46240148 40.8 -73.9 5th Avenue, East Harlem, Manhattan, New York County, Ci…
#> 2 W34633854 40.7 -74.0 Empire State Building, 350, 5th Avenue, Manhattan Commu…
several <- geo_address_lookup(c(146656, 240109189), type = c("R", "N"))
several
#> # A tibble: 2 × 4
#> query lat lon address
#> <chr> <dbl> <dbl> <chr>
#> 1 R146656 53.5 -2.25 Manchester, Greater Manchester, England, United Kingdom
#> 2 N240109189 52.5 13.4 Berlin, 10117, Deutschland
# }