DATEX II rerouting events
The standard DATEX II manages rerouting events (for example, <situationRecord> node with type set to ReroutingManagement). .
Optima provides additional capabilities, added as DATEX II extensions:
Important: Before creating or updating a rerouting event, you can read Optima rerouting events through the API → Getting all traffic events.
All rerouting properties are under the main node <d2LogicalModel>/<payloadPublication>/<situation>/<situationRecord>.
In the table, the relevant properties for rerouting events, with additional properties provided by the extensions.
| Property | DATEX II Optima extensions | Description |
|---|---|---|
|
NO |
Contains the main path. The order of the locations is important, hence the type must be set to ItineraryByIndexedLocations. |
|
YES |
Each of these entries represents a single street of the path. The type must be set to StreetLocationTDE, which contains:
Important: The street information must be specified otherwise the event is rejected. |
|
NO |
Contains an alternative path. The order of the locations is important, hence the type must be set to ItineraryByIndexedLocations. |
|
YES |
Each of these entries represents a single street of the path. The type must be set to StreetLocationTDE, which contains:
Important: The street information must be specified otherwise the event is rejected. |
|
YES |
The conformity of an alternative route identifies the quota of users that deviates on this path, and is represented by a number between 0 and 1. The conformity value of the main route is set as: (1 - sum of all the conformity values of the alternative routes). |
Important: The /.../locationContainedInItinerary[@index] must be populated with an integer number representing the order of the locations.
Payload example: reroutingEvent
Request
https://<OPTIMA_HOST_IP_ADDRESS>:<PORT_NUMBER>/datex2import/optima/?publish=TRUERequest body (payload)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<d2LogicalModel xmlns="http://datex2.eu/schema/2/2_0" xmlns:ns2="http://datex2.eu/schema/2/2_0/com/sistemaits/ext">
<exchange>
<supplierIdentification>
<country>other</country>
<nationalIdentifier>OPTIMA</nationalIdentifier>
</supplierIdentification>
</exchange>
<payloadPublication xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="SituationPublication" lang="other">
<publicationTime>2018-12-04T17:59:03.529+01:00</publicationTime>
<publicationCreator>
<country>other</country>
<nationalIdentifier>OPTIMA</nationalIdentifier>
</publicationCreator>
<situation id="OPTIMA_SITUATION_1543942625020" version="1">
<headerInformation>
<confidentiality>noRestriction</confidentiality>
<informationStatus>real</informationStatus>
</headerInformation>
<situationRecord xsi:type="ReroutingManagement" id="EVNT_1543942625020" version="1">
<situationRecordCreationTime>2018-12-04T17:57:05.026+01:00</situationRecordCreationTime>
<situationRecordVersionTime>2018-12-04T17:57:05.026+01:00</situationRecordVersionTime>
<severity>low</severity>
<source>
<sourceCountry>other</sourceCountry>
<sourceIdentification>OPTIMA</sourceIdentification>
</source>
<validity>
<validityStatus>definedByValidityTimeSpec</validityStatus>
<validityTimeSpecification>
<overallStartTime>2018-12-04T17:57:28.000+01:00</overallStartTime>
</validityTimeSpecification>
</validity>
<impact>
<delays>
<delayBand>negligible</delayBand>
<delayTimeValue>13.577143</delayTimeValue>
</delays>
</impact>
<generalPublicComment>
<comment>
<values>
<value lang="en">
</value>
</values>
</comment>
</generalPublicComment>
<nonGeneralPublicComment>
<comment>
<values>
<value lang="en">
</value>
</values>
</comment>
</nonGeneralPublicComment>
<groupOfLocations xsi:type="ItineraryByIndexedLocations">
<locationContainedInItinerary index="1">
<location xsi:type="Linear">
<linearExtension>
<linearLocationTDE xsi:type="StreetLocationTDE">
<streetID>127</streetID>
<tailStreetNodeID>3152</tailStreetNodeID>
</linearLocationTDE>
</linearExtension>
</location>
</locationContainedInItinerary>
<locationContainedInItinerary index="2">
<location xsi:type="Linear">
<linearExtension>
<linearLocationTDE xsi:type="StreetLocationTDE">
<streetID>18404</streetID>
<tailStreetNodeID>2248</tailStreetNodeID>
</linearLocationTDE>
</linearExtension>
</location>
</locationContainedInItinerary>
</groupOfLocations>
<alternativeRoute xsi:type="ItineraryByIndexedLocations">
<locationContainedInItinerary index="1">
<location xsi:type="Linear">
<linearExtension>
<linearLocationTDE xsi:type="StreetLocationTDE">
<streetID>31301</streetID>
<tailStreetNodeID>15022</tailStreetNodeID>
</linearLocationTDE>
</linearExtension>
</location>
</locationContainedInItinerary>
<locationContainedInItinerary index="2">
<location xsi:type="Linear">
<linearExtension>
<linearLocationTDE xsi:type="StreetLocationTDE">
<streetID>50</streetID>
<tailStreetNodeID>4501</tailStreetNodeID>
</linearLocationTDE>
</linearExtension>
</location>
</locationContainedInItinerary>
<itineraryExtension>
<itineraryWithCompliance>
<compliance>0.6</compliance>
</itineraryWithCompliance>
</itineraryExtension>
</alternativeRoute>
<alternativeRoute xsi:type="ItineraryByIndexedLocations">
<locationContainedInItinerary index="1">
<location xsi:type="Linear">
<linearExtension>
<linearLocationTDE xsi:type="StreetLocationTDE">
<streetID>194</streetID>
<tailStreetNodeID>4606</tailStreetNodeID>
</linearLocationTDE>
</linearExtension>
</location>
</locationContainedInItinerary>
<locationContainedInItinerary index="2">
<location xsi:type="Linear">
<linearExtension>
<linearLocationTDE xsi:type="StreetLocationTDE">
<streetID>254</streetID>
<tailStreetNodeID>5623</tailStreetNodeID>
</linearLocationTDE>
</linearExtension>
</location>
</locationContainedInItinerary>
<locationContainedInItinerary index="3">
<location xsi:type="Linear">
<linearExtension>
<linearLocationTDE xsi:type="StreetLocationTDE">
<streetID>317</streetID>
<tailStreetNodeID>4688</tailStreetNodeID>
</linearLocationTDE>
</linearExtension>
</location>
</locationContainedInItinerary>
<itineraryExtension>
<itineraryWithCompliance>
<compliance>0.2</compliance>
</itineraryWithCompliance>
</itineraryExtension>
</alternativeRoute>
</situationRecord>
</situation>
</payloadPublication>
</d2LogicalModel>