Open Location Code Handling in R

'Open Location Codes' <> are a Google-created standard for identifying geographic locations. 'olctools' provides utilities for validating, encoding and decoding entries that follow this standard.

An R implementation of the Google Open Location Codes standard.

Author: Oliver Keyes
License: MIT
Status: Stable

downloads Travis-CI Build Status

The Google Open Location Code standard allows you to encode the latitude and longitude of an area into a compressed string, resolving it down to a 14 square meter box. olctools provides a fast, vectorised R implementation of this standard that you can use to encode, decode, shorten, expand or validate OLCs.

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.


olctools depends on Rcpp but is otherwise dependency-free! It can be grabbed from CRAN with:


Alternately, the development version can be obtained through:



olctools 0.3.0

  • NA support incorporated.
  • Bug in reference implementation with recovering shortened OLCs fixed over there, and subsequently fixed over here!

olctools 0.2.1

  • first CRAN release.
  • Bugfixes to allow for a Solaris release.

olctools 0.2.0

  • shorten_olc added, allowing for full Open Location Codes to be converted to short ones.
  • recover_olc added, allowing for shortened codes to be converted to full ones.
  • dependency on Boost::Regex deprecated, meaning this /should/ work on Windows.
  • vignette added.

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.3.0 by Oliver Keyes, 5 years ago

Report a bug at

Browse source code at

Authors: Oliver Keyes

Documentation:   PDF Manual  

MIT + file LICENSE license

Imports Rcpp

Suggests testthat, knitr

Linking to Rcpp

See at CRAN