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
statuszit niet meer in de response. Filteren opstatuskan nog wel. - Hernoemde velden:
textSignsis nusupplementarySigns. Een onderbord heeft eensignCode(bijvoorbeeld OB503) in plaats van eentype.firstSeenOnis nuregisteredOn.lastSeenOnis nulastModifiedOn.externalIdis nu de lijstexternalReferences, met per verwijzing eensystemen eenid.trafficOrderUrlis nutrafficOrderId.bgtCodeis vervangen doorprivateProperty. Had een bord eenbgtCode, dan isprivatePropertynutrue.
- Andere waardes:
placementisALONGofABOVEin plaats vanLofB.zoneCodeisBEGIN,END,REPEATofUNKNOWNin plaats vanZB,ZE,ZHofZO.drivingDirectionisBACKin plaats vanTenFORTHin plaats vanH.
- Vervallen velden:
validated,side,nenTurningDirection,roadName,roadType,roadNumber,townNameenimageUrl. - Nieuwe velden:
conditions,ownerType,ownerCodeenmissingRoadSection.
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
statuskrijg je alleen verkeersborden met statusPLACED. Wil je geplande of verwijderde borden, geef danstatus=PLANNEDofstatus=REMOVEDop. - Het coördinatenstelsel van de response kies je met de header
Accept-Crsof de queryparametercrs. Geef je beide op, dan gaatcrsvoor. Standaard is WGS84. - De
bboxis in het coördinatenstelsel vanbbox-crs, standaard WGS84. Een te grote bounding box geeft een400. Wil je een groot gebied, gebruik dan een ander filter of het totaalbestand. countyCodeis GM gevolgd door vier cijfers, dus met voorloopnullen, bijvoorbeeld GM0363.roadAuthorityCodeis 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.
Go back to the previous page