Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/munterfi/hereR

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.
https://github.com/munterfi/hereR

api geocoding gis here-technologies isoline routing rspatial rstats traffic weather

Last synced: about 2 months ago
JSON representation

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.

Lists

README 

        
# hereR 



[![CRAN status](https://www.r-pkg.org/badges/version/hereR)](https://CRAN.R-project.org/package=hereR)

[![CRAN checks](https://badges.cranchecks.info/worst/hereR.svg)](https://cran.r-project.org/web/checks/check_results_hereR.html)

[![CRAN downloads](https://cranlogs.r-pkg.org/badges/last-month/hereR?color=brightgreen)](https://CRAN.R-project.org/package=hereR)

[![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)

[![Codecov test coverage](https://codecov.io/gh/munterfi/hereR/branch/master/graph/badge.svg)](https://app.codecov.io/gh/munterfi/hereR?branch=master)

[![CodeFactor](https://www.codefactor.io/repository/github/munterfi/hereR/badge)](https://www.codefactor.io/repository/github/munterfi/hereR)



The **hereR** package provides an interface to the **HERE REST APIs** for R:

(1) geocode and autosuggest addresses or reverse geocode POIs using the **Geocoder API**;

(2) route directions, travel distance or time matrices and isolines using the **Routing API**, **Matrix Routing API** and **Isoline Routing API**;

(3) request real-time traffic flow and incident information from the **Traffic API**;

(4) find public transport connections and nearby stations using the **Public Transit API**;

(5) request intermodal routes using the **Intermodal Routing API**;

(6) get weather forecasts, reports on current weather conditions and astronomical information at a specific location from the **Destination Weather API**.



Locations, routes and isolines are returned as `sf` objects.



## Installation



You can install the released version of **hereR** from [CRAN](https://CRAN.R-project.org/package=hereR/) with:



```r

install.packages("hereR")

```



Install the development version from [GitHub](https://github.com/munterfi/hereR/) with:



```r

remotes::install_github("munterfi/hereR")

```



## Usage



This 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**'.



To set the API key, use:



```r

library(hereR)

set_key("")

```



**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.



Once 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.



**Geocoding & Search API:** Autosuggest and geocode addresses or reverse geocode POIs.



```r

geocode(c("Schweighofstrasse 190, Zurich, Switzerland", "Hardstrasse 48, Zurich, Switzerland"))



autosuggest(c("Schweighofstrasse", "Hardstrasse"))



reverse_geocode(poi)

```



**Routing API:** Construct route geometries with elevation (dim = `XYZ`).



```r

route(poi[1:2, ], poi[3:4, ], transport_mode = "car", traffic = TRUE)



route(poi[1:2, ], poi[3:4, ], transport_mode = "car", traffic = FALSE)



route(poi[4, ], poi[5, ], transport_mode = "bicycle")

```



**Matrix Routing API:** Request a matrix of route summaries.



```r

route_matrix(poi, transport_mode = "car", traffic = TRUE)



route_matrix(

  geocode(c("Schweighofstrasse 190, Zurich, Switzerland", "Hardstrasse 48, Zurich, Switzerland")),

  transport_mode = "bicycle", traffic = FALSE

)

```



**Isoline Routing API:** Construct isolines around points (time, distance or consumption).



```r

isoline(poi, range_type = "time", transport_mode = "pedestrian")



isoline(poi, range_type = "distance", transport_mode = "truck")



isoline(poi, range_type = "consumption", transport_mode = "car", traffic = FALSE)

```



**Traffic API:** Get real-time traffic flow or incidents in a specific area.



```r

flow(aoi)



incident(aoi)

```



**Public Transit API:** Request public transport connections between points or find stations nearby.



```r

connection(poi[1:2, ], poi[3:4, ])



station(poi, radius = 500)

```



**Intermodal Routing API:** Get routes with various combinations of transport modes.



```r

intermodal_route(poi[1:2, ], poi[3:4, ])

```



**Destination Weather API:** Request weather observations, forecasts, astronomical information or alerts at specific locations.



```r

weather(poi, product = "observation")



weather(poi, product = "forecast_hourly")



weather(poi, product = "forecast_astronomy")



weather(poi, product = "alerts")

```



## Contributing



- 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).

- 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.



## References



- [Developer Terms and Conditions](https://developer.here.com/terms-and-conditions)

- [Geocoding & Search API](https://developer.here.com/documentation/geocoding-search-api/dev_guide/index.html)

- [Routing API](https://developer.here.com/documentation/routing-api/dev_guide/index.html)

- [Matrix Routing API](https://developer.here.com/documentation/matrix-routing-api/dev_guide/index.html)

- [Isoline Routing API](https://developer.here.com/documentation/isoline-routing-api/dev_guide/index.html)

- [Traffic API](https://developer.here.com/documentation/traffic-api/api-reference.html)

- [Public Transit API](https://developer.here.com/documentation/public-transit/dev_guide/index.html)

- [Intermodal Routing API](https://developer.here.com/documentation/intermodal-routing/dev_guide/index.html)

- [Destination Weather API](https://developer.here.com/documentation/destination-weather/dev_guide/topics/guide.html)