Road cameras annotation service (#9098)

* Road cameras annotation service (#9098)

* Road cameras from Directions API wip

* Road cameras API WIP

* clean out

* Extract speed from Directions response

* Fixing tests for Road Cameras V2, WIP

* Add validation. Fix tests. Add new tests.

* Clean out and refactor road cameras module.

* Add comment regarding config validation

* Remove config validation exception test

* Fix tests

* Add activeGuidanceInfo to MapboxRoadCamera. Fix tests.

* Add changelog

* Add changelog to Dash app

* Remove old cameras preview logic. Fix cameras config in Dash

* Fix detekt

* Update api dump

* Refactor roadcam manager fun names

* Refactor RoadCamerasManager. Split FD, AG and Preview use cases into separate classes.

* Add java doc to explain difference between all the RoadCamerasProvider

* Clean out after refactoring

* Fix lint formatting

* Code review fixes

* Use count instead of building new list

* Lint fixes

* Remove check for InterruptedException

* Refactor awaitCancellation() by suspendCancellableCoroutine + invokeOnCancellation

* Code review fixes

* Split startCameras function logic into smaller functions

* Review fixes

* Update projects/mapbox-navigation-android-internal/roadcam/src/main/java/com/mapbox/roadcam/internal/RouteRoadCamerasParseUtils.kt

Co-authored-by: Copilot <[email protected]>

* Update projects/mapbox-navigation-android-internal/mapbox-navigation-android/changelog/unreleased/features/9098.md

Co-authored-by: Copilot <[email protected]>

* Update projects/mapbox-navigation-android-internal/roadcam-ui/src/main/java/com/mapbox/roadcam/ui/internal/RoadCamerasMapControllerImpl.kt

Co-authored-by: Copilot <[email protected]>

* Retrieve road cameras from unrecognizedJsonProperties

* Refactor calculateGeometryIndexAtDistance fun

* Add comment regarding lastCameras usage across all cameras providers

* Rethrow calcellation exception

* Hardcode road cam module version to latest one which works without RCAS

* Fix test with proper onHidden callback

* Fix detekt

---------

Co-authored-by: Copilot <[email protected]>

* Revert mapboxRoadCam hardcoded version.

---------

Co-authored-by: Copilot <[email protected]>
GitOrigin-RevId: 23667ed1379512b17e40015c9d41baec026ab389

Author: 2 people

changelog/unreleased/features/9098.md

@@ -0,0 +1,2 @@
+- `RoadCamerasManager` in active guidance now relies on new `road_camera` Directions API annotation, which improves the performance of the camera data retrieval and quality of the data.
+- Added `MapboxRoadCamera::activeGuidanceInfo`, containing information about the route id, leg index, geometry index and step intersection of the camera in active guidance.