mcdelaney / rgeolocate Goto Github PK

Generalised IP geolocation through R

Author(s: Oliver Keyes, Drew Schmidt
License: Apache 2.0 Status: Stable

IP geolocation is a powerful tool to have if you're dealing with web data, and there are a couple of R packages that provide access to specific services, such as the legacy rgeoip package or Bob Rudis's ipapi. They're all spread about and have diffing interfaces, styles and requirements.

rgeolocate aims to be a single generalised package for geolocation; if you have a source you'd like to pull from, the goal is that rgeolocate will provide a binding to it. As of the 0.4.0 release, it contains:

1. A binding to the binary MaxMind databases;
2. Wrappers around multiple online geolocation services (see the vignette for more)

If you have other bindings you'd like to see, open a request!

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Installation

For the latest CRAN release:

install.packages("rgeolocate")

For the development version:

devtools::install_github("ironholds/rgeolocate")

Dependencies

rgeolocate depends on httr for the bindings to web databases; other than that, just base R! Thanks to the work of Drew Schmidt, rgeolocate includes the underlying MaxMind library and its dependencies.