feat: add typescript animateCamera methods and types

Author: kota113

src/auto/useNavigationAuto.ts

@@ -370,6 +370,20 @@ export const useNavigationAuto = (): UseNavigationAutoResult => {
         return NavAutoModule.moveCamera(cameraPosition);
       },
 
+      // set default values to transition similar to Google Maps app
+      animateCamera: (
+        cameraPosition: CameraPosition,
+        duration?: number | null
+      ) => {
+        return NavAutoModule.animateCamera(
+          {
+            ...cameraPosition,
+            zoom: cameraPosition.zoom ?? 15,
+          },
+          duration === undefined ? 500 : duration
+        );
+      },
+
       setPadding: (padding: Padding) => {
         const { top = 0, left = 0, bottom = 0, right = 0 } = padding;
         return NavAutoModule.setMapPadding(top, left, bottom, right);

src/maps/mapView/mapView.tsx

@@ -52,7 +52,7 @@ export const MapView = (props: MapViewProps): React.JSX.Element => {
           target: props.initialCameraPosition?.target ?? null,
           bearing: props.initialCameraPosition?.bearing ?? 0.0,
           tilt: props.initialCameraPosition?.tilt ?? 0.0,
-          zoom: props.initialCameraPosition?.zoom ?? 0.0,
+          zoom: props.initialCameraPosition?.zoom ?? 15,
         },
       }),
     };

src/maps/mapView/mapViewController.ts

@@ -16,7 +16,7 @@
 
 import NavViewModule from '../../native/NativeNavViewModule';
 import { processColorValue, colorIntToRGBA } from '../../shared';
-import type { Location } from '../../shared/types';
+import type { Location } from '../../shared';
 import type {
   CameraPosition,
   Circle,
@@ -195,6 +195,21 @@ export const getMapViewController = (nativeID: string): MapViewController => {
       return await NavViewModule.moveCamera(nativeID, cameraPosition);
     },
 
+    animateCamera: async (
+      cameraPosition: CameraPosition,
+      duration?: number | null
+    ) => {
+      // set default values to transition similar to Google Maps app
+      return await NavViewModule.animateCamera(
+        nativeID,
+        {
+          ...cameraPosition,
+          zoom: cameraPosition.zoom ?? 15,
+        },
+        duration === undefined ? 500 : duration
+      );
+    },
+
     setPadding: async _padding => {
       console.warn('setPadding should be set via props in new architecture');
     },

src/maps/mapView/types.ts

@@ -376,7 +376,19 @@ export interface MapViewController {
    *
    * @param cameraPosition - Defines the position the camera will take with the move.
    */
-  moveCamera(cameraPosition: CameraPosition): void;
+  moveCamera(cameraPosition: CameraPosition): Promise<void>;
+
+  /**
+   * Animate the camera to a new position based on the object given.
+   *
+   * @param cameraPosition - Defines the position the camera will animate to.
+   * @param duration - Animation duration in milliseconds. Defaults to 500 ms when undefined.
+   * Pass null to use the native SDK's default animation duration.
+   */
+  animateCamera(
+    cameraPosition: CameraPosition,
+    duration?: number | null
+  ): Promise<void>;
 
   /**
    * Sets padding to the map.

src/native/NativeNavAutoModule.ts

@@ -138,6 +138,10 @@ export interface Spec extends TurboModule {
   addPolygon(options: PolygonOptionsSpec): Promise<Polygon>;
   addGroundOverlay(options: GroundOverlayOptionsSpec): Promise<GroundOverlay>;
   moveCamera(cameraPosition: CameraPositionSpec): Promise<void>;
+  animateCamera(
+    cameraPosition: CameraPositionSpec,
+    duration?: WithDefault<Double, null>
+  ): Promise<void>;
   removeMarker(id: string): Promise<boolean>;
   removePolyline(id: string): Promise<boolean>;
   removePolygon(id: string): Promise<boolean>;

src/native/NativeNavViewModule.ts

@@ -148,6 +148,11 @@ export interface Spec extends TurboModule {
     nativeID: string,
     cameraPosition: CameraPositionSpec
   ): Promise<void>;
+  animateCamera(
+    nativeID: string,
+    cameraPosition: CameraPositionSpec,
+    duration?: WithDefault<Double, null>
+  ): Promise<void>;
   getCameraPosition(nativeID: string): Promise<CameraPosition>;
   getMyLocation(nativeID: string): Promise<Location>;
   getUiSettings(nativeID: string): Promise<UISettings>;