For events that are provided in the DATEX II format, the endpoint returns a human-readable description of an event in all languages that are available on your Optima system.
Authentication phase
Before using the endpoint, you must run the authentication phase (→ Login).
After the authentication, a session opens and a valid session token persists until:
- The end of the session time-out, that is set through the parameter sessionTimeout (→ OptimaWSI configuration > OptimaAuth section).
- An explicit Logout call (→ Logout).
Response
Response status
| HTTP status | Description |
|---|---|
|
200 OK |
Result of the processed request. |
Response content-type
application/json
Response entity
JSON message with the event description for each language available on your Optima system.
Example
Request
https://<OPTIMA_HOST_IP_ADDRESS>:<PORT_NUMBER>/datex2import/optima/event/preview?session=88b06e8d9c2a21690ee6eb948ec7b708
Request input
{
"events": [
{
"idText": "METRO_556_2.1",
"idSituation": "METRO_556_2",
"idVersionUser": "pippo",
"idCreationUser": "pippo",
"version": 3,
"bidirectional": false,
"source": "SVRTOC",
"datex2Class": "MaintenanceWorks",
"datex2Attributes": {
"roadMaintenanceType": "maintenanceWork"
},
"creationTime": 1382534700000,
"updateTime": 1449659871747,
"valid": true,
"startTime": 1383256800000,
"locInfo": {
"priLocation": 14734,
"priOffset": 0,
"secLocation": 14733,
"secOffset": 0,
"tmcDirection": "POSITIVE",
"roadNameFrom": "SP135",
"roadNameTo": "SP135,FRAZIONE COSTIGLIOLA",
"linear": true,
"area": false,
"turn": false
},
"geometry": "MULTILINESTRING((8.97132968902588 44.7637214660645,8.97144 44.76373,8.97171 44.76371,8.97188 44.76369,8.97209 44.76368,8.97229 44.7637,8.97261 44.7638,8.97275 44.76388,8.97303 44.76394,8.97344 44.76396,8.97381019592285 44.7639999389648),(8.97381019592285 44.7639999389648,8.97391 44.76398,8.9741 44.76395,8.97438 44.76388,8.97461 44.76384,8.97499 44.76383,8.97521 44.76383,8.97542 44.76386,8.97562 44.76389,8.97598 44.76393,8.97629 44.76396,8.9764404296875 44.7639694213867),(8.9764404296875 44.7639694213867,8.97658 44.76398,8.97706 44.76405,8.9773 44.76413,8.97746 44.76423,8.97765 44.76431,8.97789 44.76442,8.97813 44.76446,8.97878 44.76457,8.97904 44.76464,8.97921 44.76473,8.97933 44.7649,8.97941017150879 44.7649993896484),(8.97941017150879 44.7649993896484,8.97961 44.76512,8.97981 44.76522,8.97994 44.7653,8.98023 44.76542,8.98062 44.76551,8.98097 44.7656,8.9813 44.76573,8.98149 44.76586,8.98172 44.766,8.98193 44.76605,8.98247 44.76613,8.98282 44.76615,8.98305988311768 44.7661399841309),(8.98305988311768 44.7661399841309,8.98335 44.76613,8.98348 44.76613,8.98356 44.76614,8.98367 44.76617,8.98378 44.76629,8.98377 44.76636,8.98374 44.76645,8.98373 44.76651,8.98361968994141 44.766658782959),(8.98361968994141 44.766658782959,8.98344 44.76708,8.98337 44.76715,8.98324 44.76726,8.98308 44.76735,8.983 44.76749,8.98296 44.7676,8.98288 44.76775,8.98268 44.76793,8.98253 44.76809,8.98234 44.76833,8.9822 44.76849,8.98186016082764 44.7686500549316),(8.98186016082764 44.7686500549316,8.98153 44.76881,8.98143 44.7689,8.98142 44.76899,8.98143005371094 44.7694396972656),(8.98143005371094 44.7694396972656,8.98142 44.76953,8.98136 44.76962,8.98121 44.76965,8.98073 44.76965,8.98050022125244 44.7696914672852),(8.98050022125244 44.7696914672852,8.98043 44.7697,8.98033 44.76973,8.98009 44.7698,8.97947 44.76995,8.97906017303467 44.77001953125),(8.97906017303467 44.77001953125,8.97867 44.77004,8.97851 44.77007,8.97834 44.77014,8.97804 44.77031,8.97766 44.77053,8.97718 44.77086,8.97694969177246 44.771110534668),(8.97694969177246 44.771110534668,8.97684 44.77133,8.97676 44.77167,8.97666 44.77202,8.97657 44.77221,8.97631 44.77239,8.97602 44.77258,8.97587 44.77272,8.97574996948242 44.7729110717773),(8.97574996948242 44.7729110717773,8.97569 44.77313,8.97577 44.77344,8.97583 44.77359,8.97581958770752 44.7736587524414),(8.97581958770752 44.7736587524414,8.97582 44.77373,8.97574 44.77385,8.97544 44.77415,8.97497 44.77454,8.97472953796387 44.7747688293457))",
"comment": "test di integrazione --> questo evento (simulato come scritto da utente di TS) non verrà più aggiornato automaticamente",
"severity": "0.0",
"datex2Impact": {
"delayBand": "negligible",
"delayTimeValue": 66.733086
},
"affectedStreets": [
{
"idno": 578580575,
"fromNode": 680682348
},
{
"idno": 577783446,
"fromNode": 680682350
},
{
"idno": 592385334,
"fromNode": 65646874
},
{
"idno": 763744524,
"fromNode": 65646903
},
{
"idno": 592385335,
"fromNode": 680657206
},
{
"idno": 578580399,
"fromNode": 65646938
},
{
"idno": 763744525,
"fromNode": 838241279
},
{
"idno": 763744523,
"fromNode": 838241278
},
{
"idno": 587601042,
"fromNode": 65646948
},
{
"idno": 587601041,
"fromNode": 65646947
},
{
"idno": 763744522,
"fromNode": 838241277
},
{
"idno": 592385332,
"fromNode": 680001237
},
{
"idno": 578580578,
"fromNode": 65646999
}
]
}
]
}
Response status
| HTTP status | Description |
|---|---|
|
200 OK |
Result of the processed request. |
Response output
{
"ru": "по SP135(AL) между Cervari и SP137-Costigliola test di integrazione --> questo evento (simulato come scritto da utente di TS) non verrà più aggiornato automaticamente, обслуживание из 22:00 от 31/10/2013",
"en": "on SP135(AL) between Cervari and SP137-Costigliola test di integrazione --> questo evento (simulato come scritto da utente di TS) non verrà più aggiornato automaticamente, maintenance work from 22:00 of 31/10/2013",
"it": "su SP135(AL) tra Cervari e SP137-Costigliola test di integrazione --> questo evento (simulato come scritto da utente di TS) non verrà più aggiornato automaticamente, lavori di manutenzione dalle 22:00 del 31/10/2013"
}