Hoofdnavigatie

Naar content

Documentatie actuele vertrektijden

De webservice voor de actuele vertrektijden maakt het mogelijk om voor een station een actueel overzicht op te vragen van alle vertrekkende treinen voor het komende uur.


Request

Actuele vertrekinformatie kan worden opgehaald met behulp van de volgende url:

https://webservices.ns.nl/ns-api-avt?station=${Naam of afkorting Station}

Parameter Omschrijving Verplicht
station De code (afkorting) of korte naam of middellange naam of volledige naam of synoniem van de stationsnaam Ja

Er zullen minimaal 10 vertrektijden worden geretourneerd en minimaal de vertrektijden voor het komende uur. Een voorbeeld request voor de actuele vertrektijden van station Utrecht Centraal:

https://webservices.ns.nl/ns-api-avt?station=ut

Omdat vanaf Utrecht Centraal meer dan 10 treinen per uur vertrekken, bevat de response alle vertrekinformatie voor het komende uur.

Een voorbeeld request voor de actuele vertrektijden van station Kampen:

https://webservices.ns.nl/ns-api-avt?station=Kampen

Omdat vanaf Kampen 2 treinen per uur vertrekken, worden er 10 vertrektijden geretourneerd.

Response

De response bestaat uit het element ActueleVertrekTijden dat per vertrekkende trein een element VertrekkendeTrein bevat.

Een VertrekkendeTrein kan de volgende elementen hebben:

  • RitNummer (1): Identificerend nummer van de trein
  • VertrekTijd (1): Vertrektijd van de trein in minuten
  • VertrekVertraging (0..1): Vertraging in minuten
  • VertrekVertragingTekst (0..1): Vertraging presentatietekst
  • EindBestemming (1): Geplande eindbestemming van de trein
  • TreinSoort (1): Treinsoort (Intercity, Sprinter etc.)
  • RouteTekst (0..1): Verkorte weergave van de route die de trein rijdt. Er worden maximaal 4 stopstations opgenomen, waardoor het meestal een samenvatting is van de volledige route.
  • Vervoerder (1): Vervoerder van de trein.
  • VertrekSpoor (1): Vertrekspoor van de trein. Het attribuut "wijziging" geeft aan of er wel of niet sprake is van een spoorwijziging.
  • ReisTip (0..1): Tekstregel die een tip geeft over de reis. Hiermee wordt de aandacht gevestigd op mogelijk onverwachte kenmerken. Bv. een Intercity die stopt op alle tussengelegen stations.
  • Opmerkingen (0..1). Tekstuele opmerkingen bij de vertrekkende trein. Bestaat uit 0 of meer Opmerking-elementen, die de afzonderlijke tekstregels bevatten. Bevat vrijwel altijd actuele ritwijzigingen, zoals "Rijdt vandaag niet".