NS-API vs NS-API

[Koch]

Beste Herbert,

Wanneer gaat NS de openbare API wat betreft functionaliteit gelijk trekken met de interne API die nu wordt gebruikt in de eigen NS-apps? Op dit moment heeft de Android app zelfs nieuwe functualiteit om een complete rit inclusief aankomst/vertrektijden en de prognoses daarbij (gehele ritten uit het dagplan) te verkrijgen.

Het gaat dan om de /mobile-api-service info call. Deze functualiteit is in deze groep al door meerdere ontwikkelaars herhaaldelijk gevraagd. Ik vind dat de NS geen eerlijk speelveld hanteert. Ruwe informatie over afwijkingen op de dienstregeling wordt al niet beschikbaar gemaakt (WP2000 art 14.1) en nieuwe functualiteit is eerder in NS apps beschikbaar dan voor serviceproviders.

mvg,

Thomas Koch

[Aar]

Ik merk ook dat er aan de publieke API van de NS inderdaad weinig aandacht meer wordt besteedt. Waar het in het begin veel aan veranderingen onderhevig was lijkt de ontwikkeling behoorlijk tot stilstand gekomen.

Zo zitten er in de NS XtrA app de mogelijkheden om stationsvoorzieningen tevoorschijn te toveren (en dat gaat via een verborgen API heb ik ontdekt) maar deze is nog niet publiekelijk verschenen terwijl er plannen waren om deze serieus aan te bieden.

Nu in de nieuwe NS Xtra app is ook een routelint meegeleverd die aangeeft op welke stations de treinen zijn gestopt, nu hoop ik dat deze informatie ook gedeeld van worden met het publiek.
Graag wacht ik op een reactie van de NS voor meer uitleg.



Op maandag 6 mei 2013 23:17:35 UTC+2 schreef Koch het volgende:

[Koch]

Op dinsdag 7 mei 2013 09:35:56 UTC+2 schreef Aar het volgende:

Ik merk ook dat er aan de publieke API van de NS inderdaad weinig aandacht meer wordt besteedt. Waar het in het begin veel aan veranderingen onderhevig was lijkt de ontwikkeling behoorlijk tot stilstand gekomen.

Zo zitten er in de NS XtrA app de mogelijkheden om stationsvoorzieningen tevoorschijn te toveren (en dat gaat via een verborgen API heb ik ontdekt) maar deze is nog niet publiekelijk verschenen terwijl er plannen waren om deze serieus aan te bieden.

Nu in de nieuwe NS Xtra app is ook een routelint meegeleverd die aangeeft op welke stations de treinen zijn gestopt, nu hoop ik dat deze informatie ook gedeeld van worden met het publiek.

Het route lint is dus de /mobile-api-service call in de NS-API

[Ronald]

Heren,

We proberen om de API weer even een slinger te geven, door andere prioriteiten binnen NS is het de afgelopen periode inderdaad stil geweest. Op de lijst staat ook het overnemen van de route-service die in de API voor Android/iPhone zit. Stationsfaciliteiten kan eventueel volgen; maar deze is niet zo heel erg eenvoudig. 

Groet,

Ronald (NS)

[Geert Wirken]

Goed om te horen dat er weer wat werk van de NS-API wordt gemaakt!

