{"id":13857553,"url":"https://github.com/mhudecheck/revgeo","last_synced_at":"2025-12-30T02:20:22.355Z","repository":{"id":20480419,"uuid":"90036604","full_name":"mhudecheck/revgeo","owner":"mhudecheck","description":"Reverse Geocoding in R with Google Maps API and Photon API","archived":false,"fork":false,"pushed_at":"2024-04-16T16:52:37.000Z","size":50,"stargazers_count":21,"open_issues_count":2,"forks_count":7,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-06T03:04:07.582Z","etag":null,"topics":["bing-api","geocode","photon","photon-api"],"latest_commit_sha":null,"homepage":null,"language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mhudecheck.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-05-02T13:28:11.000Z","updated_at":"2024-06-18T19:12:05.000Z","dependencies_parsed_at":"2022-07-26T09:17:50.711Z","dependency_job_id":null,"html_url":"https://github.com/mhudecheck/revgeo","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhudecheck%2Frevgeo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhudecheck%2Frevgeo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhudecheck%2Frevgeo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhudecheck%2Frevgeo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mhudecheck","download_url":"https://codeload.github.com/mhudecheck/revgeo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225920379,"owners_count":17545479,"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":["bing-api","geocode","photon","photon-api"],"created_at":"2024-08-05T03:01:40.402Z","updated_at":"2025-12-30T02:20:22.315Z","avatar_url":"https://github.com/mhudecheck.png","language":"R","funding_links":[],"categories":["R"],"sub_categories":[],"readme":"# Reverse Geocoding in R with Google Maps, Photon, and Bing\n\nNOTE: For now, please use the Github version if you plan to use Photon.\n\nThis code lets you reverse geocode coordinate pairs with Google Maps, Photon, and Bing.  As far as I'm aware, it's the first package in R which specifically allows you to the Photon geocoder for OpenStreetMaps or Bing to reverse geocode (as opposed to geocode).  This is pretty important, since the Google Maps API is limited to 2,500 free queries a day.\n\nYou can install revgeo() through CRAN:\n```\ninstall.packages('revgeo')\n```\nYou also install revgeo() with the devtools package:\n```\nlibrary(devtools)\ninstall_github('mhudecheck/revgeo')\n```\nThe syntax for revgeo() is pretty simple:\n```\nlibrary('revgeo')\n\n# Usage: revgeo(longitude, latitude, provider=NULL, API=NULL, output=NULL, item=NULL)\n# Example: revgeo(longitude=-86.46222, latitude=33.94954, provider=NULL, API=NULL, output='hash', item='zip')\n```\nYou'll need to create a Google Maps API, set provider='google' (or google=TRUE for v.11), and include your API key with API='your API key' if you want to use revgeo() with Google Maps:\n```\nlibrary('revgeo')\n\n# Example: revgeo(longitude=-86.46222, latitude=33.94954, provider='google', API='your API key')\n```\nThe same is true for Bing if you're using v.12 (available from GitHub):\n```\nlibrary('revgeo')\n\n# Example: revgeo(longitude=-86.46222, latitude=33.94954, provider='bing', API='your API key')\n```\nThere are a couple of neat things you can do with revgeo().  The default return is an address string:\n```\nlibrary('revgeo')\n\n# Example: revgeo(-77.016472, 38.785026)\n# Returns: \"146 National Plaza, Fort Washington, Maryland, 20745, United States of America\"\n```\nYou can use output='hash' to return a hashed string and output='frame' to return a dataframe with seperate columns for house numbers, streets, cities, counties, states, countries, and postal codes. \n```\nlibrary('revgeo')\n\n# Example: result \u003c- revgeo(-77.016472, 38.785026, output=\"frame\")\n# Returns: data frame (result) with names(result) equal to 'housenumber', 'street', 'city', 'county', 'state', and 'country'.\n```\nYou can also use output='hash' or output='frame' with item='housenumber', 'street', 'city', 'county', 'state', and 'country' to return any one of those values. \n```\nlibrary('revgeo')\n\n# Example: revgeo(-77.016472, 38.785026, output='hash', item='zip')\n# Returns: \"20745\"\n```\nThe Revgeo package is still very much a work in progress, so please send any comments or issues to the 'issues' section above. \n\nYou can find documentation on the Google Maps API at: https://developers.google.com/maps/documentation/geocoding/start.\n\nYou can find documentation on the Photon API at: http://photon.komoot.de/.\n\nYou can find documentation on the Bing API at: https://www.bingmapsportal.com/.\n\nThis package started as an extension to RPhoton/geocode to enable reverse geocoding with Photon, but it's since turned into a complete rewrite, with the added benefit of being able to use the Google Maps API and the Bing API without having to load multiple libraries.  If you'd like to geocode an address with Photon (and not reverse geocode latitude/longitude coordinates), you can easily use their library at https://github.com/rCarto/photon/blob/master/R/geocode.R. \n\nI'll try to get around to including standard geocoding in this package, but it isn't a promise.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhudecheck%2Frevgeo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmhudecheck%2Frevgeo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhudecheck%2Frevgeo/lists"}