Bodemloket (soil information desk)

Base URL

https://gis.gdngeoservices.nl/standalone/rest/services/blk_gdn

Endpoints 7

• GET?f=jsonFolder blk_gdn: one service, lks_blk_rd_v1 (MapServer, ArcGIS 11.5).
• GET/lks_blk_rd_v1/MapServer?f=jsonThe service: layer 0 WBB_locaties, 1 Beschikbaarheid_gegevens (31), 2 Bevoegd_gezag (41); maxRecordCount 2,000; WMSServer extension.
• GET/lks_blk_rd_v1/MapServer/{laag}?f=jsonFields and capabilities of one layer.
• GET/lks_blk_rd_v1/MapServer/0/queryQuery soil locations: at a point with a radius, per competent authority, per status; count and group.
• GET/lks_blk_rd_v1/MapServer/export?bbox=120000,480000,125000,485000&bboxSR=28992&size=400,400&layers=show:0&format=png&f=jsonMap image of a rectangle (link to a PNG; with f=image the image itself).
• GET/lks_blk_rd_v1/MapServer/legend?f=jsonLegend per layer.
• GEThttps://gis.gdngeoservices.nl/standalone/services/blk_gdn/lks_blk_rd_v1/MapServer/WMSServer?request=GetCapabilities&service=WMSWMS 1.3.0 of the same service (path without /rest/).

Filtering platform

SQL-like where clause on the layer's fields, plus an optional spatial filter (geometry). Group and count with outStatistics.

Parameters 13

Fields of the example layer 9 · lks_blk_rd_v1/MapServer/0 (WBB_locaties)

Limits and pitfalls

• At most 2.000 features per response (the layer's maxRecordCount; varies per layer, see /{layer}?f=json). If there are more, the response has exceededTransferLimit: true: fetch the rest with resultOffset and resultRecordCount. tested
• No key and no documented rate limit. Take it easy (a few requests per second) and prefer statistics or counts over fetching all features. experience
• The outStatistics field comes back in upper case: if you ask for outStatisticFieldName 'n', the response calls it 'N'. Sorting with orderByFields=n DESC still works. tested
• The object key field is WBB_DOSSIER_DBK, not OBJECTID: orderByFields=OBJECTID returns 'Invalid or missing input parameters'. tested
• Errors come back with HTTP 200 and a JSON object {"error": {"code": 400, …}} ('Failed to execute query.' for an unknown field in where). Always check for an error field, not just the status code. tested
• 22,869 locations have no VERVOLG_WBB and no TYPE_CD. Amsterdam and Rotterdam supply nothing; 31 of the 41 competent authorities (layer 1) only show their data on their own website. tested
• No date field and no editingInfo: the API does not say when a location was updated. The total fluctuates (15 Oct 241,945, earlier on 16 Oct 242,206, in the evening 241,945 again). tested
• Layer 0 has polygons in RD (EPSG:28992). A query at a point with a radius: geometry=x,y&geometryType=esriGeometryPoint&inSR=28992&distance=250&units=esriSRUnit_Meter. tested

Try it HTTP 200 · 1,625 ms · 16 Oct

https://gis.gdngeoservices.nl/standalone/rest/services/blk_gdn/lks_blk_rd_v1/MapServer/0/query?where=1%3D1&outStatistics=[{"statisticType"%3A"count"%2C"onStatisticField"%3A"WBB_DOSSIER_DBK"%2C"outStatisticFieldName"%3A"n"}]&groupByFieldsForStatistics=VERVOLG_WBB&orderByFields=n DESC&f=json

{
  "displayFieldName": "",
  "fieldAliases": {
    "VERVOLG_WBB": "VERVOLG_WBB",
    "N": "N"
  },
  "fields": [
    {
      "name": "VERVOLG_WBB",
      "type": "esriFieldTypeString",
      "alias": "VERVOLG_WBB",
      "length": 50
    },
    {
      "name": "N",
      "type": "esriFieldTypeBigInteger",
      "alias": "N"
    }
  ],
  "features": [
    {
      "attributes": {
        "VERVOLG_WBB": "voldoende onderzocht",
        "N": 140554
      }
    },
    {
      "attributes": {
        "VERVOLG_WBB": "Uitvoeren historisch onderzoek",
        "N": 41143
      }
    }
  ]
}

Shortened response, saved at harvest time. Click the URL for the real, current response.