Items

De items endpoint retourneert de kenmerken in een collectie als een GeoJSON FeatureCollection. Dit is het werkpaard van de OGC API — het is wat GIS-clients aanroepen om een laag te tekenen.

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

Kenmerken ophalen

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

{
  "type": "FeatureCollection",
  "numberMatched": 1234,
  "numberReturned": 2,
  "features": [
    {
      "type": "Feature",
      "id": "nl-domino-poi.1",
      "geometry": {
        "type": "Point",
        "coordinates": [4.8952, 52.3702]
      },
      "properties": {
        "name": "Domino's Pizza Amsterdam Centrum",
        "category": "restaurant",
        "city": "Amsterdam",
        "country": "nl",
        "postcode": "1012 JS"
      }
    },
    {
      "type": "Feature",
      "id": "nl-domino-poi.2",
      "geometry": {
        "type": "Point",
        "coordinates": [4.4777, 51.9244]
      },
      "properties": {
        "name": "Domino's Pizza Rotterdam Centrum",
        "category": "restaurant",
        "city": "Rotterdam",
        "country": "nl",
        "postcode": "3011 AA"
      }
    }
  ],
  "links": [
    {
      "rel": "self",
      "type": "application/geo+json",
      "href": "https://api.topolab.nl/v1/ogc/collections/nl-domino-poi/items?limit=2&offset=0"
    },
    {
      "rel": "next",
      "type": "application/geo+json",
      "href": "https://api.topolab.nl/v1/ogc/collections/nl-domino-poi/items?limit=2&offset=2"
    }
  ]
}

Coördinaten zijn WGS84 (EPSG:4326) in GeoJSON lengte-eerst volgorde: [longitude, latitude].

De reactie lezen

• numberMatched — het totale aantal kenmerken dat overeenkomt met het verzoek, over alle pagina's.
• numberReturned — hoeveel kenmerken er op deze pagina zijn (maximaal limit).
• links — navigatie. Een next link is aanwezig wanneer er meer kenmerken overblijven; volg deze om de volgende pagina te krijgen. De laatste pagina heeft geen next link.

Pagineren met limiet en offset

Parameter	Standaard	Max	Betekenis
limit	100	1000	Aantal kenmerken dat op deze pagina moet worden geretourneerd.
offset	0	—	Aantal kenmerken om over te slaan voordat resultaten worden geretourneerd.

Blader door een grote collectie door offset met limit te verhogen, of gewoon door elke reactie's next link te volgen totdat er geen meer wordt geretourneerd.

# Eerste pagina (kenmerken 0–99)
curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/ogc/collections/nl-domino-poi/items?limit=100&offset=0"

# Tweede pagina (kenmerken 100–199)
curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/ogc/collections/nl-domino-poi/items?limit=100&offset=100"

Een limit boven de 1000 aanvragen wordt beperkt tot 1000. Voor bulkextractie van een volledige dataset in één oproep is een volledige bestandsdownload via de Datasets API vaak eenvoudiger dan pagineren.

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	Rate limiet overschreden.

Volgende

• bbox en filtering — resultaten verfijnen op basis van gebied, categorie, stad of land.
• Enkele functie — haal één kenmerk op via id.