feat: Adding map model reference in ScenarioInfo

include/MantleAPI/Execution/i_environment.h

@@ -48,10 +48,11 @@ public:
 
   /// Load a map file and parse it into the memory.
   ///
-  /// @param map_file_path  map file path from the scenario file. If this path is not resolved by the engine, the
-  ///                       environment must do so.
-  /// @param map_details    Area of the map
-  virtual void CreateMap(const std::string& map_file_path, const mantle_api::MapDetails& map_details) = 0;
+  /// @param map_file_path        map file path from the scenario file. If this path is not resolved by the engine, the
+  ///                             environment must do so.
+  /// @param map_details          Area of the map
+  /// @param map_model_reference  File path of a 3D model representing the virtual environment
+  virtual void CreateMap(const std::string& map_file_path, const mantle_api::MapDetails& map_details, const std::string& map_model_reference) = 0;
 
   /// Assigns an entity to the specified controller. This controller needs to be created beforehand.
   ///

include/MantleAPI/Execution/scenario_info.h

@@ -37,7 +37,8 @@ struct ScenarioInfo
         description{other.description},
         full_map_path{other.full_map_path},
         map_details{other.map_details->Clone()},
-        additional_information{other.additional_information}
+        additional_information{other.additional_information},
+        map_model_reference{other.map_model_reference}
   {
   }
 
@@ -57,6 +58,7 @@ struct ScenarioInfo
       full_map_path = other.full_map_path;
       map_details = other.map_details->Clone();
       additional_information = other.additional_information;
+      map_model_reference = other.map_model_reference;
     }
     return *this;
   }
@@ -78,6 +80,8 @@ struct ScenarioInfo
   std::unique_ptr<MapDetails> map_details{std::make_unique<MapDetails>()};
   /// Additional custom information about the scenario
   std::map<std::string, std::string> additional_information;
+  /// Model reference of ground truth
+  std::string map_model_reference;
 };
 
 }  // namespace mantle_api

test/MantleAPI/Test/test_utils.h

@@ -503,7 +503,7 @@ class MockEnvironment : public mantle_api::IEnvironment
 public:
   MOCK_METHOD(void,
               CreateMap,
-              (const std::string& file_path, const mantle_api::MapDetails& map_details),
+              (const std::string& file_path, const mantle_api::MapDetails& map_details, const std::string& map_model_reference),
               (override)
 
   );

test/interface_test.cpp

@@ -28,7 +28,7 @@ TEST(InterfaceTest, GivenTeleportAction_When_ThenHostVehicleIsPlaced)
   mantle_api::Position inert_pos{};
   inert_pos = mantle_api::OpenDriveRoadPosition{"0", 0_m, 0_m};
   mantle_api::MockEnvironment env{};
-  env.CreateMap("dummy_map_path", {});
+  env.CreateMap("dummy_map_path", {}, "");
 
   mantle_api::VehicleProperties vehicle_properties;
   vehicle_properties.is_host = true;