Landingspagina en conformiteit

Topolab implementeert OGC API - Features Part 1: Core, een standaard HTTP-interface voor het aanbieden van geospatiale kenmerken als GeoJSON. Elke OGC-compatibele client — QGIS, ArcGIS, GDAL/OGR — kan Topolab data rechtstreeks lezen door naar de basis-URL te wijzen, zonder aangepaste integratie.

De OGC API is te vinden op:

https://api.topolab.nl/v1/ogc

Drie discovery endpoints beschrijven de service en zijn anoniem — er is geen API-sleutel nodig. Alles wat verder gaat dan discovery (collecties en kenmerken) heeft een sleutel nodig met de GIS_ACCESS add-on; zie Authenticatie.

Wat OGC API - Features is

OGC API - Features is een OGC-standaard die een kleine, voorspelbare set van bronnen definieert: een landingspagina, een conformiteitsverklaring, een lijst van collecties en de kenmerken binnen elke collectie. Omdat het contract gestandaardiseerd is, kan een GIS-client alles ontdekken wat het nodig heeft tijdens runtime — het leest de conformiteitsverklaring, crawlt vervolgens de links — en presenteert Topolab datasets als live lagen die je kunt pannen, inzoomen en opvragen.

Dit is waarom GIS-gebruikers geen SDK nodig hebben: de client spreekt het protocol. Voor de applicatie-ontwikkelaarsweergave van dezelfde data via gewone REST, zie de Datasets API.

Landingspagina

De landingspagina is het toegangspunt. Het retourneert de servicetitel, een beschrijving en links naar de andere bronnen.

curl "https://api.topolab.nl/v1/ogc"

{
  "title": "Topolab OGC API - Features",
  "description": "Geospatiale kenmerken voor Topolab datasets, aangeboden als OGC API - Features.",
  "links": [
    {
      "rel": "self",
      "type": "application/json",
      "title": "Dit document",
      "href": "https://api.topolab.nl/v1/ogc"
    },
    {
      "rel": "conformance",
      "type": "application/json",
      "title": "Conformiteitsverklaring",
      "href": "https://api.topolab.nl/v1/ogc/conformance"
    },
    {
      "rel": "data",
      "type": "application/json",
      "title": "Collecties",
      "href": "https://api.topolab.nl/v1/ogc/collecties"
    },
    {
      "rel": "service-desc",
      "type": "application/vnd.oai.openapi+json;version=3.0",
      "title": "OpenAPI-definitie",
      "href": "https://api.topolab.nl/v1/ogc/api"
    }
  ]
}

Een client volgt de rel waarden: conformance om te leren wat de server ondersteunt, data om collecties te lijsten, en service-desc voor het OpenAPI-document.

Conformiteitsverklaring

Het conformiteitsendpoint lijst de conformiteitsklassen die de server implementeert. Een client leest dit om te beslissen welke verzoeken het mag doen.

curl "https://api.topolab.nl/v1/ogc/conformance"

{
  "conformsTo": [
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"
  ]
}

Deze drie klassen betekenen: de service implementeert OGC API - Features Part 1 Core, beschrijft zichzelf met OpenAPI 3.0, en serveert kenmerken als GeoJSON.

OpenAPI-document

Het api endpoint retourneert de OpenAPI 3.0 beschrijving van elke operatie, parameter en respons. Tools kunnen hieruit clients genereren, en het is de machine-leesbare metgezel van deze documentatie.

curl "https://api.topolab.nl/v1/ogc/api"

De respons is een standaard OpenAPI 3.0 document. De interactieve paden die het beschrijft — /collecties, /collecties/{collectionId}/items, enzovoort — zijn gedocumenteerd op de volgende pagina's.

Een GIS-client verbinden

Omdat deze endpoints standaard zijn, kun je https://api.topolab.nl/v1/ogc toevoegen als een OGC API - Features dataproduct in QGIS of ArcGIS en direct door Topolab collecties bladeren. De discovery endpoints zijn open; de collecties en kenmerken vereisen jouw API-sleutel in de X-API-Key header. Zie de QGIS plugin gids voor verbindingsstappen.

Volgende

• Collecties — lijst de datasets die beschikbaar zijn als feature collecties.
• Items — blader door de kenmerken in een collectie.
• Heb je een sleutel met GIS_ACCESS? Neem contact op.