Deze API biedt services voor het ophalen van verkeersborden events
1.0.1
Wijziging op 09-12-2020, ten behoeve van toevoeging “town-code” als query parameter
Haal een blok van verkeersborden events op.
Dit API endpoint biedt een manier om alle gepubliceerde verkeersborden events in blokken te verkrijgen, die worden gespecificeerd door de limit- en offsetquery-parameters. De geretourneerde verkeersbord events worden gesorteerd op hun publication_timestamp, oudste eerst.
Het publication_timestamp van het laatst ontvangen event kan dus worden gebruikt om de volgende reeks events te verkrijgen met behulp van de offset-parameter. Dit biedt een gemakkelijke manier om het ophalen van verkeersborden events te stoppen en op een later tijdstip voort te zetten.
Omdat de publication_timestamp van gebeurtenissen potentieel niet uniek is, zullen volgende verzoeken events van de gegeven offsettimestamp bevatten, om potentiële events niet te missen of over te slaan. Merk op dat dit zal resulteren in het ophalen van dubbele events die correct aan de clientzijde moeten worden afgehandeld.
Als u vragen heeft over deze API en het gebruik ervan, dan kunt u contact opnemen met de servicedesk van NDW (mail@servicedeskndw.nu)
Bij vragen over de inhoud van de gedownloade bestanden verwijzen we u graag naar de leverancier van deze data. Deze contactgegevens staan in Toelichting open data verkeersborden en FAQ.
GET
https://data.ndw.nu/api/rest/static-road-data/traffic-signs/v1/events
Veldnaam | Beschrijving | Datatype |
---|---|---|
offset |
Tijdstempel dat het publicatiemoment aangeeft opgehaald. |
Datetime: |
limit |
Maximumaantal geretourneerde verkeersborden (blokgrootte). |
Integer |
town-code |
Gemeentecode die kan worden gebruikt om het gebied te beperken waarvandaan verkeersborden worden teruggestuurd. |
String |
GET https://data.ndw.nu/api/rest/static-road-data/traffic-signs/v1/events?offset= 2020-04-27T12:34:56.123Z&limit=100&town-code=GM0321
GET https://data.ndw.nu/api/rest/static-road-data/traffic-signs/v1/events - dit zal de standaard queryparameterwaarden gebruiken
De verkeersborden events zijn met succes opgehaald sinds en inclusief de gegeven offsettimestamp, gemaximaliseerd tot de gegeven limit. De geretourneerde verkeersborden events worden gesorteerd op hun publicication_timestamp, oudste eerst.
De body heeft het content-type application/json en is een JSON-array van onderstaande JSON-objectbeschrijving.
Veldnaam | Beschrijving | Datatype met voorbeeld |
---|---|---|
id |
Identificatiecode die een verkeersbord uniek identificeert |
Integer |
type |
Gebeurtenistype dat het type wijziging op de verkeersbordgegevens aangeeft |
Type-veld, mogelijke waardes: created, updated, deleted |
schema_version |
Versie-indicator van het gegevensschema dat op het event is toegepast |
<major>.<minor> bv. 1.0 |
publication_timestamp |
Het moment waarop het verkeersborden event werd gepubliceerd in UTC (ISO8601) |
Datetime: |
validated |
Indicator of de gegevens al dan niet gevalideerd zijn |
Alfanumeriek |
validated_on |
Datum waarop de gegevens zijn gevalideerd |
Date |
user_id |
Installateur-/onderhouder-ID |
Integer |
organisation_id |
Installateur-/onderhouder-organisatie ID |
Integer |
rvv_code |
Alfanumeriek |
|
text_signs |
Tekst van borden onder het verkeersbord |
Array met alfanumerieke waardes |
location.wgs84.latitude |
Float |
|
location.wgs84.longitude |
Float |
|
location.rd.x |
Float |
|
location.rd.y |
Float |
|
location.placement |
Aan de kant van de weg (L) of boven de weg (B) |
Alfanumeriek |
location.side |
Links of rechts indien van toepassing voor het weggedeelte, anders het kompas van het verkeersbord |
Alfanumeriek |
location.road.name |
Alfanumeriek |
|
location.road.type |
Alfanumeriek |
|
location.road.number |
Integer |
|
location.road.wvk_id |
Wegvak ID |
Integer |
location.county.name |
Alfanumeriek |
|
location.county.code |
Alfanumeriek |
|
location.county.townname |
Alfanumeriek |
|
details.image |
Link naar de afbeelding van het verkeersbord |
Alfanumeriek |
details.first_seen |
Eerste keer dat het verkeersbord gezien is |
Date |
details.last_seen |
Laatste keer dat het verkeersbord gezien is, tot nu toe |
Date |
details.removed |
Datum waarop het verkeersbord is verwijderd |
Date |
De client heeft een verzoek verzonden dat niet aan de specificatie voldoet.
De body van de response bevat informatie over de aard van de fout.
Meestal is dit antwoord te wijten aan een fout aan de kant van de client.
Voorbeelden van foutgevallen:
Het verzoek is niet succesvol verwerkt vanwege een technisch probleem of beperking.
De body van de response kan informatie bevatten over de aard van de fout.