added ApiWorldType, get_world, 4.3.0

Author: thatzok

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "the-bus-telemetry"
-version = "4.1.0"
+version = "4.3.0"
 edition = "2024"
 description = "Library for handling data exchange with the api (called telemetry) of the simulation software The Bus"
 license = "MIT"
@@ -10,4 +10,4 @@ repository = "https://github.com/thatzok/TheBusTelemetry"
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
 reqwest = { version = "0.12", features = ["json","blocking"] }
-komsi = "1.0"
+komsi = "1.1"

src/api.rs

@@ -50,6 +50,20 @@ impl RequestConfig {
     }
 }
 
+#[derive(Deserialize, Debug, PartialEq)]
+pub struct ApiWorldType {
+    #[serde(rename = "LevelName")]
+    pub level_name: String,
+    #[serde(rename = "DateTime")]
+    pub date_time: String,
+    #[serde(rename = "TimeFactor")]
+    pub time_factor: f32,
+    #[serde(rename = "BaseLatitude")]
+    pub base_latitude: f64,
+    #[serde(rename = "BaseLongitude")]
+    pub base_longitude: f64,
+}
+
 #[derive(Deserialize, Debug, PartialEq)]
 pub struct ApiVehicleType {
     #[serde(rename = "ActorName")]
@@ -82,9 +96,17 @@ pub struct ApiVehicleType {
 
 #[derive(Deserialize, Debug, PartialEq)]
 pub struct ApiLamps {
-    #[serde(rename = "LightHeadlight", alias = "LightHeadlight1", alias="Light Headlight")]
+    #[serde(
+        rename = "LightHeadlight",
+        alias = "LightHeadlight1",
+        alias = "Light Headlight"
+    )]
     pub light_main: f32,
-    #[serde(rename = "LightTraveling", alias = "LightTraveling1", alias="Light Travelling")]
+    #[serde(
+        rename = "LightTraveling",
+        alias = "LightTraveling1",
+        alias = "Light Travelling"
+    )]
     pub traveller_light: f32,
     #[serde(rename = "Door Button 1", alias = "ButtonLight Door 1", default)]
     pub front_door_light: f32,
@@ -260,6 +282,26 @@ pub async fn get_vehicle(
     Ok(api_vehicle)
 }
 
+pub async fn get_world(config: &RequestConfig) -> Result<ApiWorldType, Box<dyn std::error::Error>> {
+    let path = "world";
+
+    if config.debugging {
+        println!("get_world path: {}", path);
+    }
+
+    let body = get_telemetry_data(&config, &path).await?;
+
+    let api_world: ApiWorldType = serde_json::from_value(body).map_err(|e| {
+        eprintln!("Failed to parse API response as World JSON: {}", e);
+        Box::new(e) as Box<dyn std::error::Error>
+    })?;
+
+    if config.debugging {
+        println!("{:?}", &api_world);
+    }
+    Ok(api_world)
+}
+
 pub fn get_button_by_name(data: &serde_json::Value, name: &str) -> String {
     let ret = data
         .get("Buttons")

tests/json/world.json

@@ -0,0 +1,17 @@
+{
+  "LevelName": "Castrop",
+  "IsInMainMenu": "false",
+  "DateTime": "2026-01-01T09:43:48",
+  "NightLightEnabled": "false",
+  "TimeFactor": 1.0,
+  "BaseLatitude": 51.549339,
+  "BaseLongitude": 7.308765,
+  "Temperature": -7.083445,
+  "Wetness": 0.0,
+  "RainIntensity": 0.0,
+  "SnowIntensity": 0.0,
+  "SnowPack": 1.0,
+  "CloudIntensity": 0.0,
+  "NebularIntensity": 0.5,
+  "WindIntensity": 0.4
+}

tests/json_deserialization_test.rs

@@ -1,7 +1,9 @@
 use std::fs;
 use std::path::Path;
-use the_bus_telemetry::api::ApiVehicleType;
+use the_bus_telemetry::api::{ApiVehicleType, ApiWorldType};
 use serde_json;
+use komsi::komsi::KomsiDateTime;
+
 
 #[test]
 fn test_json_deserialization_from_files() {
@@ -14,6 +16,30 @@ fn test_json_deserialization_from_files() {
     test_vehicle_deserialization("tests/json/Solaris_Urbino.txt", "BP_Solaris_Urbino_18m_3D_C_2146245266");
     test_vehicle_deserialization("tests/json/vdl_citea.json", "BP_VDL_Citea_LLE_120_2D_C_2147124848");
 
+    test_world_deserialization("tests/json/world.json");
+}
+
+fn test_world_deserialization(file_path: &str) {
+    let file = Path::new(file_path);
+    let json = fs::read_to_string(file)
+        .expect(&format!("Failed to read {}", file_path));
+
+    let world: ApiWorldType = serde_json::from_str(&json)
+        .expect(&format!("Failed to deserialize {}", file_path));
+
+    assert_eq!(world.level_name, "Castrop");
+    assert_eq!(world.date_time, "2026-01-01T09:43:48");
+    assert!(world.time_factor > 0.0);
+
+    let date_time = KomsiDateTime::from_iso(&world.date_time).unwrap();
+    assert_eq!(date_time.year, 2026);
+    assert_eq!(date_time.month, 1);
+    assert_eq!(date_time.day, 1);
+    assert_eq!(date_time.hour, 9);
+    assert_eq!(date_time.min, 43);
+    assert_eq!(date_time.sec, 48);
+
+    println!("Successfully deserialized world: {}", world.level_name);
 }
 
 fn test_vehicle_deserialization(file_path: &str, actor_name: &str) {