JSON Struktur der Reporte

Zuletzt geändert von YellowFox_RD am 2025/01/20 15:36

Inhaltsverzeichnis

 

Fahrstilanalyse

JSON Struktur mit Kommentaren
{
"drivers": [
{
"name": "Max Muster" // Fahrername
"employee_number": "123456",   // MA-Nummer
"driver_keys": ["DF00012345678000"], // Array genutzter Fahrerschlüssel
"rating_profiles": ["Mein Profil"], // Array genutzter Bewertungsprofile
"driving_time": 26902, // Fahrzeit in Sekunden
"distance": 217, // gefahrene Distanz in KM
"operation_start": "12.05.2024 23:24",              // Start der ersten bewerteten Fahrt im Auswertungszeitraum
"operation_end": "13.05.2024 09:46", // Endzeitpunkt der letzten bewerteten Fahrt im Auswertungszeitraum
"count_evaluated_trips": 26, // Anzahl bewerteter Fahrten
"vehicles": ["FTL-YF 100"],                         // Array genutzter Fahrzeuge
"fms_info": [{"vehicle":"FTL-YF 100","avg_used_fuel":26.1,"distance":241}], // genutzte Fahrzeuge mit FMS/CANBus Werten (Durchschnittlicher Verbrauch l/100km, Distanz in KM)
"grades":
{
"main_grade": 9.4, // Gesamtnote
"main_critical_grade": 9.4, // Gesamtnote Verstöße
"main_economic_grade": 9.6,                     // Gesamtnote Wirtschaftlichkeit
"main_difficulty_grade": 8.8,                   // Gesamtnote Tourenschwierigkeit
"sub_critical_grades":
{
"overspeed": 10,                            // Unternote Geschwindigkeitsvorgaben eingehalten
"brake": 9,                                 // Unternote Bremsverhalten
"speedup": 10,                              // Unternote Beschleunigungsverhalten
"curves": 9.2,                              // Unternote Kurvenfahrten
"foresight_driving": null                   // Unternote Vorausschauendes Fahren
}
,"sub_economic_grades":
{
"idle": 10, // Unternote effiziente Fahrzeugbewegung/Stillstand
"avg_speed": 6.3, // Unternote effiziente Geschwindigkeit
"wearfree_brake": null, // Unternote verschleißfreies Bremsen
"cruisecontrol": 10                         // Unternote effiziente Tempomatnutzung
}
,"sub_difficulty_grades":
{
"altitude": 1.5, // Unternote Höhenprofil
"street_type": 6.9, // Unternote Straßentyp
"count_stopps": 10 // Unternote Fahrtunterbrechungen
}
},
"critical_events": [
{
"start_time": "2024-05-13 00:18:32", // Startzeitpunkt des Verstoßes
"vehicle": "FTL-YF 100", // Fahrzeugkennzeichen
"start_pos": "D-01234 Neustadt, Hauptstra\u00dfe 15", // Adresse vom Beginn des Verstoßes
"type": "CURVE", // Verstoßtyp [SPEEDUP,BRAKE,CURVE,OVERSPEED]
"treshold_1": 0.18, // Definierter Grenzwert 1
"treshold_2": null,                         // Definierter Grenzwert 2
"value_1": 0.22,                            // maximal gemessener Wert 1 im Verstoßzeitraum
"value_2": null                             // maximal gemessener Wert 2 im Verstoßzeitraum
}
]
}

Critical Events

Je nach "type" sind die Felder "treshold_1","treshold_1","value_1","value_1" mit unterschiedlichen Werten und Einheiten belegt.
SPEEDUP

  • "treshold_1": definierter Grenzwert für Beschleunigung in m/s²
  • "value_1": gemessene maximal Beschleunigung im m/s²

BRAKE

  • "treshold_1": definierter Grenzwert für Bremsungen in m/s²
  • "value_1": gemessene maximal Bremsung im m/s²

CURVE

  • "treshold_1": definierter Grenzwert für Kurvenfahrten in g-Kraft
  • "value_1": gemessene maximale g-Kraft

OVERSPEED

  • "treshold_1": definierter Grenzwert in km/h
  • "treshold_2": definierter Grenzwert für mind. Dauer bevor Verstoß ermittelt wird
  • "value_1": Dauer der Übergeschwindigkeit
  • "value_2": gemessene maximale km/h

JSON Beispiel
{
"drivers": [
{
"name": "Max Muster",
"employee_number": "123456",
"driver_keys": ["DF00012345678000"],
"rating_profiles": ["Mein Profil"],
"driving_time": 26902,
"distance": 241,
"operation_start": "12.05.2024 23:24",
"operation_end": "13.05.2024 09:46",
"count_evaluated_trips": 26,
"vehicles": ["FTL-YF 100"],
"fms_info": [{"vehicle":"FTL-YF 100","avg_used_fuel":26.1,"distance":241}],
"grades":
{
"main_grade": 9.4,
"main_critical_grade": 9.4,
"main_economic_grade": 9.6,
"main_difficulty_grade": 8.8,
"sub_critical_grades":
{
"overspeed": 10,
"brake": 9,
"speedup": 10,
"curves": 9.2,
"foresight_driving": null
}
,"sub_economic_grades":
{
"idle": 10,
"avg_speed": 6.3,
"wearfree_brake": null,
"cruisecontrol": 10
}
,"sub_difficulty_grades":
{
"altitude": 1.5,
"street_type": 6.9,
"count_stopps": 10
}
},
"critical_events": [
{
"start_time": "2024-05-13 00:18:32",
"vehicle": "FTL-YF 100",
"start_pos": "Privatfahrt",
"type": "CURVE",
"treshold_1": 0.18,
"treshold_2": null,
"value_1": 0.22,
"value_2": null
}
,{
"start_time": "2024-05-13 08:20:08",
"vehicle": "FTL-YF 100",
"start_pos": "D-01234 Neustadt, Hauptstra\u00dfe 15",
"type": "BRAKE",
"treshold_1": 1.5,
"treshold_2": null,
"value_1": 1.54,
"value_2": null
}
,{
"start_time": "2024-05-13 08:33:12",
"vehicle": "FTL-YF 100",
"start_pos": "D-01234 Neustadt, Hauptstra\u00dfe 15",
"type": "CURVE",
"treshold_1": 0.18,
"treshold_2": null,
"value_1": 0.19,
"value_2": null
}
,{
"start_time": "2024-05-13 08:38:44",
"vehicle": "FTL-YF 100",
"start_pos": "D-01234 Neustadt, Hauptstra\u00dfe 15",
"type": "CURVE",
"treshold_1": 0.18,
"treshold_2": null,
"value_1": 0.22,
"value_2": null
}
,{
"start_time": "2024-05-13 08:48:32",
"vehicle": "FTL-YF 100",
"start_pos": "D-01234 Neustadt, Hauptstra\u00dfe 15",
"type": "BRAKE",
"treshold_1": 1.5,
"treshold_2": null,
"value_1": 1.54,
"value_2": null
}
]
}
,{
"name": "Maxi Musterfrau",
"employee_number": "54321",
"driver_keys": ["DF000987654321002"],
"rating_profiles": ["Mein Profil"],
"driving_time": 47180,
"distance": 412,
"operation_start": "08.05.2024 11:58",
           "operation_end": "14.05.2024 13:20",
"count_evaluated_trips": 121,
"vehicles": ["FTL-YF 150"],
"fms_info": [{"vehicle":"FTL-YF 150","avg_used_fuel":24.8,"distance":412}],
"grades":
{
"main_grade": 9.4,
"main_critical_grade": 9.9,
"main_economic_grade": 9.4,
"main_difficulty_grade": 8.4,
"sub_critical_grades":
{
"overspeed": 10,
"brake": 9.6,
"speedup": 10,
"curves": 10,
"foresight_driving": null
}
,"sub_economic_grades":
{
"idle": 9.5,
"avg_speed": 8.7,
"wearfree_brake": null,
"cruisecontrol": 10
}
,"sub_difficulty_grades":
{
"altitude": 1.3,
"street_type": 7.3,
"count_stopps": 9.8
}
},
"critical_events": [
{
"start_time": "2024-05-10 18:10:42",
"vehicle": "FTL-YF 150",
"start_pos": "D-01234 Neustadt, Hauptstra\u00dfe 15",
"type": "BRAKE",
"treshold_1": 1.5,
"treshold_2": null,
"value_1": 1.87,
"value_2": null
}
,{
"start_time": "2024-05-13 13:06:12",
"vehicle": "FTL-YF 150",
"start_pos": "Privatfahrt",
"type": "BRAKE",
"treshold_1": 1.5,
"treshold_2": null,
"value_1": 1.77,
"value_2": null
}
,{
"start_time": "2024-05-13 16:26:48",
"vehicle": "FTL-YF 150",
"start_pos": "Privatfahrt",
"type": "BRAKE",
"treshold_1": 1.5,
"treshold_2": null,
"value_1": 1.57,
"value_2": null
}
]
       }
]
}