bbox en filtering

De items-endpoint accepteert queryparameters die de resultaten beperken voordat ze worden teruggegeven. Gebruik bbox om te beperken op gebied en categorie, stad of land om te beperken op attribuut. Combineer een van deze met limiet en offset voor paging.

Vereist een API-sleutel met de GIS_ACCESS add-on in de X-API-Key header. Zie Authenticatie.

Parameters

Parameter	Voorbeeld	Betekenis
bbox	4.85,52.34,4.95,52.40	Bounding box minLon,minLat,maxLon,maxLat in WGS84. Retourneert functies binnen de box.
categorie	restaurant	Match functies waarvan de categorie eigenschap gelijk is aan deze waarde.
stad	Amsterdam	Match functies waarvan de stad eigenschap gelijk is aan deze waarde.
land	nl	Match functies waarvan de land eigenschap gelijk is aan deze waarde.
limiet	100	Functies per pagina. Standaard 100, max 1000.
offset	0	Functies om over te slaan voordat resultaten worden teruggegeven.

Filters worden gecombineerd met logische EN — een functie moet voldoen aan elke parameter die je opgeeft. Het numberMatched veld in de response weerspiegelt het gefilterde totaal, zodat paging werkt hetzelfde als in Items.

Filter op bounding box

bbox volgorde is minLon,minLat,maxLon,maxLat. Dit voorbeeld dekt ruwweg centraal Amsterdam:

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/ogc/collections/nl-domino-poi/items?bbox=4.85,52.34,4.95,52.40"

Alleen functies waarvan de geometrie binnen die box valt, worden teruggegeven. Omdat coördinaten WGS84 zijn, lees je de box als lengte- dan breedtegraad, wat overeenkomt met de GeoJSON volgorde.

Filter op attribuut

Beperk tot een enkele categorie:

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/ogc/collections/nl-domino-poi/items?categorie=restaurant&limiet=50"

Beperk tot een stad en land:

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/ogc/collections/nl-domino-poi/items?stad=Rotterdam&land=nl"

Combineer filters en pagina

Filters en paging kunnen worden gecombineerd. Dit haalt de tweede pagina van restaurants binnen de Amsterdam box:

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/ogc/collections/nl-domino-poi/items?bbox=4.85,52.34,4.95,52.40&categorie=restaurant&limiet=100&offset=100"

Volg de next link in de response om door te gaan met het pagineren van de gefilterde set.

Direct gebruiken vanuit een GIS-client

QGIS, ArcGIS en andere OGC-compatibele clients kunnen rechtstreeks wijzen naar https://api.topolab.nl/v1/ogc als een OGC API - Features bron, waarbij je sleutel in de X-API-Key header wordt verzonden. Ze doen dezezelfde itemverzoeken onder de motorkap — bbox wordt aangedreven door de kaartuitbreiding, en attribuutfilters worden gekoppeld aan de filter UI van de client. Zie de QGIS plugin gids en de ArcGIS toolbox gids.

Fouten

Status	Betekenis
401	Ontbrekende of ongeldige API-sleutel.
403	Sleutel is geldig, maar de organisatie mist de GIS_ACCESS add-on.
404	Onbekende collectionId.
429	Snelheidslimiet overschreden.

Volgende

• Items — de volledige FeatureCollection response vorm.
• Enkele functie — haal één functie op op id.
• Heb je een sleutel met GIS_ACCESS? Neem contact op.