API voor plaatsen rondom een plaats

Vraag steden, grote en kleine dorpen, buurtschappen en wijken binnen een gekozen straal op als JSON. Handig voor servicegebieden, lokale SEO, regionale lijsten en interne tools.

Endpoint

Gebruik een GET-request met minimaal de parameter plaats.

GET https://www.plaatsenrondom.nl/api/plaatsen-rondom?plaats=Hooghalen&straal=25&types=stad,groot-dorp,dorp&limit=100

Parameters

Naam	Verplicht	Beschrijving
plaats	Ja	Plaatsnaam of slug, bijvoorbeeld `Hooghalen` of `hooghalen`.
straal	Nee	Afstand in kilometers. Mogelijk: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50. Standaard: 25.
types	Nee	Kommagescheiden lijst. Mogelijk: stad, groot-dorp, dorp, buurtschap, wijk, buurt, gemeente.
limit	Nee	Maximaal aantal resultaten. Standaard 100, maximum 1000.

Voorbeeldrespons

{
  "origin": {
    "name": "Hooghalen",
    "slug": "hooghalen",
    "type": "dorp",
    "province": "Drenthe"
  },
  "radius_km": 25,
  "types": ["stad", "groot-dorp", "dorp"],
  "count": 2,
  "limit": 100,
  "results": [
    {
      "name": "Assen",
      "slug": "assen",
      "type": "stad",
      "distance_km": 9.4,
      "url": "https://www.plaatsenrondom.nl/drenthe/assen/assen"
    }
  ]
}

Afstanden

Afstanden zijn hemelsbreed berekend vanaf het middelpunt van de gekozen plaats. De werkelijke reisafstand over de weg kan dus afwijken.

Foutmeldingen

Een onbekende plaats geeft een 404. Ongeldige parameters, zoals een niet-ondersteunde straal, geven een 422 met validatiefouten.

Geen API-key nodig

Het endpoint is openbaar te gebruiken. Houd requests redelijk en cache resultaten waar dat kan.

Plaatsnaamborden onder CC BY 4.0

Alle plaatsnaamborden staan onder CC BY 4.0 en zijn als catalogus op te halen: per plaats één tot drie afbeeldingen, met licentie, bronvermelding en afmetingen erbij. De veldnamen volgen het Openverse-catalogusschema (foreign_identifier, foreign_landing_url, image_url), zodat een ingestion-job ze direct kan overnemen.

GET https://www.plaatsenrondom.nl/api/plaatsnaamborden?per_page=100&page=1&provincie=Drenthe

Naam	Verplicht	Beschrijving
page	Nee	Paginanummer. Volg `links.next` tot die leeg is.
per_page	Nee	Aantal plaatsen per pagina. Standaard 100, maximum 500.
provincie	Nee	Beperk tot één provincie, bijvoorbeeld `Drenthe`.
gewijzigd_na	Nee	Datum of tijdstip; geeft alleen plaatsen die daarna zijn bijgewerkt. Voor incrementeel ophalen.

Paginering telt plaatsen, niet afbeeldingen: plaatsen zonder gemeente hebben geen variant met gemeenteregel. Het aantal afbeeldingen op een pagina staat in meta.images_on_page. De licentie zit ook in de bestanden zelf: als RDF in de SVG en als tekstvelden in de PNG.