Dienstregelingsgegevens van een vervoerder

Van iedere openbaar vervoerder kan opgevraagd worden welke lijnen er gereden worden op enig moment in de gepubliceerde dienstregeling. Dat is dus onafhankelijk van welke dagen waarop die lijnen gereden worden. Per lijn worden de volgende gegevens geleverd:

• DataOwnerCode - de standaard lettercode waarmee vervoerders worden afgekort of aangeduid.
• OperatorID - (optioneel) de numerieke code waarmee vervoerders worden aangeduid.
• Per lijn de volgende gegevens:
  • LijnPlanningsNummer (identificatie van de lijn in de dienstregeling)
  • Publieke lijnnummer (zoals getoond aan reizigers)
  • Mogelijke rij-richtingen
  • Mogelijke modaliteiten:
    • Transport type (bus, tram, trein, ...)
    • Productformule (Sprinter, Q-liner, Belbus, ...)

 

Dienstregelingsgegevens per lijn

In een request voor lijn-informatie wordt een lijn gespecificeerd door de combinatie van:

• DataOwnerCode van de uitvoerende vervoerder.
• LijnPlanningsNummer (systeemlijnnummer)

Per lijn worden de volgende gegevens geleverd:

• DataOwnerCode
• OperatorID
• LijnPlanningsNummer (identificatie in de planning)
• Publieke lijnnummer (zoals getoond aan reizigers)
• De beschrijving van de lijn
• Kleurcodes van de lijn bij weergave in vertrekstaten
• Mogelijke rij-richtingen
• Mogelijke modaliteiten:
  • Transport type (bus, tram, trein, ...)
  • Productformule (Sprinter, Q-liner, Belbus, ...)
• De dagen waarop er diensten voor de lijn worden uitgevoerd
• Alle mogelijke routes waarbij per route:
  • De rijrichting
  • De geografische route over de weg of het spoor
  • De reeks haltes die gepasseerd worden met per halte:
    • Identificaties van de halte
    • Naam en plaats van de halte
    • Toegankelijkheid van de halte voor minder validen
    • De geografische coordinaten van de halte (in WGS84 of RDM projectie)
• Berichten van vervoerders over geplande en ongeplande verstoringen of veranderingen

 

Dienstregelingsgegevens voor ritten

Een of meer ritten binnen een lijn kunnen worden gespecificeerd in een request door de combinatie van:

• DataOwnerCode van de uitvoerende vervoerder.
• LijnPlanningsNummer
• Rijrichting (optioneel)
• Datum van de uitvoering

In het algemeen levert dit meerdere ritten op die op de gevraagde dag voor die lijn gereden worden. Per rit worden de volgende gegevens geleverd, naast de lijngegevens die hierboven zijn beschreven:

• JourneyNumber (identificatie van de rit)
• Rijrichting
• Status (gepland, op tijd, vertraagd, e.d.)
• Start- en eindtijd van de rit
• Geplande en evt. gewijzigde bestemming
• Toegankelijkheid van het voertuig voor minder validen
• Meldingen van de vervoerder over de rit of lijn die in de dienstregeling zijn opgenomen, bijv. geplande veranderingen of contactgegevens voor aanvragen
• De route over de weg of het spoor
• De positie van het voertuig (indien beschikbaar)
• De reeks haltes waar wordt gestopt en per halte:
  • Identificaties van de halte
  • Naam en plaats van de halte
  • Toegankelijkheid van de halte voor minder validen
  • De geografische coordinaten van de halte (in WGS84 of RDM)
  • Meldingen van de vervoerder over de halte (bijv. een tijdelijke verplaatsing van de halte)
  • Geplande aankomst- en vertrektijden
  • Verwachte aankomst- en vertrektijden, indien afwijkend van gepland
  • Geplande bestemming (dit kan veranderen bij een halte)
  • Aangepaste bestemming (bijv. bij verstoringen)
  • Drukte-indicatie bij instappen. Dit is als volgt gecodeerd:
    0 - Onbekend
    1 - Leeg
    2 - Rustig
    3 - Gemiddeld
    4 - Druk
    5 - Vol
  • Gepland vertrekperron of -spoor
  • Gewijzigd vertrekperron of -spoor
  • Status (gepland, vertraagd, te vroeg, vervallen, ...)
  • In-/uitstapmogelijkheid

Een enkele rit kan ook opgevraagd worden i.p.v. alle ritten van een lijn voor een hele dag en rijrichting. Hiervoor zijn een van de twee volgende aanvullende gegevens nodig:

1. De identificatie van de rit (JourneyNmber). Dit gegeven kan uit ander APIs verkregen worden, bijv. de Vertrektijden API, waar dit bij iedere vertrektijd wordt meegeleverd
   OF
2. Een combinatie van halte-code en vertrektijd. Deze gegevens kunnen afkomstig zijn uit andere APIs, waarbij de Dienstregeling API gebruikt wordt om meer informatie van een geselecteerde rit op te vragen, bijv. de volgende haltes, de gevolgde route en de voertuigpositie.

 

Taal en projecties

Bij ieder request kan een taalkeuze worden aangegeven (Nederlands of Engels) voor vertaalbare woorden in het resultaat. Namen van haltes, vervoerders of plaatsen worden niet vertaald i.v.m. de herkenbaarheid onderweg. In het request kan worden aangegeven of de geleverde geografische coordinaten in WGS84 (latitude/longitude) of RDM (RijksDriehoekMeting - X/Y) geprojecteerd moeten worden.