API

De tijden veranderen en we kunnen inmiddels met z'n allen grasduinen in openbaar vervoer gegevens. Met openOV willen we je toegang geven tot onze statische database en ons realtime messagingsysteem. De statische database kun je benaderen via het web. Het volgt zoveel mogelijk alle richtlijnen van het BISON project.

Dynamische haltetijden voor de stadsregio Amsterdam, provincie Utrecht en Bestuursregio Utrecht worden je aangeboden via een VPN naar GOVI. Deze organisatie regelt de ontvangst van openbaar vervoergegevens van vervoerders voor het gebruik in Dynamische Reisinformatie Systemen (DRIS), je kunt hier bij denken aan de borden bij de haltes. Via GOVI geven we je initieel toegang tot alle halte informatie van de stadsregio, voor een aantal buslijnen zul je ook live data kunnen ontvangen.

Licentie

De door ons gepubliceerde statische reisinformatie valt onder de CC-0 licentie: je kunt het altijd hergebruiken. Verschillende aanbieders van dynamische reisinformatie hebben andere voorwaarden gesteld;

• KV78turbo: GOVI voorwaarden
• Bestuursregio/Provincie Utrecht: GOVI voorwaarden
• Nederlandse Spoorwegen: NS-API voorwaarden

Statische Informatie

Statische ontsluiten we moment op verschillende plekken, aan de hand van het formaat van de data.

• Koppelvlak 1, direct van de vervoerders: kv1.openov.nl
• Koppelvlak 7 Turbo, geïntegreerd door GOVI: kv7.openov.nl
• DBSlayer, direct in SQL zoeken in de database.
• GTFS, door openOV gemaakt op basis van webservices van vervoerders: gtfs.openov.nl

Dynamische Informatie

De eerste informatie wordt aan ons beschikbaar gesteld via Koppelvlak 55. Onderwater is dit een asynchrone communicatie met een database, omdat weinig mensen zitten te wachten op een asynchrone beantwoordig van hun queries, is er een REST interface gemaakt naar deze dienst. What you see is what we get.

Daarnaast bieden we over XMPP een NS API PubSub aan, je kunt hem zonder API key ook over http bekijken: http://nsapi.xmpp.openov.nl/stations/ut/avt/

Nieuw! Momenteel ontwikkelen we aan KV78turbo, informatie op de Google Group

Ondersteuning

Voor vragen over onze API, ideeën en suggesties kun je altijd terecht op onze Google Group. Misschien keek je onder dit kopje omdat je ons ondersteuning wil komen bieden, uiteraard kan dat ook. Actief door mee te discusseren, of pull-request te doen op Github, maar we zitten ook op IRC.

De software voor deze site

• Cherokee: de snelste en uitgebreidste webserver met beheeromgeving.
• MonetDB: de snelste Nederlandse open source database.
• eJabberd: de robustste Jabber-implementatie die te vinden is.
• Python: voor scrapers, conversietools en asynchrone server.
• BeautifulSoup: voor de bagger van het web.
• uWSGI: om Python met de webserver te koppelen.
• ZeroMQ: Voor interne communicatie

Onze software is open source en te vinden op GitHub.

Documentatie

Een eerste poging om al onze programmatuur te documenteren is gestart op docs.openov.nl.