Overzicht

De Ranglijst Toiletvriendelijkheid zet Nederlandse gemeenten in een tabel op basis van de toegankelijkheid en kwaliteit van openbare toiletten. Je sluit hem in met een iframe en kunt filteren op provincie, sorteren, indicatoren tonen en de taal kiezen. Meer over de totstandkoming van de lijst staat op HogeNood.nl.

Zoek je een visueel landelijk overzicht? Daarvoor is er een aparte kaart-iframe met eigen documentatie: Kaart Toiletvriendelijkheid – iframe documentatie.

Snelstart

Plak dit element in je pagina voor een landelijke ranglijst van 2025.

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

Weergaverichtlijnen

Jaar: geldige jaren zijn 2023 en later. Het lopende jaar is pas beschikbaar nadat HogeNood.nl de lijst heeft vrijgegeven.
Breedte: gebruik width:100% voor een responsieve weergave.
Hoogte: minimaal 800px.
Marges: voeg op kleine schermen zelf margin toe, zodat de rang niet tegen de schermrand valt.
Fullscreen: zet altijd allow="fullscreen" op het iframe.
Toegankelijkheid: geef het iframe een beschrijvende title, bijvoorbeeld inclusief jaar en provincie.

URL-encoding van JSON-parameters

De ranglijst accepteert filter en sort als JSON in de querystring. Regels:

Gebruik altijd dubbele quotes in de JSON ("field", "direction").
URL-encode de JSON voordat je hem in de src zet.
Gebruik geen backslash-escapes (\") in een HTML-attribuut; die komen letterlijk in de URL terecht.

const params = new URLSearchParams({   year: '2025',   filter: JSON.stringify({ or: [{ province: { equals: 'Flevoland' } }] }),   sort: JSON.stringify([{ field: 'TOTAL_SCORE', direction: 'DESC' }]), }); const src = `https://app.hogenood.com/open-data/municipality-ranking?${params}`;

URLSearchParams encodeert automatisch. Handmatig kan ook met encodeURIComponent(JSON.stringify(...)).

Integratie documentatie

Basis-URL: https://app.hogenood.com/open-data/municipality-ranking

Parameters

Parameter	Verplicht	Waarde	Effect
`year`	Ja	Jaartal, 2023 of later. Huidig jaar alleen geldig indien vastgesteld.	Zonder geldig jaar laadt de iframe niet
`first`	Nee	Getal, bijv. `100`	Maximaal aantal getoonde gemeenten, bijv. een top 5 of top 10. Weglaten toont alle gemeenten
`filter`	Nee	URL-gecodeerd JSON-object	Filtert op provincie(s)
`sort`	Nee	URL-gecodeerde JSON-array	Sortering, volgorde in de array = prioriteit
`indicators`	Nee	`true` / `false`	Toont de scores per indicator
`lang`	Nee	`nl`, `en`, `de`, `es`, `fr`, `fy`	Overschrijft de taal van het apparaat

Filteren op provincie

Alleen filteren op provincie is momenteel mogelijk. Zet meerdere provincies samen in een or. Een omhullende and mag, maar is niet nodig.

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

Gelijkwaardig, met and:

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

Geldige waarden: Drenthe, Flevoland, Friesland, Gelderland, Groningen, Limburg, Noord-Brabant, Noord-Holland, Overijssel, Utrecht, Zeeland, Zuid-Holland.

Sorteren

Geef een array van objecten met field en direction (ASC of DESC). Het eerste object weegt het zwaarst.

[{"field":"PUBLIC_TOILET_SCORE","direction":"DESC"},{"field":"TOTAL_SCORE","direction":"ASC"}]

Veld	Betekenis
`NAME`	Naam van de gemeente
`COUNTRY_RANK`	Landelijke rang
`PROVINCE_RANK`	Provinciale rang
`TOTAL_SCORE`	Totaalpunten
`DENSITY_SCORE`	Dichtheid van toiletten
`TOILET_ACCESSIBILITY_SCORE`	Voorzieningen van toiletten
`TOILET_NORM_SCORE`	Afstand tot toiletten
`PUBLIC_TOILET_SCORE`	Publieke toegankelijkheid
`POLICY_SCORE`	Gemeentelijk beleid
`SUBSCRIPTION_TYPE_SCORE`	Partners en samenwerkingen

Indicatoren en taal

indicators=true toont de specificatie per indicator. Weglaten of false verbergt ze.
Zonder lang kiest de iframe de apparaattaal, als die wordt ondersteund. Eén taal per URL.

Weergavegedrag

Met een provinciefilter toont de tabel de provinciale rang in plaats van de landelijke.
Met indicatoren aan toont de tabel totaalpunten in plaats van een rapportcijfer.

Volledig voorbeeld

Gelderland en Flevoland, eerste 100, gesorteerd op publieke toegankelijkheid, met indicatoren, in het Nederlands. Leesbaar (niet zo plakken):

year=2024 first=100 filter={"or":[{"province":{"equals":"Gelderland"}},{"province":{"equals":"Flevoland"}}]} sort=[{"field":"PUBLIC_TOILET_SCORE","direction":"DESC"},{"field":"TOTAL_SCORE","direction":"ASC"}] indicators=true lang=nl

URL-gecodeerd, klaar voor gebruik:

<iframe   src="https://app.hogenood.com/open-data/municipality-ranking?year=2024&first=100&filter=%7B%22or%22%3A%5B%7B%22province%22%3A%7B%22equals%22%3A%22Gelderland%22%7D%7D%2C%7B%22province%22%3A%7B%22equals%22%3A%22Flevoland%22%7D%7D%5D%7D&sort=%5B%7B%22field%22%3A%22PUBLIC_TOILET_SCORE%22%2C%22direction%22%3A%22DESC%22%7D%2C%7B%22field%22%3A%22TOTAL_SCORE%22%2C%22direction%22%3A%22ASC%22%7D%5D&indicators=true&lang=nl"   style="width:100%; height:800px;"   title="Ranglijst Toiletvriendelijkheid - Gelderland en Flevoland 2024"   allow="fullscreen"> </iframe>

Kant-en-klare code per provincie

Alle provinciale embeds volgen hetzelfde sjabloon. Vervang {PROVINCIE} door een naam uit de tabel; het jaar is 2025.

<iframe   src="https://app.hogenood.com/open-data/municipality-ranking?year=2025&filter=%7B%22or%22%3A%5B%7B%22province%22%3A%7B%22equals%22%3A%22{PROVINCIE}%22%7D%7D%5D%7D"   style="width:100%; height:800px;"   title="Ranglijst Toiletvriendelijkheid - {PROVINCIE} 2025"   allow="fullscreen"> </iframe>

Provincie	Waarde voor `{PROVINCIE}`
Drenthe	`Drenthe`
Flevoland	`Flevoland`
Friesland	`Friesland`
Gelderland	`Gelderland`
Groningen	`Groningen`
Limburg	`Limburg`
Noord-Brabant	`Noord-Brabant`
Noord-Holland	`Noord-Holland`
Overijssel	`Overijssel`
Utrecht	`Utrecht`
Zeeland	`Zeeland`
Zuid-Holland	`Zuid-Holland`

De koppeltekens in provincienamen hoeven niet geëncodeerd te worden.

Ranglijst Toiletvriendelijkheid Gemeenten - iFrame voor ontwikkelaars