Ga naar inhoud

Verkeersborden download API 5.0

API beschrijving

Met deze API haal je het actuele beeld van de verkeersborden op. Het actuele beeld bevat voor elk verkeersbord het resultaat van alle verwerkte wijzigingen, inclusief alles wat George zelf afleidt, zoals de gemeente en het wegvak.

De API is gebaseerd op de Nederlandse API-strategie voor geodata. De response is een GeoJSON FeatureCollection. Je hebt geen toegangstoken nodig. Zonder filters krijg je het totaalbestand, dat dagelijks wordt gegenereerd. Met filters wordt het actuele beeld direct opgebouwd uit de gegevens van dat moment, inclusief wijzigingen van die dag.

De API-specificatie staat op de pagina Swagger UI Verkeersborden download API 5.0.

Info

Wil je verkeersborden aanleveren of wijzigen vanuit een eigen systeem? Dan kun je de Verkeersborden beheer API gebruiken.

Verschillen met versie 4.0

  • Het actuele beeld is altijd GeoJSON. Er is geen CSV-uitvoer meer.
  • Je kunt filteren op onderbordcode (obCode).
  • Je kunt het coördinatenstelsel ook kiezen met de header Accept-Crs.
  • De API kent geen aparte events-service meer.
  • Het veld status zit niet meer in de response. Filteren op status kan nog wel.
  • Hernoemde velden:
    • textSigns is nu supplementarySigns. Een onderbord heeft een signCode (bijvoorbeeld OB503) in plaats van een type.
    • firstSeenOn is nu registeredOn.
    • lastSeenOn is nu lastModifiedOn.
    • externalId is nu de lijst externalReferences, met per verwijzing een system en een id.
    • trafficOrderUrl is nu trafficOrderId.
    • bgtCode is vervangen door privateProperty. Had een bord een bgtCode, dan is privateProperty nu true.
  • Andere waardes:
    • placement is ALONG of ABOVE in plaats van L of B.
    • zoneCode is BEGIN, END, REPEAT of UNKNOWN in plaats van ZB, ZE, ZH of ZO.
    • drivingDirection is BACK in plaats van T en FORTH in plaats van H.
  • Vervallen velden: validated, side, nenTurningDirection, roadName, roadType, roadNumber, townName en imageUrl.
  • Nieuwe velden: conditions, ownerType, ownerCode en missingRoadSection.

Services

Service GET verkeersborden actueel beeld

Samenvatting

Haal het actuele beeld van de verkeersborden op, eventueel gefilterd.

HTTP methode

GET

URL

https://data.ndw.nu/api/rest/static-road-data/traffic-signs/v5/current-state

Query parameters en headers

Alle filters en headers staan in de Swagger UI Verkeersborden download API 5.0. Let vooral op het volgende:

  • Filters combineer je met EN. Meerdere waarden binnen één filter combineer je met OF. Je geeft meerdere waarden op door de parameter te herhalen, bijvoorbeeld rvvCode=A1&rvvCode=A2.
  • Zonder status krijg je alleen verkeersborden met status PLACED. Wil je geplande of verwijderde borden, geef dan status=PLANNED of status=REMOVED op.
  • Het coördinatenstelsel van de response kies je met de header Accept-Crs of de queryparameter crs. Geef je beide op, dan gaat crs voor. Standaard is WGS84.
  • De bbox is in het coördinatenstelsel van bbox-crs, standaard WGS84. Een te grote bounding box geeft een 400. Wil je een groot gebied, gebruik dan een ander filter of het totaalbestand.
  • countyCode is GM gevolgd door vier cijfers, dus met voorloopnullen, bijvoorbeeld GM0363.
  • roadAuthorityCode is juist zonder voorloopnullen en moet exact overeenkomen: 363 voor de gemeente Amsterdam, niet 0363. Een provincie heeft twee letters (bijvoorbeeld NH), een waterschap WS gevolgd door een nummer (bijvoorbeeld WS27).

Voorbeelden

GET https://data.ndw.nu/api/rest/static-road-data/traffic-signs/v5/current-state?countyCode=GM0448
Levert alle geplaatste verkeersborden in gemeente 0448.

GET https://data.ndw.nu/api/rest/static-road-data/traffic-signs/v5/current-state?countyCode=GM0448&rvvCode=A1&rvvCode=A2
Levert de A1 en A2 verkeersborden in gemeente 0448.

GET https://data.ndw.nu/api/rest/static-road-data/traffic-signs/v5/current-state?status=PLANNED&roadAuthorityType=G&roadAuthorityCode=363
Levert de geplande verkeersborden van de gemeente Amsterdam als wegbeheerder.

GET https://data.ndw.nu/api/rest/static-road-data/traffic-signs/v5/current-state?bbox=5.97,50.88,6.0,50.90
Levert de verkeersborden binnen de bounding box (in Heerlen), in WGS84.

GET https://data.ndw.nu/api/rest/static-road-data/traffic-signs/v5/current-state?countyCode=GM0448
Header: Accept-Crs: http://www.opengis.net/def/crs/EPSG/9.9.1/28992
Levert de verkeersborden van gemeente 0448 met coördinaten in Rijksdriehoek.

Response -- 200 OK

Het actuele beeld is met succes opgehaald. De body heeft het content-type application/geo+json. De response bevat de header Content-Crs met het coördinatenstelsel van de geometrie.

De body is een GeoJSON FeatureCollection. Elk verkeersbord is een Feature:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": "e0ace570-8eee-45ef-8083-f6139460c52a",
      "geometry": {
        "type": "Point",
        "coordinates": [5.94342, 50.92481]
      },
      "properties": {
        "rvvCode": "A1",
        "blackCode": "50",
        "placement": "ALONG",
        "bearing": 49,
        "supplementarySigns": [
          { "signCode": "OB401", "text": "150 m", "index": 0 }
        ],
        "roadSectionId": 600840745,
        "countyCode": "GM0917",
        "countyName": "Heerlen",
        "nwbVersion": "2023-11-01",
        "privateProperty": false,
        "missingRoadSection": false,
        "registeredOn": "2020-12-01",
        "placedOn": "2020-12-01"
      }
    }
  ]
}

Beschrijving outputvelden

De betekenis, het formaat en de mogelijke waardes van elk veld staan in de Swagger UI Verkeersborden download API 5.0. Daar staat ook per veld of het altijd aanwezig is. Een veld zonder waarde wordt niet altijd in de response opgenomen.

Response -- 400 Bad Request

De client heeft een verzoek verzonden dat niet aan de specificatie voldoet. Bij een ongeldige parameter bevat de body in errors welke parameter niet klopt.

Voorbeelden van foutgevallen:

  • countyCode komt niet overeen met het formaat GM gevolgd door vier cijfers
  • roadSectionId bevat waarden die niet numeriek zijn
  • bbox heeft een ongeldig formaat, of is te groot

Response -- 500 Internal Server Error

Het verzoek is niet succesvol verwerkt vanwege een technisch probleem of beperking.

Service GET collections

Met GET https://data.ndw.nu/api/rest/static-road-data/traffic-signs/v5/collections vraag je op welke coördinatenstelsels de API ondersteunt. De response bevat de lijst crs.

Als je vragen hebt over deze API, de data en het gebruik ervan, neem dan contact op met de NDW Servicedesk.

Ga terug naar de vorige pagina