/nsapi

Connect to the NS (Dutch Railways) api

Primary LanguageROtherNOASSERTION

nsapi

CRAN_latest_release_date license Project Status: Unsupported – The project has reached a stable, usable state but the author(s) have ceased all work on it. A new maintainer may be desired. thanks-md lifecycle Travis-CI Build Status codecov

PLEASE BE AWARE THIS PACKAGE IS NO LONGER MAINTAINED. NS HAS CHANGED THEIR API (PROBABLY FOR THE BEST) AND THIS PACKAGE DOES NOT WORK WITH THAT. YOU ARE ABSOLUTELY WELCOME TO FORK THIS PROJECT AND MAKE IT WORK.

The Dutch National Railway service (NS; Nederlandse Spoorwegen) has an API where we can query for travel advise, see the current trains on a given station, see if there is any delays or work on the tracks and NS also provides a list with geolocation of all the stations.

The goal of nsapi is to make it easy to gather data from the NS API. The package returns data frames for every response.

an incredibly ugly logo for this package, we need a hexsticker!

Installation

You can NOT YET install the released version of nsapi from CRAN with:

install.packages("nsapi")

But you can install the development version from GitHub with:

# install.packages("devtools")
devtools::install_github("RMHogervorst/nsapi")

Example

This is a basic example which shows you how you get travel information:

library(nsapi)
treinplanner <- get_travel_advise(
  fromStation = "Leiden Centraal", 
  toStation = "Utrecht Centraal",
  departure = TRUE,
  yearCard = TRUE,
  previousAdvises = 1, 
  nextAdvises = 1)
treinplanner

FAQ

  1. What Can I do with the package?
  • You can access the departures from a station, disruptions (planned and unplanned), get travel advise (between stations) and a list of all stations (in the Netherlands and some outside.). In the vignette I’ve described how to use the functions.
  1. I’m getting a curl timeout!
  • Yes… That happens, sometimes. The NS website does not always return errors but just times you out once in a while. Take a deep breath, retry.
  1. Error Bad request or HTTP 400
  • Your username and password might not be set properly
  1. How do I set a password and username?
  • See Authentication in the vignette

Metadata

The package is MIT licensed although the information from NS is probably proprietary

codecoverage <- covr::package_coverage(path = ".",type = "tests")
print(codecoverage)