OTM API
Inleiding
Dit product bevat situatiegegevens vanuit NDW's situatieberichten feed. De situaties zijn van DATEXII naar OTM getransformeerd. De situatieberichten feed bevat situaties omtrent wegwerkzaamheden, snelheid- en baan- en verkeersmanagement op specifieke momenten. Dit product bevat actuele en toekomstige situaties tot één week in de toekomst in het OTM-formaat.
Structuur en inhoud
De volgende classses in het diagram kunnen voorkomen in de geleverde data. Specifieke uitleg over het OTM-formaat is te vinden op de officiële documentatie website.
OTM Constraints
OTM kent routes. Routes bevat informatie omtrent locatie, tijd en andere beperkingen. DATEXII situaties worden omgezet naar OTM routes met beperkingen. Routes waarvan de locatie en tijd beperking hetzelfde zijn komen in gecombineerde route. Combinaties van verschillende beperkingen zijn mogelijk.
De volgende beperkingen, volgens de OTM specificatie, kunnen voorkomen in dit product:
- TimeWindowConstraint: Beperking op tijd. Wordt gebruikt in combinatie met andere constraint om aan te geven wanneer ze gelden.
- VehicleTypeConstraint: Beperking op voertuigtype.
- ValueBoundConstraint: Beperking op snelheid, gewicht en andere waardes.
- AndConstraint: Combineren van meerdere beperkingen.
- OrConstraint: Alleen wanneer beperkingen zijn met meerdere tijdvensters.
- GenericConstraint: Wordt gebruikt om weg/baan- afsluiting aan te geven middels de omschrijving.
Andere beperkingen in OTM zijn niet gebruikt.
Voorbeelden
Snelheidslimitatie op een gegeven stuk weg met een tijdvenster.
{
"constraint": {
"associationType": "inline",
"entity": {
"value": {
"and": [
{
"endTime": "2023-11-14T15:15:00Z",
"startTime": "2022-12-14T05:30:00Z",
"type": "timeWindowConstraint"
},
{
"constraintType": "maximum",
"description": "Max. speed 30 km/h",
"maximum": {
"unit": "km/h",
"value": 30.0
},
"type": "valueBoundConstraint",
"valueType": "speed"
}
],
"type": "andConstraint"
}
}
},
"creationDate": "2022-12-15T15:11:20.669Z",
"geoReferences": {
"geometry": {
"coordinates": [
[
4.710488,
52.293814
],
...
],
"type": "LineString"
},
"type": "Feature"
},
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"lastModified": "2022-12-15T15:14:36.733Z"
}
Snelheidslimitatie op een gegeven stuk weg met meerdere tijdvensters.
{
"constraint": {
"associationType": "inline",
"entity": {
"value": {
"and": [
{
"or": [
{
"endTime": "2023-11-14T15:15:00Z",
"startTime": "2022-12-14T05:30:00Z",
"type": "timeWindowConstraint"
},
{
"endTime": "2023-11-15T15:15:00Z",
"startTime": "2022-12-15T05:30:00Z",
"type": "timeWindowConstraint"
}
]
},
{
"constraintType": "maximum",
"description": "Max. speed 30 km/h",
"maximum": {
"unit": "km/h",
"value": 30.0
},
"type": "valueBoundConstraint",
"valueType": "speed"
}
],
"type": "andConstraint"
}
}
},
"creationDate": "2022-12-15T15:11:20.669Z",
"geoReferences": {
"geometry": {
"coordinates": [
[
4.710488,
52.293814
],
...
],
"type": "LineString"
},
"type": "Feature"
},
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"lastModified": "2022-12-15T15:14:36.733Z"
}
Weg afgesloten voor alle soorten voertuigen op een tijdvenster.
{
"constraint": {
"associationType": "inline",
"entity": {
"value": {
"and": [
{
"endTime": "2023-04-26T15:00:00Z",
"startTime": "2023-01-23T07:00:00Z",
"type": "timeWindowConstraint"
},
{
"description": "closed",
"type": "genericConstraint"
}
],
"type": "andConstraint"
}
}
},
"creationDate": "2023-01-05T08:53:32Z",
"geoReferences": {
"geometry": {
"coordinates": [
[
6.921372,
52.312493
],
...
],
"type": "LineString"
},
"type": "Feature"
},
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"lastModified": "2023-01-23T07:03:51Z"
}
Weg afgesloten voor bepaalde soorten voertuigen op een tijdvenster.
{
"constraint": {
"associationType": "inline",
"entity": {
"value": {
"and": [
{
"endTime": "2023-02-17T10:00:00Z",
"startTime": "2023-02-17T08:00:00Z",
"type": "timeWindowConstraint"
},
{
"type": "vehicleTypeConstraint",
"vehicleTypes": [
"car",
"carWithTrailer",
"motorcycle",
"motorscooter",
"van",
"lorry",
"bus",
"constructionOrMaintenanceVehicle",
"moped",
"agriculturalVehicle"
]
},
{
"description": "closed",
"type": "genericConstraint"
}
],
"type": "andConstraint"
}
}
},
"creationDate": "2023-02-17T08:00:02.712Z",
"geoReferences": {
"geometry": {
"coordinates": [
[
5.074835,
51.626959
],
...
],
"type": "LineString"
},
"type": "Feature"
},
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"lastModified": "2023-02-17T10:00:00.638Z"
}