Bereikbaarheidskaart API

NDW Locatieservices levert een API om bereikbare en niet-bereikbare wegvakken inzichtelijk te maken. Deze interface wordt gebruikt voor onder andere de Bereikbaarheidskaart van het NDW.

Bron

De resultaten uit de bereikbaarheidskaart API zijn uit twee gegevensbronnen samengesteld. De API gebruikt het nationaal wegenbestand (NWB) voor het inlezen van het wegennetwerk. Op basis van de baansubsoort wordt een basisbereikbaarheid bepaald. Om per wegvak te kunnen bepalen of het bereikbaar is vanuit het startpunt, wordt daarnaast de verkeersborden API geraadpleegd. De verkeersborden worden met het wegennetwerk samengevoegd om te bepalen of er op een wegvak aanvullende restricties gelden.

Beperkingen

De bereikbaarheidskaart API kent enkele beperkingen. De API bepaalt de bereikbaarheid door een routebepaling zonder verkeersborden te vergelijken met een routebepaling met de verkeersborden die van toepassing zijn op het geselecteerde voertuig. Beide routes worden bepaald op een netwerk van wegvakken die qua NWB-baansubsoort bereikbaar voor auto's kunnen zijn, dus de respons bevat geen informatie over wegvakken die volgens het NWB alleen bereikbaar zijn voor openbaar vervoer, fietsers of voetgangers. Daarnaast houdt de API geen rekening met afslagverboden bij kruisingen en worden alleen verkeersborden in de bepaling gebruikt waarbij een absoluut verbod wordt aangeduid; verbodsborden met een onderbord voor uitzonderingssituaties of venstertijden worden dus niet in het resultaat verwerkt.

Gebruik

De API bestaat uit een tweetal endpoints waarmee de bereikbare en niet-bereikbare wegvakken kunnen worden uitgelezen per gemeente. Naast de gekozen gemeente moeten een of meerdere voertuigkenmerken worden aangeleverd. Deze kenmerken worden gebruikt om GLBHA-restricties (gewicht, lengte, breedte, hoogte en aslast) te toetsen. Ook kan worden gekozen of een aanhanger moet zijn toegestaan.

De API ondersteunt zowel een plat JSON-formaat als een output met GeoJSON, waarin onder andere de geometrie van de wegvakken is opgenomen. Optioneel kunnen de coördinaten van een bestemmingsadres worden meegegeven. Het dichtstbijzijnde wegvak wordt dan in het antwoord van de API gemarkeerd, zodat direct te zien is of de bestemming bereikbaar is.

Voor een meer gedetailleerde uitleg van de endpoints, zie de API-specificatie.

Authenticatie

Voor het gebruik van deze API is het niet nodig om te authenticeren.

Voorbeeld

Hieronder volgt een voorbeeld voor het ophalen van niet-bereikbare wegvakken binnen de gemeente Amersfoort. Hierbij is als voertuig een vrachtauto zonder aanhanger gekozen met de volgende kenmerken:

Aanroep (JSON)

curl -X 'GET' \
  'https://data.ndw.nu/api/rest/static-road-data/accessibility-map/v1/municipalities/GM0307/road-sections?vehicleType=truck&vehicleLength=5.2&vehicleWidth=2&vehicleHeight=3.2&vehicleWeight=20&vehicleAxleLoad=4&vehicleHasTrailer=false' \
  -H 'accept: application/json'

Respons (JSON)

Het respons bevat een lijst van alle bereikbare en niet-bereikbare wegvakken en (optioneel) het doelwegvak. Per wegvak is aangegeven of het in voorwaartse of achterwaartse richting bereikbaar is. Voor wegvakken die in het NWB als eenrichtingsweg zijn opgenomen, ontbreekt het bereikbaarheidsveld in de niet-bestaande richting.

{
  "inaccessibleRoadSections": [
    {
      "roadSectionId": 305324050,
      "forwardAccessible": false,
      "backwardAccessible": true
    },
    {
      "roadSectionId": 306327047,
      "forwardAccessible": true,
      "backwardAccessible": false
    },
    {
      "roadSectionId": 306337067,
      "forwardAccessible": true,
      "backwardAccessible": false
    },
    {
      "roadSectionId": 308326083,
      "forwardAccessible": false
    },
    {
      "roadSectionId": 309325069,
      "forwardAccessible": false,
      "backwardAccessible": false
    }
  ]
}

Aanroep (GeoJSON)

curl -X 'GET' \
  'https://data.ndw.nu/api/rest/static-road-data/accessibility-map/v1/municipalities/GM0307/road-sections.geojson?vehicleType=truck&vehicleLength=5.2&vehicleWidth=2&vehicleHeight=3.2&vehicleWeight=20&vehicleAxleLoad=4&vehicleHasTrailer=false' \
  -H 'accept: application/json'

Respons (GeoJSON)

Het respons bevat een lijst van alle bereikbare en niet-bereikbare wegvakken. Per wegvak is aangegeven of deze bereikbaar is. Wegvakken die bidirectioneel zijn, zijn uitgesplitst in twee losse features waarvan de tegenrichting een negatief id heeft en de geometrie is omgedraaid. Wanneer een bestemming is opgegeven, is het doelwegvak herkenbaar gemaakt met de eigenschap matched.

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": 299315001,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            5.310853,
            52.1084218
          ],
          [
            5.3108829,
            52.1084684
          ],
          [
            5.3108678,
            52.1086622
          ]
        ]
      },
      "properties": {
        "accessible": true
      }
    },
    {
      "type": "Feature",
      "id": 600793037,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            5.3577187,
            52.1644992
          ],
          [
            5.357814,
            52.1646575
          ]
        ]
      },
      "properties": {
        "accessible": false
      }
    }
  ]
}