Getting a single traffic event

Given an event ID, the endpoint returns the event’s DATEX II description.

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:

Request

GET 

https://<HOST_IP_ADDRESS>:<PORT_NUMBER>/datex2import/optima/event/get

Request resource

Not applicable

Request parameters

Parameter Required Description

eventId

YES

Unique ID of the event.

All situation records must be unique across all situations.

Request content-type

Not applicable

Request body (payload)

Not applicable

Response status

HTTP status Description

200 OK

Result of the processed request.

204 No content

Returned if the specified ID does not exist.

Response content-type

application/json

Response output

JSON message that describes a traffic event as defined by the DATEX II format.

Request

https://<HOST_IP_ADDRESS>:<PORT_NUMBER>/datex2import/optima/event/get?eventId=METRO_556_2.1&session=88b06e8d9c2a21690ee6eb948ec7b708

Response status

200

Response output

{
  "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
        }
      ]
    }
  ]
}