Skip to content

ahasverus/rgeoservices

Repository files navigation

rgeoservices

Package License: GPL (>= 2) Lifecycle Maturing CRAN status
R CMD Check Website Test coverage codecov

Overview
Features
Installation
Get started
Citation
Contributing
Acknowledgments

Overview

The R package rgeoservices is a R client streamlining access to the services provided by the French National Institute of Geographic and Forest Information (IGN) through its open access Geoplatform. This Geoplatform can be used to query the IGN BD TOPO® database to retrieve geographical information (only for France)

Features

Currently rgeoservices can access to the following services:

  • Geocoding service 🌐

Service used to obtain the geographic coordinates of an address or a point of interest. The reverse operation is also possible. See the gs_get_geocode() and gs_get_coordinates() functions.

  • Altimetry service 🌐

Service used to obtain the altitude of a geographical point and a longitudinal profile. See the gs_get_elevation() function.

  • Route planner service 🌐

Service used to obtain a route between two points. See the gs_get_itinerary() function.

  • Isochrone/Isodistance service 🌐

Service used to get to the accessible area within a certain travel time/distance. See the gs_get_isochrone() and gs_get_isodistance() functions.

Installation

You can install the development version from GitHub with:

## Install 'remotes' package (if not already installed) ----
if (!requireNamespace("remotes", quietly = TRUE)) {
  install.packages("remotes")
}

## Install 'rgeoservices' from GitHub ----
remotes::install_github("ahasverus/rgeoservices")

Then you can attach the package rgeoservices:

library("rgeoservices")

Get started

For an overview of the main features of rgeoservices, please read the Reference page.

N.B. A vignette will be available soon.

Citation

Please cite rgeoservices as:

Casajus Nicolas (2025) rgeoservices: A R client for the IGN Geoservices API. R package version 0.0.0.9000. https://github.com/ahasverus/rgeoservices/

Contributing

All types of contributions are encouraged and valued. For more information, check out our Contributor Guidelines.

Please note that the rgeoservices project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

Acknowledgments

I’d like to thank the IGN for making their invaluable data freely available.

About

📦 A R client for the IGN Geoservices API

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Languages