location_initialize: Create known location record with core metadata

In MazamaScience/MazamaLocationUtils: Manage Spatial Metadata for Known Locations

Create known location record with core metadata

Description

Creates a known location record with the following columns of core metadata:

• locationID

• locationName

• longitude

• latitude

• elevation

• countryCode

• stateCode

• countyName

• timezone

• houseNumber

• street

• city

• postalCode

Usage

location_initialize(
  longitude = NULL,
  latitude = NULL,
  stateDataset = "NaturalEarthAdm1",
  elevationService = NULL,
  addressService = NULL,
  precision = 10,
  verbose = TRUE
)

Arguments

longitude	Single longitude in decimal degrees E.
latitude	Single latitude in decimal degrees N.
stateDataset	Name of spatial dataset to use for determining state
elevationService	Name of the elevation service to use for determining the elevation. Default: NULL skips this step. Accepted values: "usgs".
addressService	Name of the address service to use for determining the street address. Default: NULL skips this step. Accepted values: "photon".
precision	precision argument passed on to location_createID.
verbose	Logical controlling the generation of progress messages.

Value

Tibble with a single new known location.

Examples

library(MazamaLocationUtils)

# Fail gracefully if any resources are not available
try({

  # Set up standard directories and spatial data
  spatialDataDir <- tempdir() # typically "~/Data/Spatial"
  initializeMazamaSpatialUtils(spatialDataDir)

  # Wenatchee
  lon <- -120.325278
  lat <- 47.423333
  
  locationRecord <- location_initialize(lon, lat)
  str(locationRecord)
  
}, silent = FALSE)

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