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.

Algemene informatie over de bereikbaarheidskaart is te vinden op de applicatiepagina.

De broncode van de API is beschikbaar gesteld via GitHub.

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.

1. 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 over een netwerk van wegvakken die qua NWB-baansubsoort bereikbaar voor auto's kunnen zijn, ofwel: de respons bevat geen informatie over wegvakken die in het NWB een baansubsoort hebben als openbaar vervoer, fietsers of voetgangers.
2. Daarnaast houdt de API geen rekening met afslagverboden (RVV-codes D4 t/m D8) en worden uitsluitend verkeersborden in de bepaling gebruikt die geen onderbord hebben. Verbodsborden met een onderbord zoals 'uitgezonderd bewoners' of met venstertijden worden genegeerd en deze wegvakken zijn daarom als toegankelijk geclassificeerd.

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 binnen een drempelwaarde 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. Binnen de API worden gemeentes aangeduid met hun gemeentecode. Een lijst van te gebruiken gemeentecodes is op te halen met het municipalities endpoint. In het voorbeeld wordt de bereikbaarheid bepaald voor een vrachtauto zonder aanhanger met de volgende kenmerken:

Aanroep (JSON)

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

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)

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

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
      }
    }
  ]
}