location_getSingleAddress_Photon: Get address data from the Photon API to OpenStreetMap

View source: R/location_getSingleAddress_Photon.R

location_getSingleAddress_PhotonR Documentation

Get address data from the Photon API to OpenStreetMap

Description

The Photon API is used get address data associated with the longitude and latitude. The following list of data is returned:

  • houseNumber

  • street

  • city

  • stateCode

  • stateName

  • postalCode

  • countryCode

  • countryName

The function makes an effort to convert both state and country Name into Code with codes defaulting to NA. Both Name and Code are returned so that improvements can be made in the conversion algorithm.

Usage

location_getSingleAddress_Photon(
  longitude = NULL,
  latitude = NULL,
  baseUrl = "https://photon.komoot.io/reverse",
  verbose = TRUE
)

Arguments

longitude

Single longitude in decimal degrees E.

latitude

Single latitude in decimal degrees N.

baseUrl

Base URL for data queries.

verbose

Logical controlling the generation of progress messages.

Value

List of address components.

References

https://photon.komoot.io

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

  addressList <- location_getSingleAddress_Photon(lon, lat)
  str(addressList)
  
}, silent = FALSE)



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