Eindhoven municipal GIS services (ArcGIS REST)

Base URL

https://gisservice.eindhoven.nl/arcgis/rest/services

Endpoints 8

• GET?f=jsonDirectory: version, folders and services (name + type).
• GET/{dienst}/MapServer?f=jsonService: layers and tables (id, name, group layer or not), maxRecordCount, capabilities, projection, description.
• GET/{dienst}/MapServer/{laag}?f=jsonLayer: fields (name, type, alias, length), geometry type, maxRecordCount, supportedQueryFormats and advancedQueryCapabilities (pagination, statistics, orderBy, distinct).
• GET/{dienst}/MapServer/{laag}/queryQuery features with a where clause or spatial filter; also count (returnCountOnly) and group (outStatistics). Response in JSON, GeoJSON or PBF.
• GET/{dienst}/MapServer/legend?f=jsonLegend per layer: labels and symbols (PNG as base64).
• GET/{dienst}/MapServer/export?bbox=…&bboxSR=4326&size=600,400&format=png&f=imageMap image as PNG for a rectangle; with f=json you get a link to the image. Without bbox: error 'bbox must be specified'.
• GET/{dienst}/MapServer/find?searchText=…&layers=0&searchFields=…&f=jsonSearch text in fields of one or more layers (partial match), returning the layer and the matched field.
• GEThttps://gisservice.eindhoven.nl/arcgis/services/{dienst}/MapServer/WMSServer?request=GetCapabilities&service=WMSWMS 1.3.0 of the same MapServer: path without /rest/ and with /WMSServer. Only for services whose supportedExtensions lists WMSServer.

Filtering platform

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

Parameters 14

Fields of the example layer 10 · GRN_Bomen/MapServer/0 (128.070 bomen)

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
• This server upper-cases statistics field names: outStatisticFieldName 'n' comes back as 'N', 'gem' as 'GEM'. Read the field case-insensitively. tested
• resultRecordCount is ignored with outStatistics (all groups are returned, 18 KB for BOOMSOORT_NEDERLANDS). tested
• find searches text fields on part of the value, but returns attributes as text ('OBJECTID': '71') and is capped at 2,000 results (searchText=Tilia: 1.8 MB). For counting, prefer query with LIKE: BOOMSOORT LIKE 'Tilia%' = 7,994. tested
• There is an F5 firewall in front of the server: /robots.txt returns a 'Request Rejected' page (HTTP 200). The REST API itself worked fine; if you get that page on an API call, stop. tested
• Service names start with a department prefix (GRN_ green, VKR_ traffic, BST_, EHV_, LOM_ …). Part of data.eindhoven.nl is fed from this server. experience
• 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
• The server gives no modification date per service or layer (no editingInfo). How current a layer is, is not stated. tested

Try it HTTP 200 · 362 ms · 16 Oct

https://gisservice.eindhoven.nl/arcgis/rest/services/GRN_Bomen/MapServer/0/query?where=1%3D1&outStatistics=[{"statisticType"%3A"count"%2C"onStatisticField"%3A"OBJECTID"%2C"outStatisticFieldName"%3A"n"}]&groupByFieldsForStatistics=EIGENAAR&orderByFields=n DESC&f=json

{
  "displayFieldName": "",
  "fieldAliases": {
    "EIGENAAR": "EIGENAAR",
    "N": "N"
  },
  "fields": [
    {
      "name": "EIGENAAR",
      "type": "esriFieldTypeString",
      "alias": "EIGENAAR",
      "length": 50
    },
    {
      "name": "N",
      "type": "esriFieldTypeBigInteger",
      "alias": "N"
    }
  ],
  "features": [
    {
      "attributes": {
        "EIGENAAR": "BOR",
        "N": 108142
      }
    },
    {
      "attributes": {
        "EIGENAAR": "Particulier",
        "N": 11646
      }
    }
  ]
}

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