{"id":24182075,"url":"https://github.com/munterfi/herer","last_synced_at":"2025-04-04T10:08:39.526Z","repository":{"id":41346137,"uuid":"211724447","full_name":"munterfi/hereR","owner":"munterfi","description":"R package that provides an interface to the HERE REST APIs: Geocoder API, Routing API, Traffic API, Public Transit API and Destination Weather API. Locations and routes are returned as 'sf' objects.","archived":false,"fork":false,"pushed_at":"2024-11-28T15:09:29.000Z","size":40330,"stargazers_count":90,"open_issues_count":2,"forks_count":11,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-23T09:25:50.918Z","etag":null,"topics":["api","geocoding","gis","here-technologies","isoline","routing","rspatial","rstats","traffic","weather"],"latest_commit_sha":null,"homepage":"https://munterfi.github.io/hereR/","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/munterfi.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-29T20:49:38.000Z","updated_at":"2024-11-27T22:04:40.000Z","dependencies_parsed_at":"2024-10-24T08:03:26.178Z","dependency_job_id":"c105784c-54e9-474a-b64d-fcf4bfc971cf","html_url":"https://github.com/munterfi/hereR","commit_stats":{"total_commits":520,"total_committers":9,"mean_commits":57.77777777777778,"dds":"0.44807692307692304","last_synced_commit":"ceada1cbfbbcc672d4ecec58e9240abc33c61793"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/munterfi%2FhereR","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/munterfi%2FhereR/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/munterfi%2FhereR/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/munterfi%2FhereR/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/munterfi","download_url":"https://codeload.github.com/munterfi/hereR/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247157283,"owners_count":20893220,"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":["api","geocoding","gis","here-technologies","isoline","routing","rspatial","rstats","traffic","weather"],"created_at":"2025-01-13T07:27:18.941Z","updated_at":"2025-04-04T10:08:39.484Z","avatar_url":"https://github.com/munterfi.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hereR \u003cimg src=\"man/figures/logo.svg\" align=\"right\" alt=\"\" width=\"120\" /\u003e\n\n\u003c!-- badges: start --\u003e\n\n[![CRAN status](https://www.r-pkg.org/badges/version/hereR)](https://CRAN.R-project.org/package=hereR)\n[![CRAN checks](https://badges.cranchecks.info/worst/hereR.svg)](https://cran.r-project.org/web/checks/check_results_hereR.html)\n[![CRAN downloads](https://cranlogs.r-pkg.org/badges/last-month/hereR?color=brightgreen)](https://CRAN.R-project.org/package=hereR)\n[![R-CMD-check](https://github.com/munterfi/hereR/actions/workflows/check-standard.yaml/badge.svg)](https://github.com/munterfi/hereR/actions/workflows/check-standard.yaml)\n[![Codecov test coverage](https://codecov.io/gh/munterfi/hereR/branch/master/graph/badge.svg)](https://app.codecov.io/gh/munterfi/hereR?branch=master)\n[![CodeFactor](https://www.codefactor.io/repository/github/munterfi/hereR/badge)](https://www.codefactor.io/repository/github/munterfi/hereR)\n\n\u003c!-- badges: end --\u003e\n\nThe **hereR** package provides an interface to the **HERE REST APIs** for R:\n(1) geocode and autosuggest addresses or reverse geocode POIs using the **Geocoder API**;\n(2) route directions, travel distance or time matrices and isolines using the **Routing API**, **Matrix Routing API** and **Isoline Routing API**;\n(3) request real-time traffic flow and incident information from the **Traffic API**;\n(4) find public transport connections and nearby stations using the **Public Transit API**;\n(5) request intermodal routes using the **Intermodal Routing API**;\n(6) get weather forecasts, reports on current weather conditions and astronomical information at a specific location from the **Destination Weather API**.\n\nLocations, routes and isolines are returned as `sf` objects.\n\n## Installation\n\nYou can install the released version of **hereR** from [CRAN](https://CRAN.R-project.org/package=hereR/) with:\n\n```r\ninstall.packages(\"hereR\")\n```\n\nInstall the development version from [GitHub](https://github.com/munterfi/hereR/) with:\n\n```r\nremotes::install_github(\"munterfi/hereR\")\n```\n\n## Usage\n\nThis package requires an API key for a HERE project. The key is set for the current R session and is used to authenticate in the requests to the APIs. A login can be created on [developer.here.com](https://developer.here.com/). In order to obtain the API key navigate to a project of your choice in the developer portal, select '**REST: Generate APP**' and then '**Create API Key**'.\n\nTo set the API key, use:\n\n```r\nlibrary(hereR)\nset_key(\"\u003cYOUR API KEY\u003e\")\n```\n\n**Note:** Your use of the HERE APIs with this package is subject to the [HERE Developer Terms and Conditions](https://developer.here.com/terms-and-conditions). For freemium licenses the number of requests per second (RPS) is limited, use `set_freemium(FALSE)` to turn off limits for accounts with paid plans.\n\nOnce valid application credentials are created and the key is set in the R session, the APIs can be addressed using the functions shown in the examples below. A more detailed description can be found in the documentation of the functions and the package vignettes.\n\n**Geocoding \u0026 Search API:** Autosuggest and geocode addresses or reverse geocode POIs.\n\n```r\ngeocode(c(\"Schweighofstrasse 190, Zurich, Switzerland\", \"Hardstrasse 48, Zurich, Switzerland\"))\n\nautosuggest(c(\"Schweighofstrasse\", \"Hardstrasse\"))\n\nreverse_geocode(poi)\n```\n\n**Routing API:** Construct route geometries with elevation (dim = `XYZ`).\n\n```r\nroute(poi[1:2, ], poi[3:4, ], transport_mode = \"car\", traffic = TRUE)\n\nroute(poi[1:2, ], poi[3:4, ], transport_mode = \"car\", traffic = FALSE)\n\nroute(poi[4, ], poi[5, ], transport_mode = \"bicycle\")\n```\n\n**Matrix Routing API:** Request a matrix of route summaries.\n\n```r\nroute_matrix(poi, transport_mode = \"car\", traffic = TRUE)\n\nroute_matrix(\n  geocode(c(\"Schweighofstrasse 190, Zurich, Switzerland\", \"Hardstrasse 48, Zurich, Switzerland\")),\n  transport_mode = \"bicycle\", traffic = FALSE\n)\n```\n\n**Isoline Routing API:** Construct isolines around points (time, distance or consumption).\n\n```r\nisoline(poi, range_type = \"time\", transport_mode = \"pedestrian\")\n\nisoline(poi, range_type = \"distance\", transport_mode = \"truck\")\n\nisoline(poi, range_type = \"consumption\", transport_mode = \"car\", traffic = FALSE)\n```\n\n**Traffic API:** Get real-time traffic flow or incidents in a specific area.\n\n```r\nflow(aoi)\n\nincident(aoi)\n```\n\n**Public Transit API:** Request public transport connections between points or find stations nearby.\n\n```r\nconnection(poi[1:2, ], poi[3:4, ])\n\nstation(poi, radius = 500)\n```\n\n**Intermodal Routing API:** Get routes with various combinations of transport modes.\n\n```r\nintermodal_route(poi[1:2, ], poi[3:4, ])\n```\n\n**Destination Weather API:** Request weather observations, forecasts, astronomical information or alerts at specific locations.\n\n```r\nweather(poi, product = \"observation\")\n\nweather(poi, product = \"forecast_hourly\")\n\nweather(poi, product = \"forecast_astronomy\")\n\nweather(poi, product = \"alerts\")\n```\n\n## Contributing\n\n- Contributions to this package are very welcome, issues and pull requests are the preferred ways to share them. Please see the [Contribution Guidelines](https://github.com/munterfi/hereR/blob/master/.github/CONTRIBUTING.md).\n- This project is released with a [Contributor Code of Conduct](https://github.com/munterfi/hereR/blob/master/.github/CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.\n\n## References\n\n- [Developer Terms and Conditions](https://developer.here.com/terms-and-conditions)\n- [Geocoding \u0026 Search API](https://www.here.com/docs/bundle/geocoding-and-search-api-v7-api-reference/page/index.html)\n- [Routing API](https://www.here.com/docs/bundle/routing-api-developer-guide-v8/page/README.html)\n- [Matrix Routing API](https://www.here.com/docs/bundle/matrix-routing-api-developer-guide/page/README.html)\n- [Isoline Routing API](https://www.here.com/docs/bundle/isoline-routing-api-developer-guide-v8/page/README.html)\n- [Traffic API](https://www.here.com/docs/bundle/traffic-api-v7-api-reference/page/index.html)\n- [Public Transit API](https://www.here.com/docs/bundle/public-transit-api-developer-guide/page/README.html)\n- [Intermodal Routing API](https://www.here.com/docs/bundle/intermodal-routing-api-developer-guide/page/README.html)\n- [Destination Weather API](https://www.here.com/docs/bundle/destination-weather-api-v3-api-reference/page/index.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmunterfi%2Fherer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmunterfi%2Fherer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmunterfi%2Fherer/lists"}