HogeNood – Ranglijst Toiletvriendelijkheid (Developer Documentation)

De Ranglijst Toiletvriendelijkheid geeft een overzicht van Nederlandse gemeenten op basis van de toegankelijkheid en kwaliteit van openbare toiletten. Deze lijst kan eenvoudig geïntegreerd worden via een iframe, met ondersteuning voor filtering, sortering en indicatoren.

Voor meer informatie over de totstandkoming van de lijst, navigeer naar de website.

1. Basisimplementatie via iframe

Plaats het volgende HTML-element:

<iframe src="https://app.hogenood.com/open-data/municipality-ranking?year=2024" style="width:100%; height:800px;" title="Ranglijst Toiletvriendelijkheid Gemeenten"> </iframe>

Let op:

Het jaar wordt meegegeven als queryparameter (year=2024).
Zonder geldig jaar werkt de iframe niet. Geldige jaren zijn 2024 en hoger, met het huidige jaartal, na vrijgave van de lijst via HogeNood.nl.
width op 100% voor responsiviteit; height aanbevolen op minimaal 800px. U dient zelf margin toe te voegen bij kleinere schermen om de rang niet tegen de zijkant van het scherm te zien.

2. Filteren via URL

Gebruik de queryparameter filter met een URL-gecodeerd JSON-object.

Voor de filter wordt gebruik gemaakt van een and / or filter. Plaats alle provincies in de or van de and. Momenteel is het nog niet mogelijk om meer filters te gebruiken. Het is ook mogelijk om de and weg te laten, en vanuit de or te werken.

{"and":[{"or":[{"province":{"equals":"Flevoland"}},{"province":{"equals":"Gelderland"}}]}]}

Geldige filterbare provincies

Veld	Beschrijving
`Drenthe`	Provincie Drenthe
`Friesland`	Provincie Friesland
`Gelderland`	Provincie Gelderland
`Groningen`	Provincie Groningen
`Limburg`	Provincie Limburg
`Noord-Brabant`	Provincie Noord-Brabant
`Noord-Holland`	Provincie Noord-Holland
`Overijssel`	Provincie Overijssel
`Utrecht`	Provincie Utrecht
`Zuid-Holland`	Provincie Zuid-Holland
`Flevoland`	Provincie Flevoland
`Zeeland`	Provincie Zeeland

3. Sortering via URL

Gebruik de sort queryparameter met een URL-gecodeerde JSON-array.

Voorbeeld: sorteer op totaalpunten oplopend

?sort=[{"field":"TOTAL_POINTS","direction":"ASC"}]

Meerdere sorteercriteria

?sort=[{"field":"POINTS_PUBLIC","direction":"DESC"},{"field":"TOTAL_POINTS","direction":"ASC"}]

Prioriteit wordt bepaald door de volgorde in de array.
field: veldnaam (zie sectie 4)
direction: "ASC" of "DESC"

URL-gecodeerd voorbeeld

<iframe src="https://app.hogenood.com/open-data/municipality-ranking?year=2024&sort=%5B%7B%22field%22%3A%22TOTAL_POINTS%22%2C%22direction%22%3A%22ASC%22%7D%5D" style="width:100%; height:800px;" title="Ranglijst Toiletvriendelijkheid Gemeenten"> </iframe>

Tip: encodeURIComponent(JSON.stringify([...])) automatisch JSON encoderen

Geldige sorteerbare velden

Veld	Beschrijving
`NAME`	Naam van de gemeente
`RANKING`	Plaats in de ranglijst op landelijk niveau
`RANKING_PROVINCE`	Plaats in de ranglijst op provinciaal niveau
`TOTAL_POINTS`	Totaalpunten van de gemeente
`POINTS_DENSITY`	Punten op basis van dichtheid van toiletten
`POINTS_FACILITIES`	Punten op basis van voorzieningen van toiletten
`POINTS_PROXIMITY`	Punten op basis van afstand tot toiletten
`POINTS_PUBLIC`	Punten op basis van publieke toegankelijkheid
`POINTS_POLICY`	Punten op basis van gemeentelijk beleid
`POINTS_PARTNER`	Punten op basis van partners en samenwerkingen

4. Indicatoren aan/uit

Voeg indicators=true toe om de specificatie van de indicatoren te tonen.
Weglaten of false verbergt indicatoren.

5. Taal

Standaard wordt de taal geselecteerd van het apparaat, mits dit tot de vertaal opties behoord, te weten:

Veld	Beschrijving
`nl`	Nederlands
`en`	Engels
`de`	Duits
`es`	Spaans
`fr`	Frans
`fy`	Fries

Voeg lang toe aan de url om de standaard taal te overschrijven. Gebruik als waarde een van de velden. Één taal mogelijk.

6. Samengevatte URL-structuur

https://app.hogenood.com/open-data/municipality-ranking? year=2024 &first=100 &filter=URL-gecodeerde-JSON &sort=URL-gecodeerde-JSON &indicators=true &lang=nl

Voorbeeld

https://app.hogenood.com/open-data/municipality-ranking?
year=2024
&first=100
&filter={"and":[{"or":[{"province":{"equals":"Gelderland"}},{"province":{"equals":"Flevoland"}}]}]}
&sort=[{"field":"POINTS_PUBLIC","direction":"DESC"},{"field":"TOTAL_POINTS","direction":"ASC"}]
&indicators=true
&lang=nl

iFrame code

<iframe 
  src="https://app.hogenood.com/open-data/municipality-ranking?year=2024&first=100&filter={\"and\":[{\"or\":[{\"province\":{\"equals\":\"Gelderland\"}},{\"province\":{\"equals\":\"Flevoland\"}}]}]}&sort=[{\"field\":\"POINTS_PUBLIC\",\"direction\":\"DESC\"},{\"field\":\"TOTAL_POINTS\",\"direction\":\"ASC\"}]&indicators=true&lang=nl" 
  style="width:100%; height:800px;" 
  title="Ranglijst Toiletvriendelijkheid Gemeenten">
</iframe>

year = verplicht
first = optioneel
filter = optioneel
sort = optioneel
indicators = optioneel
lang = optioneel

7. Logica aanvullingen

Gebruik altijd dubbele quotes in JSON ("field" en "direction").
URL-encode JSON voor correcte werking.
Meerdere sorteercriteria: volgorde bepaalt prioriteit.
Gebruik width:100% en height >= 800px voor correcte iframe-weergave.
Indien in de query gebruik wordt gemaakt van provincie filtering, dan wordt de kolom rang landelijk niet getoond, maar de provinciale rang.
indien de indicatoren worden weergegeven, dan wordt er een totaal punten weergegeven in plaats van een rapportcijfer.

Ranglijst toiletvriendelijkheid iframe voor developers