bingmapr is a wrapper for the Bing Maps API written in R.
This build includes wrapper functions for several of the Locations API functions, including geocoding, reverse geocoding, and location recognition, as well as a function for batch geocoding from a CSV.
geocode()find the coordinate pair of a given addressreverse_geocode()find the address nearest to a coordinate pairlocation_recognition()finds a list of entities within a given radiusgeocode_csv()add coordinate pairs to a list of addresses in a CSV file
Install RStudio or another R-compatible IDE to install bingmapr - built for R V4.0
devtools::install_github("https://github.com/ericphillips99/bingmapr")If you wish to use the built-in vignette, please install with devtools::install_github(build_vignettes = TRUE) and then run browseVignettes(package='bingmapr') to view.
NOTE: If you wish to include Vignette in your installation, please set your API Key before installation.
In order to make use of any of the functions contained within this package, you must first obtain a Bing Maps API key here. Once you have your key, you must set it as an environment variable with name api_key:
Sys.setenv(api_key=API_KEY_GOES_HERE)
libarary(bingmapr)
# Geocoding
geocode_test <- geocode(addressLine='2135 Bennett Road', locality='Kelowna', adminDistrict='BC')
geocode_test$chords
# $latitude
# [1] 49.95974
#
# $longitude
# [1] -119.4602
# Reverse Geocoding
rev_geocode_result <- reverse_geocode(lat=49.8682,long=-119.4889)
rev_geocode_result$address
# "674 Patterson Ave, Kelowna, BC V1Y 5C7, Canada"
# Location Recognition
loc_recog_result <- location_recognition(lat=49.8682,long=-119.4889)
loc_recog_result$business[[1]]
# $businessAddress$addressLine
# [1] "665B Patterson Ave"
# ...
# $businessInfo
# $businessInfo$entityName
# [1] "Perception Marketing"
# ...
# $businessInfo$type
# [1] "Business-to-Business"
geocode_csv("sf_starbucks_sample.csv",addressLine_col="street_addres", locality_col="city")
# Returns CSV saved to working directory with columns added for the latitude and longitude of each address in the original CSV.Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.