Element situation
The situation element describes a situation on the road, a group of logically related situations or an object status (for example of bridges or rush-hour lanes). A situation has a mandatory attribute: id. In addition, a situation also contains the mandatory elements situationVersionTime, headerInformation and mandatory one or more times a [situationRecord](./situationrecord/index.md). The relatedSituation element (an element that can occur multiple times) is optional.
For more information about the situation element and underlying attributes and elements, see here.
Attributes
| Attribute | Type | Mandatory | Domain | Description |
|---|---|---|---|---|
| id | String | Yes | See explanation | A unique identification per data provider over time. |
id
A situation is given an id by the data provider that is unique in time. This means that a situation is given an id when it is created that has not previously been assigned to any other active or passed situation. The id remains the same as long as the situation is active. The id attribute is filled in in a format that only indicates the unique situation. Including additional information in the id is not permitted.
Elements
| Element | Type | Mandatory | Domain | Description |
|---|---|---|---|---|
| overallSeverity | SeverityEnum | Yes | highest, high, medium, low, lowest, none, unknown | In this element, the road manager has indicated to what extent a situation causes a (serious) disruption to traffic. |
| situationVersionTime | DateTime | Yes | Date and time as UTC (Zulu notation) | The time in coordinated universal time (UTC), Zulu notation, that the version in question became active at the data provider. |
| headerInformation | HeaderInformation | Yes | N/A | Management information regarding the data in a publication. |
| situationRecord | SituationRecord | 1 or more | N/A | Concrete description of the type and location of an event. |
| relatedSituation | SituationReference | No | N/A | Reference to a specific version of a related situation. |
| informationManager | InternationalIdentifier | No | N/A | An identifier/name whose scope is specific to the specific country. |
| situationSummary | SituationRecord | Yes | N/A | A SituationRecord that summarizes the information described by the associated Situation, i.e. a superset of at least the location and validity information of all (other) SituationRecords in this Situation. |
Subelement HeaderInformation
| Element | Type | Mandatory | Domain | Description |
|---|---|---|---|---|
| confidentiality | ConfidentialityValueEnum | No | internalUse, noRestriction, restrictedToAuthorities, restrictedToAuthoritiesAndTrafficOperators | The extent to which the related information may be distributed, depending on the type of recipient. |
| informationStatus | InformationStatusEnum | Yes | real, securityExercise, technicalExercise, test | The status of the related information. |
Subelement relatedSituation
Sometimes different situations are related. For example, when related activities are performed at different locations. Such situations refer to each other by means of this non-mandatory element. This element does not express a hierarchy: all related situations refer to each other by means of one or more relatedSituation elements.
Always include references
Within the Dutch DATEX II profile it has been agreed that both related situations always refer to each other. This also applies if a relationship has already been established between underlying situationRecords by means of the cause element.
| Attribute | Type | Mandatory | Domain | Description |
|---|---|---|---|---|
| id | string | Yes | Valid id of a situation | A unique identification per data provider over time. |
| version | string | Yes | last | Reference to the most recent version of a situation. |
| targetClass | string | Yes | mandatory value: sit:Situation | Prescribed specialization of the class referred to. |
Example
<sit:situation id="NDW06_9ac1e28f-5fe4-4433-915d-61dc7f73400d">
<sit:overallSeverity>unknown</sit:overallSeverity>
<sit:situationVersionTime>2024-10-03T13:58:57.155740757Z</sit:situationVersionTime>
<sit:headerInformation>
<com:confidentiality>noRestriction</com:confidentiality>
<com:informationStatus>real</com:informationStatus>
</sit:headerInformation>
<sit:situationRecord xsi:type="sit:Accident" id="NDW06_9ac1e28f-5fe4-4433-915d-61dc7f73400d_2" version="5">
..
</sit:situationRecord>
<sit:relatedSituation>
<sit:objectReference id="NDW08_fca946b0-e66e-4276-9301-40c4e2a7361c_SIT" targetClass="sit:Situation" version="last"></sit:objectReference>
</sit:relatedSituation>
</sit:situation>