Data
Datablog: Radiobox2 API
In Juni hebben we al even gekeken naar de data sets van de Publieke Omroepen. Nu gaan we er eentje dieper uitlichten: De informatie die ontsloten wordt in het metadatasysteem van de radio. Deze heet de Radiobox. Zo te zien kunnen uitzendingen opgehaald worden vanaf maart 2010.
Data model
De handleiding van de Radiobox is vrij uitgebreid. Dit komt ook omdat er veel entiteiten ontsloten worden. Om inzichtelijk te maken hoe het feitelijke informatiemodel in elkaar steekt hebben we de volgende diagram gemaakt (om de boel te simplificeren hebben we een aantal relaties er uit gelaten — het gaat hier meer om de big picture.)
Kanalen
Om alle kanalen op te halen die in het systeem zitten, moet je de volgende API call doen:
https://radiobox2.omroep.nl/channel/search.json?q=
Het ontbreken van een zoekterm zorgt ervoor dat alle kanalen worden teruggegeven.
Zoek operatoren
De Radiobox API heeft specifieke operatoren om te zoeken, die grote overeenkomsten vertonen met constructies in SQL. De meeste constructies staat hier uitstekend beschreven. Wel even opletten bij de LIKE operator: Je moet zelf de % toevoegen. Om naar alle items met Michael Kiwanuka te zoeken roep je dus de volgende URL aan:
https://radiobox2.omroep.nl/item/search.json?q=description~’%kiwanuka%’
Nu en Toen
De meeste search API calls hebben een startdatetime en een stopdatetime veld. Op de documentatie van het Track model vind je goede voorbeelden van hoe je de track moet opvragen die op dit moment op een kanaal speelt, of hoe je een track opvraagt die in een bepaalde tijd speelde.
JSON en Cross-Domain Policy
De meeste API calls zijn ook cross-domain via JSON op te vragen; handig voor JavaScript apps dus! De API call om tracks op te halen vormt hierop echter een uitzondering. Wil je deze ophalen dan moet je even een (serverside) proxietje schrijven die dat voor je regelt.
Demo
We hebben een app in elkaar geklust die een (near) real time overzicht biedt van wat er nu op de publieke radio speelt. De code staat in een GitHub repo.
Hackathon
Op 9 november a.s. organiseren we Hackathon Publieke Omroep -mogelijk gemaakt door NPO en Beeld en Geluid op het mediapark in Hilversum. TV kijken en radio luisteren kan nòg leuker en de omroep is dan ook een beetje van ons. Informatie over inschrijvingen volgt.
Laatste berichten van Breyten Ernsting (toon alles)
- NPO Backstage Datablog #3: Met je hoofd op tv! - 31 augustus 2015
- Bouw je eigen Cultuurscraper - 21 mei 2014
- Diplotwoops: Wat verwijderde tweets van diplomaten zeggen over Oekraïne - 21 februari 2014
Hartelijk dank voor de info
drie opmerkingen
– de omroep heeft ook last van not-invented-here:
– http://denachtklinktanders.vara.nl/gemist niet up to date 2 uur na uitzending, terwijl
– http://radiobox2.omroep.nl/rss/ug/programme/34.rss al wel actueel is
– de link op deze pagina loopt echter via http://nl.sitestat.com
– met een directe verwijzing naar http://download.omroep.nl/audiologging/r1/2013/09/26/0200_0559_de_n8_klinkt_andrs.mp3 (duidelijker kan in mijn opinie niet)
– kunnen ze de serverlog niet gebruiken voor de site statistieken?
– open data? dan zou deze ‘audiologging’ ook gewoon op een pagina kunnen?
– security by obfuscation?
“Uw e-mailadres zal nooit gepubliceerd of gedeeld worden” maar wel over een onbeveiligde verbinding uitgewisseld worden met ‘onze’ server.
ip adres bekend in de ‘directe verwijzing’ serverlog
P.S. http://sportzomer.radio1.nl/gids/2013-09-25 is een leuke poging, maar mist nou net het volledige overzicht….
Hi Heinze
Sitestat wordt gebruikt om dat de statistieken voor alle programma’s en omroepen op 1 plek moeten zijn. Vandaar. Serverlogging zou niet helpen, serverside scripting wel.
Sinds kort is radiobox2.omroep.nl niet meer bereikbaar (error code 410: gone). Weet iemand waar deze data nu te vinden is?
Goeie vraag. Ik kan zo snel niet vinden waarom radiobox2 weg is en wat er voor de in plaats is gekomen 🙁
Ik baal hier ook flink van. Ik had altijd een mooi radio1 podcastje waarin ik uit alle items van alle programma ’s gedurende de dag een interessant playlistje kon samenstellen.
Jammer hoor, iemand een idee voor een alternatief?
Aah jammer idd! Ik heb een vraag via Twitter uitstaan, maar nog geen reactie: https://twitter.com/siccovansas/status/1279021058436272133
klopt! Het was mij ook al opgevallen!
Schijbaar is er atgelopen week overgegaan op een ander systeem achter de schermen voor producers etc, mogelijk heeft dat er mee te maken als het uit de lucht is nu.
Hallo Marcel,
RadioBox is niet langer beschikbaar omdat het productie-systeem wat erachter zat (RadioManager) per 01-01-2020 niet meer bij NPO in gebruik is. Radiox was grontendeels afhenkelijk van RadioManager voor zijn data en ook ook dit systeem is niet meer in gebruik.
Dat betekent dat NPO op dit moment geen openbare API voor radio-programmadata meer aanbiedt.
Wij hebben op dit moment geen plannen voor een vervangende dienst.
Walter Huijten – NPO Service Manager Radio
“…per 01-07-2020 niet meer bij NPO in gebruik is…” bedoelde ik.
Dank voor de toelichting! Erg jammer dat er nu geen publieke API meer beschikbaar is.
Hi, ik heb een API gevonden waar informatie staat over het nummer dat momenteel wordt afgespeeld en vorige nummers.
De url is: https://www.nporadio2.nl/api/tracks
Handig, dank!