Update viewport doc (#3568)

https://mapbox.atlassian.net/browse/MAPSIOS-1798

Users tend to directly call methods that are not indended for that

cc @mapbox/sdk-ci

GitOrigin-RevId: 292073e79d0c58d133e4fb5ed16737224ab0a406

Author: persidskiy

sdk-base/src/main/java/com/mapbox/maps/plugin/viewport/state/ViewportState.kt

@@ -55,6 +55,8 @@ interface ViewportState {
    * Indicates the current [ViewportState] is now responsible for updating the camera.
    *
    * [ViewportPlugin] calls this method at the end of a successful transition into this state.
+   *
+   * @warning Don't call this method directly, instead activate the viewport via [ViewportPlugin.transitionTo].
    */
   fun startUpdatingCamera()
 
@@ -65,6 +67,8 @@ interface ViewportState {
    *
    * Implementations must stop updating the camera immediately and should typically cancel any ongoing
    * animations that they started when this method is invoked.
+   *
+   * @warning Don't call this method directly. Instead, use [ViewportPlugin.idle] to stop animations in progress.
    */
   fun stopUpdatingCamera()
 }