Hoofdnavigatie

Naar content

Documentatie stationslijst

De webservice voor de stationslijst maakt het mogelijk om alle stationsnamen op te vragen. Het is uitdrukkelijk de bedoeling dat afnemers van deze service de response zelf voor bepaalde tijd cachen om op een performante manier auto-aanvullen te realiseren.


Request

Er zijn twee versies van de stationslijst. Per mei 2012 is v2 de aanbevolen versie. Versie 1 zal worden uitgefaseerd, nadere aankondiging hierover volgt. Vraag hieronder de stationslijst versie 1 of versie 2 op. Er zijn geen parameters.

Response Stationslijst versie 1

De response (versie 1) bestaat uit het element stations dat per station een element station bevat.

Een station kent de volgende structuur:

  • name (1): Lange naam van het station, bestaande uit maximaal 25 karakters.
  • code (1): Afkorting van het station. Deze afkorting is identificerend voor het station, maar in de stationslijst kan de afkorting meerdere malen voorkomen in het geval van aliassen. Zie hieronder bij alias.
  • country (1): Landcode van het station.
  • lat (1): Breedtegraad (latitude) van het station.
  • long (1): Lengtegraad (longitude) van het station.
  • alias (1): Geeft aan of dit station een alias is van een ander station. Dit houdt in dat 1 fysiek station meer dan 1 schrijfwijze voor de naam heeft. Bijvoorbeeld 's Hertogenbosch en Den Bosch, 's Gravenhage en Den Haag, Utrecht Maliebaan en Spoorwegmuseum.

Voorbeeld Stationslijst versie 1

Zie het volgende voorbeeld voor een deel van de reponse (eerste 3 stations):

<stations>
  <station>
    <name>'s-Gravenhage</name>
    <code>GVC</code>
    <country>NL</country>
    <lat>52.080276</lat>
    <long>4.325</long>
    <alias>true</alias>
  </station>
  <station>
    <name>'s-Hertogenbosch</name>
    <code>HT</code>
    <country>NL</country>
    <lat>51.690556</lat>
    <long>5.293611</long>
    <alias>false</alias>
  </station>
  <station>
    <name>'s-Hertogenbosch Oost</name>
    <code>HTO</code>
    <country>NL</country>
    <lat>51.700554</lat>
    <long>5.318333</long>
    <alias>false</alias>
  </station>

Response Stationslijst versie 2

De response (versie 2) bestaat uit het element Stations dat per station een element Station bevat.

Een station kent de volgende structuur:

  • Code (1): Identificerende afkorting van het station.
  • Type (1): Typering van het station.
  • Namen (1): Namen van het station.
  • Land (1): Landcode van het station:
  • UICCode (1): UIC-code van het station, identificerende code volgens de standaard van de Internationale Spoorwegunie, de UIC: Union Internationale des Chemins de fer.
  • Lat (1): Breedtegraad (latitude) van het station.
  • Lon (1): Lengtegraad (longitude) van het station.
  • Synoniemen (1): Synoniemen van het station.

Het element Namen kent de volgende structuur:

  • Kort (1): Korte naam van het station, bestaande uit maximaal 10  karakters.
  • Middel (1): Middellange naam van het station, bestaande uit maximaal 16 karakters.
  • Lang (1): Lange naam van het station, bestaande uit maximaal 25 karakter

Het element Synoniemen kent de volgende structuur:

  • Synoniem (0..n): Naam die als synoniem wordt gebruikt voor de lange stationsnaam.

Voorbeeld Stationslijst versie 2

Zie het volgende voorbeeld voor een deel van de reponse (eerste 3 stations):

<Stations>
  <Station>
    <Code>HT</Code>
    <Type>knooppuntIntercitystation</Type>
    <Namen>
      <Kort>H'bosch</Kort>
      <Middel>'s-Hertogenbosch</Middel>
      <Lang>'s-Hertogenbosch</Lang>
    </Namen>
    <Land>NL</Land>
    <UICCode>8400319</UICCode>
    <Lat>51.690556</Lat>
    <Lon>5.293611</Lon>
    <Synoniemen>
      <Synoniem>Hertogenbosch ('s)</Synoniem>
      <Synoniem>Den Bosch</Synoniem>
    </Synoniemen>
  </Station>
  <Station>
    <Code>HTO</Code>
    <Type>stoptreinstation</Type>
    <Namen>
      <Kort>H'bosch O</Kort>
      <Middel>Hertogenbosch O</Middel>
      <Lang>'s-Hertogenbosch Oost</Lang>
    </Namen>
    <Land>NL</Land>
    <UICCode>8400320</UICCode>
    <Lat>51.700554</Lat>
    <Lon>5.318333</Lon>
    <Synoniemen>
      <Synoniem>Hertogenbosch Oost ('s)</Synoniem>
      <Synoniem>Den Bosch Oost</Synoniem>
    </Synoniemen>
  </Station>
  <Station>
    <Code>HDE</Code>
    <Type>stoptreinstation</Type>
    <Namen>
      <Kort>'t Harde</Kort>
      <Middel>'t Harde</Middel>
      <Lang>'t Harde</Lang>
    </Namen>
    <Land>NL</Land>
    <UICCode>8400388</UICCode>
    <Lat>52.40917</Lat>
    <Lon>5.893611</Lon>
    <Synoniemen>
      <Synoniem>Harde ('t)</Synoniem>
    </Synoniemen>
  </Station>
</Stations>