Is het ook mogelijk om de start- en eindtijd van geplande werkzaamheden
op te nemen in machine-leesbaar formaat? Op 26 maart heb ik dit al wat
uitgebreider gevraagd.
(https://groups.google.com/forum/#!topic/ns-api/A0Eht-gRrk0)

Wat is overigens in het algemeen het beleid ten aanzien van de interne
NS-API vs. de externe NS-API, zoals Thomas Koch al vroeg? Aangezien de
functionaliteit toch al ontwikkeld is (en naar ik aanneem ook
gedocumenteerd) voor eigen NS-applicaties lijkt het mij namelijk een
kleine moeite om dezelfde API's beschikbaar te stellen voor anderen.

Welke beweegredenen zijn er om de interne API anders te behandelen ten
opzichte van de externe API? En is NS op termijn van plan om het
onderscheid te laten vervallen?

Met vriendelijke groet,

Geert Wirken

[Herbert]

Hoi Thomas en anderen,

 

Zoals al aangegeven door Ronald zullen we in de toekomst weer meer aandacht gaan besteden aan de NS-API.

 

In principe is er de intentie om elke interne service ook extern aan te bieden, alleen soms zijn er specifieke overwegingen om dat (nog) niet te doen.

Bijvoorbeeld in het geval van een pilot (zoals met de drukte-informatie) waarbij we bv. de kwaliteit van de data eerst willen beproeven, of als het technisch wat lastiger is (bv. stationsfaciliteiten).

En we hebben natuurlijk niet onbeperkt tijd en geld.

 

Ik denk dat het goed is om nog maar eens te benadrukken dat NS de NS-API niet aanbiedt vanuit wettelijke verplichtingen, maar vanuit de overtuiging dat het goed is voor onze reizigers als goede reisinformatie zo breed mogelijk beschikbaar is.

Daarom stellen we kant-en-klare services beschikbaar waarmee ontwikkelaars relatief gemakkelijk toepassingen kunnen maken.

Denk bijvoorbeeld aan de reisadvies-service: een cruciale functie waarmee NS haar reisplanner gratis beschikbaar stelt aan externe apps e.d.

Dit gaat veel verder dan de wettelijke verplichtingen om ruwe data beschikbaar te stellen.

 

Het traject van het beschikbaar stellen van de ruwe data volgt de afspraken die zijn gemaakt rondom ND-OV en kent een eigen planning.

Al geruime tijd zijn de treindienstregelingen beschikbaar op http://9292opendata.org/, zowel het jaarplan als het dagplan.

Ik begrijp niet wat wordt bedoeld met de opmerking dat ruwe data over afwijkingen op de dienstregeling niet beschikbaar wordt gemaakt; refereert dat aan het dagplan of aan afwijkingen op de dag zelf?

Het dagplan is dus wél beschikbaar, en de actuele afwijkingen op de dag zelf zullen uit InfoPlus gaan komen.

Momenteel wordt gewerkt aan de eerste actuele datakoppeling, voor vertrekkende treinen (DVS=Dynamische VertrekStaat in InfoPlus).

 

Samengevat:

- De NS-API is niet bedoeld om een speelveld eerlijk te maken o.i.d. maar om het speelveld voor applicatie-ontwikkelaars zo gemakkelijk mogelijk te maken. Waar we daar nog niet in slagen heeft dat te maken met pragmatische overwegingen.

- ND-OV is het traject waarin de NS-data volgens alle wettelijke regels beschikbaar is en komt, geheel conform de afspraken in dat verband gemaakt.

 

Zoals gezegd, de komende tijd gaan wij weer aan de slag om de NS-API verder te verbeteren.

Daarbij zullen we zeker kijken naar de ritinformatie en de informatie over geplande werkzaamheden.

Blijf jullie wensen vooral aangeven!

 

Groeten, Herbert (NS)

 

Op maandag 6 mei 2013 23:17:35 UTC+2 schreef Koch het volgende:

Beste Herbert,

[Martin]

Maar in de dagplan zouden toch alle ritten rondom werkzaamheden moeten staan? Ik heb in het weekend regelmatig ritnummers van treinen welke ik niet kan terug vinden in de laatste versie van de iff bestanden.

Wanneer komt de eerste versie van InfoPlus beschikbaar?

[Koch]

Beste Herbert,

Wat de NS nu doet is voor de wettelijke verplichting en het stimuleren van de API beide "net niet". NS voldoet niet aan haar wettelijke verplichting conform WP2000 (geen actuele data, geen prijzen, etc.). En met de API geven zowel jij als Ronald aan dat het is blijven liggen.

Er werd al sinds het begin gezeurd over die IFF dat het pas na jaren een keer op 9292 verscheen, nadat de API kreupel gemaakt is. Zou Ingrid Thijssen daar nu trots op zijn?

Er zijn inmiddels genoeg net niet apps gemaakt. En Logica/CGI heeft ook genoeg mogen experimenteren. Wanneer organiseert de NS een Hackaton net zoals de SNCF in Frankrijk, waarbij wel gewoon alles beschikbaar wordt zodat iedereen kan zien wat er is, maar nog niet is vercommercialiseerd?

Groeten,

Thomas Koch

Op woensdag 8 mei 2013 15:49:48 UTC+2 schreef Herbert het volgende:

[Simon Pellegrom]

Op 6 mei 2013 23:17 schreef Koch <thoma...@gmail.com> het volgende:

Het gaat dan om de /mobile-api-service info call.

​Is dat iPhone of Android, want op de iPhone zijn alle call's nog gewoon het opvragen van de route via reisplanner.​

[Koch]

Android, vanuit de actuele vertrektijden.

Op woensdag 8 mei 2013 22:50:36 UTC+2 schreef Simon Pellegrom het volgende:

[Herbert]

Hoi Martin, 

Ja het dagplan hoort alle ritten rondom werkzaamheden te bevatten.

Dus als je dit soort incidenten tegenkomt, zou je die willen mailen aan het api-mailadres van NS?

Dan kunnen we kijken wat er precies aan de hand is.

Op dit moment wordt gewerkt aan het beschikbaar stellen van de DVS-stroom uit InfoPlus.

Een opleverdatum is mij nog niet bekend.

Als daar meer duidelijkheid over is zullen we dat hier zeker melden.

groeten, Herbert (NS)

Op woensdag 8 mei 2013 15:56:19 UTC+2 schreef Martin het volgende:

[Herbert]

Hoi Thomas,

Wat Ronald en ik vooral hebben aangegeven is dat de afgelopen tijd andere zaken hogere prioriteit hebben gehad dan de NS-API.

Ik kan me heel goed voorstellen dat jij vanuit jouw perspectief heel erg kijkt naar het open data-aspect en wat daar nog aan mankeert.

Dat zou ik ook doen vanuit jouw positie.

Maar NS heeft de verantwoordelijkheid om naar het hele productaanbod van reisinformatie te kijken en te werken aan de issues die op dit moment het belangrijkst zijn voor onze klanten.

En door die bril bekeken functioneert de NS-API echt heel prima en zijn er nauwelijks issues.

Desondanks, zoals gezegd verwacht ik wel dat we binnenkort weer een impuls aan de NS-API kunnen gaan geven.

Overigens, zoals ik in mijn vorige reactie ook al aangaf, een van die andere prioriteiten waar dus wel aan gewerkt is en inmiddels de laatste hand aan wordt gelegd, is het beschikbaar stellen van de DVS-stroom uit InfoPlus.

Dat lijkt mij toch een hele mooie stap vanuit open data-perspectief.

Zo'n hackaton lijkt mij trouwens hartstikke leuk. Maar als ik je goed begrijp zou je vooral aan de slag willen met VKL-IS data? Dan komen we al gauw in de ProRail-processen terecht. Hoe dan ook, ik neem het idee mee.

Groeten, Herbert (NS)

Op woensdag 8 mei 2013 20:17:22 UTC+2 schreef Koch het volgende: