Concepten: datasets vs collecties

Een paar termen komen terug in de API. Ze goed begrijpen maakt de rest van de documentatie vanzelfsprekend.

Dataset

Een dataset is het data-artifact — de records, schema, voorbeeld en metadata. Het is het waardevolle ding, geïdentificeerd door een stabiele table naam (bijvoorbeeld nl-domino-poi). Elke dataset waar Topolab mee werkt heeft er één, inclusief B2B-only datasets die niet in de winkel worden verkocht.

In de REST API spreek je een dataset aan via zijn table:

GET /v1/dataset/nl-domino-poi
GET /v1/dataset/nl-domino-poi/files/geojson

Product

Een product is de commerciële wrapper rond een of meer datasets — prijs, licentie, checkout. Een dataset heeft nul of één product. Producten zijn belangrijk wanneer je koopt; voor data-toegang werk je met datasets.

Collectie (OGC)

In de OGC API wordt elke dataset die je kunt benaderen gepresenteerd als een collectie van features. "Collectie" is de OGC-term voor een doorzoekbare set van geospatiale features; voor Topolab komt dit overeen met een dataset. Je lijst collecties op en bladert door hun items (features):

GET /v1/ogc/collections
GET /v1/ogc/collections/{collectionId}/items

Dus dezelfde onderliggende dataset is een dataset in de REST API en een collectie in de OGC API. Gebruik de interface die het beste bij jouw tooling past — REST/SDK voor applicatiecode, OGC voor GIS-clients.

Hoe ze zich verhouden

Concept	Wat het is	Waar je het tegenkomt
Dataset	Het data-artifact (records, schema, metadata)	REST /v1/dataset/*, SDK's
Product	De commerciële wrapper (prijs, licentie)	Winkel / checkout
Collectie	Een dataset gepresenteerd als OGC features	OGC /v1/ogc/collections/*

Volgende

• Datasets API — werk met datasets via REST.
• OGC API — werk met dezelfde data als collecties.