{"id":13857853,"url":"https://github.com/ropensci/opencage","last_synced_at":"2026-02-20T16:02:06.888Z","repository":{"id":6961114,"uuid":"55807177","full_name":"ropensci/opencage","owner":"ropensci","description":":globe_with_meridians: R package for the OpenCage API -- both forward and reverse geocoding :globe_with_meridians:","archived":false,"fork":false,"pushed_at":"2025-01-25T19:56:29.000Z","size":1039,"stargazers_count":87,"open_issues_count":5,"forks_count":11,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-06-20T19:09:39.520Z","etag":null,"topics":["geocode","geocoder","opencage","opencage-api","opencage-geocoder","peer-reviewed","placenames","r","r-package","rspatial","rstats"],"latest_commit_sha":null,"homepage":"https://docs.ropensci.org/opencage","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ropensci.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":".github/contributing.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-04-08T20:16:45.000Z","updated_at":"2025-04-09T11:04:55.000Z","dependencies_parsed_at":"2025-01-13T13:34:58.825Z","dependency_job_id":"7272436f-f053-4ce6-af40-64f7925c2e9f","html_url":"https://github.com/ropensci/opencage","commit_stats":{"total_commits":459,"total_committers":13,"mean_commits":35.30769230769231,"dds":0.3485838779956427,"last_synced_commit":"9b57eefa9725822d00e1e48417f5948eeeb15db1"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/ropensci/opencage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fopencage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fopencage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fopencage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fopencage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ropensci","download_url":"https://codeload.github.com/ropensci/opencage/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fopencage/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265218207,"owners_count":23729496,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["geocode","geocoder","opencage","opencage-api","opencage-geocoder","peer-reviewed","placenames","r","r-package","rspatial","rstats"],"created_at":"2024-08-05T03:01:48.799Z","updated_at":"2025-10-22T06:05:09.262Z","avatar_url":"https://github.com/ropensci.png","language":"R","funding_links":[],"categories":["R"],"sub_categories":[],"readme":"---\noutput:\n  github_document:\n    df_print: kable\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n# opencage\n\n\u003c!-- badges: start --\u003e\n\n[![CRAN Version](https://www.r-pkg.org/badges/version/opencage)](https://cran.r-project.org/package=opencage)\n[![CRAN Checks Status](https://badges.cranchecks.info/worst/opencage.svg)](https://cran.r-project.org/web/checks/check_results_opencage.html)\n[![CRAN Downloads per Month](https://cranlogs.r-pkg.org/badges/opencage)](https://cran.r-project.org/package=opencage)\n[![R-universe status](https://ropensci.r-universe.dev/badges/opencage)](https://ropensci.r-universe.dev/ui#package:opencage)\n[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n[![R-CMD-check Status on GitHub Actions](https://github.com/ropensci/opencage/workflows/R-CMD-check/badge.svg)](https://github.com/ropensci/opencage/actions?query=workflow%3AR-CMD-check)\n[![codecov.io Status](https://codecov.io/github/ropensci/opencage/coverage.svg?branch=main)](https://codecov.io/github/ropensci/opencage?branch=main)\n[![rOpenSci Peer-Review](https://badges.ropensci.org/36_status.svg)](https://github.com/ropensci/software-review/issues/36)\n[![License](https://img.shields.io/cran/l/opencage)](https://opensource.org/licenses/gpl-license)\n\n\u003c!-- badges: end --\u003e\n\nGeocode with the [OpenCage](https://opencagedata.com) API, either from place name to longitude and latitude (forward geocoding) or from longitude and latitude to the name and address of the location (reverse geocoding).\n\n## Installation\n\nYou can install {opencage} from [CRAN](https://cran.r-project.org/package=opencage), [R-universe](https://ropensci.r-universe.dev/ui#package:opencage) or [GitHub](https://github.com/ropensci/opencage) like this:\n\n- Release version from CRAN\n\n  ```r\n  install.packages(\"opencage\")\n  ```\n\n- Development version from R-universe\n  \n  ```r\n  install.packages(\n    \"opencage\", \n    repos = c(\"https://ropensci.r-universe.dev\", getOption(\"repos\"))\n  )\n  ```\n\n- Development version from GitHub with {[pak](https://github.com/r-lib/pak/)}\n  \n  ```r\n  pak::pak(\"ropensci/opencage\")\n  ```\n  \n  or with {[remotes](https://github.com/r-lib/remotes/)}\n  \n  ```r\n  remotes::install_github(\"ropensci/opencage\")\n  ```\n\n## Quickstart\n\nFor the best experience, we recommend that you read through the \"[Introduction to opencage](https://docs.ropensci.org/opencage/articles/opencage.html)\" vignette (`vignette(\"opencage\")`), but if you are in a hurry:\n\n1.  Register at [opencagedata.com/users/sign_up](https://opencagedata.com/users/sign_up).\n2.  Generate an API key at the [OpenCage dashboard](https://opencagedata.com/dashboard#api-keys).\n3.  Save your API key as an [environment variable](https://rstats.wtf/r-startup.html#renviron) like `OPENCAGE_KEY=yourkey` in `.Renviron`. \n    See `help(oc_config)` for alternative ways to set your OpenCage API key.\n\nNow you are ready to turn place names into latitude and longitude coordinates:\n\n```{r forward}\nlibrary(opencage)\noc_forward_df(placename = \"Sarzeau\")\n```\n\nOr turn a set of coordinates into the name and address of the location:\n\n```{r reverse}\noc_reverse_df(latitude = 51.5034070, longitude = -0.1275920)\n```\n\nBut remember, the vignettes are really great! We have:\n\n- \"[Introduction to opencage](https://docs.ropensci.org/opencage/articles/opencage.html)\" `vignette(\"opencage\")`\n- \"[Customise your query](https://docs.ropensci.org/opencage/articles/customise_query.html)\" `vignette(\"customise_query\")`\n- \"[Output options](https://docs.ropensci.org/opencage/articles/output_options.html)\" `vignette(\"output_options\")`\n\n## About OpenCage\n\nThe [OpenCage](https://opencagedata.com) API supports forward and reverse geocoding. \nSources of OpenCage are open geospatial data including\n[OpenStreetMap](https://www.openstreetmap.org),\n[DataScienceToolkit](https://github.com/petewarden/dstk),\n[GeoPlanet](https://en.wikipedia.org/wiki/GeoPlanet), \n[Natural Earth Data](https://www.naturalearthdata.com),\n[libpostal](https://github.com/openvenues/libpostal),\n[GeoNames](https://www.geonames.org), and \n[Flickr's shapefiles](https://code.flickr.net/2009/05/21/flickr-shapefiles-public-dataset-10/)\nplus a whole lot more besides. \nRefer to the current full [list of credits](https://opencagedata.com/credits).\n\n## Code of Conduct\n\nPlease note that this package is released with a [Contributor Code of Conduct](https://ropensci.org/code-of-conduct/). \nBy contributing to this project, you agree to abide by its terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Fopencage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fropensci%2Fopencage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Fopencage/lists"}