👍
Die Bahntelematik-Schnittstelle verwendet jetzt ein einheitliches Nachrichtenformat mit standardisierten Informationen wie der UIC-Wagennummer im Header.

Betroffene Event-Typen

Das neue Format gilt für folgende Event-Typen über AWS SNS:

Event-Typ	Beschreibung
TRAIN_UPDATE_RECEIVED	Zuginformationen und Wagenposition im Zug
RESOURCE_POSITION_RECEIVED	GPS-Position des Wagens
SENSOR_VALUE_TEMPERATURE_RECEIVED	Temperaturdaten vom Sensor
SHOCK_DETECTION_RECEIVED	Schockerkennung / Erschütterungen

Nachrichtenformat

Grundstruktur

Jede Nachricht besteht aus einem Header und einem Payload:

{
  "header": {
    // Standardisierte Informationen
  },
  "payload": {
    // Event-spezifische Daten
  }
}

Header (Standardisiert)

Der Header enthält:

Feld	Beschreibung	Beispiel
eventType	Art der Nachricht	"TRAIN_UPDATE_RECEIVED"
timestamp	Zeitstempel (ISO 8601)	"2025-09-01T09:22:09.000Z"
identifier	UIC-Wagennummer	"33 80 2742 528-3"

Payload (Event-spezifisch)

Der Payload-Bereich bleibt unverändert und enthält die event-spezifischen Daten.

Beispiele

Beispiel 1: Zuginformation (TRAIN_UPDATE_RECEIVED)

{
"header": {
  "eventType": "TRAIN_UPDATE_RECEIVED",
  "timestamp": "2025-09-01T09:22:09.000Z",
  "identifier": "33 80 2742 528-3"
},
"payload": {
  "trainNumber": "63200",
  "relativePosition": 73
}
}

Bedeutung


UIC-Wagennummer	33 80 2742 528-3
Befindet sich in Zug Nummer	63200
An Position	73 (relative Position im Zug)

Beispiel 2: GPS-Position (RESOURCE_POSITION_RECEIVED)

{
  "header": {
    "eventType": "RESOURCE_POSITION_RECEIVED",
    "timestamp": "2025-01-05T18:11:58.000Z",
    "identifier": "33 80 274 2 214-0"
  },
  "payload": {
    "ITSS_TransportDeviceID": "33 80 274 2 214-0",
    "ITSS_GeofenceEventList": [
      {
        "UTCtimestamp": 1767707518,
        "ITSS_Geofence": {
          "GeofenceID": "82af5e51-e4f4-4fd5-a95f-9b5dc61d2581",
          "GeofenceName": "Braunschweig Hgbf",
          "LEO_GeofenceAdditionDescription": ""
        },
        "ITSS_GeofenceEventTrigger": "enter",
        "GNSS_Position": {
          "GNSS_UTCtimestamp": 1767707518,
          "GNSS_Latitude": 52.248946,
          "GNSS_Longitude": 10.552375
        }
      }
    ]
  }
}

Bedeutung


UIC-Wagennummer	33 80 274 2 214-0
Geofence-Event	Einfahrt in Braunschweig Hgf
GPS-Position bei Einfahrt	Breitengrad: 52.248946, Längengrad: 10.552375
Geofence-ID	82af5e51-e4f4-4fd5-a95f-9b5dc61d2581
Zeitpunkt (UTC)	1767707518 (Unix Timestamp)

Beispiel 3: Temperaturmessung (SENSOR_VALUE_TEMPERATURE_RECEIVED)

{
  "header": {
    "eventType": "SENSOR_VALUE_TEMPERATURE_RECEIVED",
    "timestamp": "2025-01-05T14:48:02.000Z",
    "identifier": "33 80 2742 652-1"
  },
  "payload": {
    "ITSS_TransportDeviceID": "33 80 2742 652-1",
    "ITSS_TelematicsDeviceID": "1077-012265",
    "ITSS_SensorValueList": [
      {
        "SamplingUTCTimestamp": 1767694882,
        "Value": 267.9781,
        "LEO_Celsius": -5.17,
        "LEO_Fahrenheit": 22.69,
        "ITSS_SensorType": "temperature",
        "ITSS_SensorPosition": "waggon"
      }
    ],
    "ITSS_GeofenceEventList": [
      {
        "GNSS_Position": {
          "GNSS_UTCtimestamp": null
        }
      }
    ]
  }
}

Bedeutung


UIC-Wagennummer	33 80 2742 652-1
Telematik-Gerät	1077-012265
Gemessene Temperatur	`-5,17°C` / `22,69°F` / `267,98 K`
Sensor-Typ	temperature
Sensor-Position	waggon
Messzeitpunkt (UTC)	1767694882` (Unix Timestamp)

Beispiel 4: Schockerkennung (SHOCK_DETECTION_RECEIVED)

{
  "header": {
    "eventType": "SHOCK_DETECTION_RECEIVED",
    "timestamp": "2025-01-05T14:29:19.000Z",
    "identifier": "42 80 2468 212-5"
  },
  "payload": {
    "ITSS_TransportDeviceID": "428024682125",
    "ITSS_TelematicsDeviceID": "urn:epc:id:giai:426055689.016040908368414511",
    "UTCtimestamp": 1767694159,
    "GNSS_Position": {
      "GNSS_UTCtimestamp": 1767694159,
      "GNSS_Latitude": 52.42054,
      "GNSS_Longitude": 9.669214444444444,
      "GNSS_Speed_kmph": null,
      "GNSS_Heading_deg": 360,
      "LEO_Geofences": [
        {
          "GeofenceID": "ef805545-86f4-423e-a6c3-4db1583c5315",
          "GeofenceName": "VW Hannover",
          "LEO_GeofenceAdditionDescription": "",
          "LEO_GeofenceType": "RAIL",
          "LEO_GeofenceCategory": "LOCATION"
        }
      ]
    },
    "X-Axis_triggered": false,
    "Y-Axis_triggered": true,
    "Z-Axis_triggered": false,
    "X-Axis": 1461.43,
    "Y-Axis": 2462.4,
    "Z-Axis": 2542.48
  }
}

Bedeutung


UIC-Wagennummer	42 80 2468 212-5
Telematik-Gerät	urn:epc:id:giai:426055689.016040908368414511
Schockerkennung auf Y-Achse ausgelöst	(seitliche Erschütterung)
Beschleunigungswert - X-Achse	1461.43` (nicht ausgelöst)
Beschleunigungswert - Y-Achse	2462.4` (ausgelöst)
Beschleunigungswert - Z-Achse	2542.48` (nicht ausgelöst)
GPS-Position - Breitengrad	52.42054
GPS-Position - Längengrad	9.669214
Geofence	VW Hannover (Typ: RAIL, Kategorie: LOCATION)
Zeitpunkt (UTC)	1767694159 (Unix Timestamp)

👍
Bei Fragen zur neuen Schnittstellenstruktur wenden Sie sich bitte an Ihr Ansprechpartner-Team.