Ga naar inhoud

OTM API

Inleiding

Dit product bevat situatiegegevens vanuit NDW's situatieberichten feed. De situaties zijn van DatexII naar OTM getransformeerd. De sitautieberichten 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 officele documenatatie website.

Class diagram van mogelijke classes in de geleverde data

OTM Constrains

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, geweicht 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"
}
Ga terug naar de vorige pagina