table_getNearestLocation: Return known locations

In MazamaScience/MazamaLocationUtils: Manage Spatial Metadata for Known Locations

Return known locations

Description

Returns a tibble of the known locations from locationTbl that are closest to the vector of target locations specified by longitude and latitude. Only a single known location is returned for each incoming target location. If no known location is found for a particular incoming location, that record in the tibble will contain all NA.

Usage

table_getNearestLocation(
  locationTbl = NULL,
  longitude = NULL,
  latitude = NULL,
  distanceThreshold = NULL
)

Arguments

locationTbl	Tibble of known locations.
longitude	Vector of longitudes in decimal degrees E.
latitude	Vector of latitudes in decimal degrees N.
distanceThreshold	Distance in meters.

Value

Tibble of known locations.

Examples

library(MazamaLocationUtils)

locationTbl <- get(data("wa_monitors_500"))

# Wenatchee
lon <- -120.325278
lat <- 47.423333

# Too small a distanceThreshold will not find a match
table_getNearestLocation(locationTbl, lon, lat, distanceThreshold = 50) %>% str()

# Expanding the distanceThreshold will find one
table_getNearestLocation(locationTbl, lon, lat, distanceThreshold = 5000) %>% str()

MazamaScience/MazamaLocationUtils documentation built on Jan. 26, 2024, 3:16 p.m.