Generalised IP geolocation through R
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
R
inst/extdata
man
src
tests
vignettes
.Rbuildignore
.gitignore
.travis.yml
CONDUCT.md
DESCRIPTION
LICENSE
NAMESPACE
NEWS
README.md
cleanup
configure
configure.ac
configure.win
reconf
rgeolocate.Rproj

README.md

Generalised IP geolocation through R

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

Travis-CI Build Status CRAN_Status_Badge downloads

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.8.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 binary libraries and their dependencies.