Skip to contents

opencage (development version)

  • opencage now supports an address_only parameter, see “New optional API parameter ‘address_only’”, (#151).
  • The geocoding functions will not send a query to the API anymore if no API key is present (#133).
  • NAs are allowed again for the placename or latitude/longitude arguments (also empty strings for placename). These queries are not sent to the API. An empty/NA response will be returned depending on the specific query (#143).
  • opencage_forward(), opencage_reverse(), and opencage_key() are now deprecated (leveling up from soft-deprecated, #147).


opencage 0.2.2

CRAN release: 2021-02-20

  • Fixed a test that caused an error on CRAN’s Solaris (#131).

opencage 0.2.1

CRAN release: 2021-02-14

This is a major rewrite of the {opencage} package. opencage_forward() and opencage_reverse() have been deprecated and are superseded by oc_forward() and oc_reverse(), respectively. In addition there are two new functions oc_forward_df() and oc_reverse_df(), which geocode place names or addresses into geographic coordinates (latitude and longitude) or vice versa, and return a data frame.

The new features include:

  • oc_forward() and oc_reverse() return either lists of data frames, JSON strings, GeoJSON strings, or URLs to be sent to the API (the latter for debugging purposes).
  • oc_forward_df() and oc_reverse_df() take a data frame or vectors as input and return a data frame with the geocoding results, optionally with the source data frame bound to the results data frame.
  • Almost all arguments of the geocoding functions are vectorised (the exceptions being output), so it is possible to serially (reverse) geocode lists of locations or coordinates. The geocoding functions show a progress indicator when more than one placename or latitude/longitude pair is provided.
  • The forward geocoding functions now support multiple countrycodes in accordance with the OpenCage API (#44). The countrycodes can now be provided in upper or lower case (#47).
  • A helper function oc_bbox() now makes it easier to create a list of bounding boxes from numeric vectors, bbox objects or data frames.
  • oc_forward() and oc_forward_df() now support OpenCage’s proximity parameter. The results of the geocoding request will be biased towards that location (#60).
  • A helper function oc_points() now makes it easier to create a list of point coordinates from numeric vectors or data frames to pass to the proximity argument for example.
  • All geocoding functions now support OpenCage’s roadinfo parameter (#65). If set to TRUE, OpenCage attempts to match the nearest road (rather than an address) and provides additional road and driving information.
  • Language tags passed to the language argument are not validated anymore, since the language tags used by OpenStreetMap and hence OpenCage do not always conform with the IETF BCP 47 standard (#90). The languagecodes, which were stored in {opencage} as external data, have therefore been omitted from the package. In addition, it is now possible to specify language = "native", so OpenCage will attempt to return the results in the “official” language of the country.
  • http requests are now handled by {crul}, not {httr} (#37).
  • API calls are now rate limited (#32). The default limit is set to 1 call per second as per the API limit of the Free Trial plan.
  • {opencage} settings like the OpenCage API key or the API rate limit can be configured with oc_config(). If you want OpenCage to have no record of the contents of your queries, you can also set the no_record parameter for the active R session with oc_config() (as opposed to providing the parameter with each function call). All oc_config() settings can be set more permanently via options() or environment variables, see help(oc_config).

Breaking changes

Minor changes

  • The column name for countrycodes is now code, not Code.
  • HTTP error messages are now returned directly from the API and are therefore always up-to-date. The previously used responses in code_message, which were stored in {opencage} as external data, have been deleted. For more information on OpenCage’s HTTP status codes see
  • Fixed two URLs, one of which was rejected on the v0.2.0 submission.

opencage 0.1.4

CRAN release: 2018-01-16

  • Bug fix: now the countrycode argument can be used for Namibia (#24, #25).

opencage 0.1.3

  • Added a add_request parameter (for appending original query to results).

opencage 0.1.2

CRAN release: 2017-05-12

opencage 0.1.0

CRAN release: 2016-05-12

  • Added a file to track changes to the package.