Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

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

Host: GitHub
URL: https://github.com/munterfi/hereR
Owner: munterfi
License: gpl-3.0
Created: 2019-09-29T20:49:38.000Z (about 5 years ago)
Default Branch: master
Last Pushed: 2024-03-14T23:02:06.000Z (8 months ago)
Last Synced: 2024-07-11T19:59:11.554Z (4 months ago)
Topics: api, geocoding, gis, here-technologies, isoline, routing, rspatial, rstats, traffic, weather
Language: R
Homepage: https://munterfi.github.io/hereR/
Size: 38.5 MB
Stars: 82
Watchers: 3
Forks: 11
Open Issues: 1
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: .github/CODE_OF_CONDUCT.md

Awesome Lists containing this project

jimsghstars - 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. (R)

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)