expo-gaode-map 2.2.30-next.0 → 2.2.30

package/build/types/route-playback.types.d.ts

@@ -0,0 +1,118 @@
+import type { NativeSyntheticEvent } from 'react-native';
+import type { LatLng, LatLngBounds, LatLngPoint, Point } from './common.types';
+import type { MarkerProps, PolygonProps, PolylineProps } from './overlays.types';
+export interface RouteBounds {
+    center: LatLng;
+    bounds: {
+        north: number;
+        south: number;
+        east: number;
+        west: number;
+    };
+    span: {
+        latitudeDelta: number;
+        longitudeDelta: number;
+    };
+    recommendedZoom: number;
+}
+export interface FitToCoordinatesOptions {
+    duration?: number;
+    paddingFactor?: number;
+    minZoom?: number;
+    maxZoom?: number;
+    singlePointZoom?: number;
+    bearing?: number;
+    tilt?: number;
+    preserveBearing?: boolean;
+    preserveTilt?: boolean;
+}
+export interface SmoothMoveProgressEvent {
+    position: LatLng;
+    angle: number;
+    progress: number;
+    distance: number;
+    totalDistance: number;
+}
+export interface SmoothMoveEndEvent {
+    position: LatLng;
+    angle: number;
+    totalDistance: number;
+}
+export interface RoutePlaybackOptions {
+    durationSeconds?: number;
+    minDurationSeconds?: number;
+    speedMultiplier?: number;
+    baseSpeedMps?: number;
+    updateIntervalMs?: number;
+    followCamera?: boolean;
+    followZoom?: number;
+    bearingSmoothing?: number;
+    lookAheadDistanceMeters?: number;
+    simplificationTolerance?: number;
+    autoFit?: boolean;
+    fitOptions?: FitToCoordinatesOptions;
+    onProgress?: (state: RoutePlaybackState) => void;
+    onComplete?: (state: RoutePlaybackState) => void;
+}
+export interface RoutePlaybackState {
+    isPlaying: boolean;
+    isPaused: boolean;
+    progress: number;
+    currentPosition: LatLng | null;
+    currentAngle: number;
+    totalDistance: number;
+    traveledDistance: number;
+    durationSeconds: number;
+    smoothMovePath?: LatLng[];
+    smoothMoveDuration?: number;
+}
+export interface RoutePlaybackController extends RoutePlaybackState {
+    start(): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    seek(progress: number): void;
+    setSpeedMultiplier(multiplier: number): void;
+}
+export interface RouteOverlayProps {
+    points: LatLngPoint[];
+    showStartMarker?: boolean;
+    showEndMarker?: boolean;
+    polylineProps?: Omit<PolylineProps, 'points'>;
+    startMarkerProps?: Omit<MarkerProps, 'position'>;
+    endMarkerProps?: Omit<MarkerProps, 'position'>;
+}
+export interface AreaMaskOverlayProps {
+    rings: LatLngPoint[][] | string;
+    polygonProps?: Omit<PolygonProps, 'points'>;
+}
+export interface MultiRingPolyline {
+    rings: LatLng[][];
+    bounds: LatLngBounds | null;
+}
+export type SmoothMoveProgressEventHandler = (event: NativeSyntheticEvent<SmoothMoveProgressEvent>) => void;
+export type SmoothMoveEndEventHandler = (event: NativeSyntheticEvent<SmoothMoveEndEvent>) => void;
+export interface FitToCoordinatesTarget {
+    moveCamera(position: {
+        target?: LatLng;
+        zoom?: number;
+        bearing?: number;
+        tilt?: number;
+    }, duration?: number): Promise<void>;
+    getCameraPosition(): Promise<{
+        target?: LatLng;
+        zoom?: number;
+        bearing?: number;
+        tilt?: number;
+    }>;
+}
+export interface EdgePadding {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+export interface CoordinateScreenProjector {
+    getLatLng(point: Point): Promise<LatLng>;
+}
+//# sourceMappingURL=route-playback.types.d.ts.map

package/build/types/route-playback.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-playback.types.d.ts","sourceRoot":"","sources":["../../src/types/route-playback.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,IAAI,EAAE;QACJ,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC9C,gBAAgB,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACjD,cAAc,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,EAAE,EAAE,GAAG,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IAClB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,8BAA8B,GAAG,CAC3C,KAAK,EAAE,oBAAoB,CAAC,uBAAuB,CAAC,KACjD,IAAI,CAAC;AAEV,MAAM,MAAM,yBAAyB,GAAG,CACtC,KAAK,EAAE,oBAAoB,CAAC,kBAAkB,CAAC,KAC5C,IAAI,CAAC;AAEV,MAAM,WAAW,sBAAsB;IACrC,UAAU,CACR,QAAQ,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EACD,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,iBAAiB,IAAI,OAAO,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C"}

package/build/types/route-playback.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=route-playback.types.js.map

package/build/types/route-playback.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-playback.types.js","sourceRoot":"","sources":["../../src/types/route-playback.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { NativeSyntheticEvent } from 'react-native';\n\nimport type { LatLng, LatLngBounds, LatLngPoint, Point } from './common.types';\nimport type { MarkerProps, PolygonProps, PolylineProps } from './overlays.types';\n\nexport interface RouteBounds {\n  center: LatLng;\n  bounds: {\n    north: number;\n    south: number;\n    east: number;\n    west: number;\n  };\n  span: {\n    latitudeDelta: number;\n    longitudeDelta: number;\n  };\n  recommendedZoom: number;\n}\n\nexport interface FitToCoordinatesOptions {\n  duration?: number;\n  paddingFactor?: number;\n  minZoom?: number;\n  maxZoom?: number;\n  singlePointZoom?: number;\n  bearing?: number;\n  tilt?: number;\n  preserveBearing?: boolean;\n  preserveTilt?: boolean;\n}\n\nexport interface SmoothMoveProgressEvent {\n  position: LatLng;\n  angle: number;\n  progress: number;\n  distance: number;\n  totalDistance: number;\n}\n\nexport interface SmoothMoveEndEvent {\n  position: LatLng;\n  angle: number;\n  totalDistance: number;\n}\n\nexport interface RoutePlaybackOptions {\n  durationSeconds?: number;\n  minDurationSeconds?: number;\n  speedMultiplier?: number;\n  baseSpeedMps?: number;\n  updateIntervalMs?: number;\n  followCamera?: boolean;\n  followZoom?: number;\n  bearingSmoothing?: number;\n  lookAheadDistanceMeters?: number;\n  simplificationTolerance?: number;\n  autoFit?: boolean;\n  fitOptions?: FitToCoordinatesOptions;\n  onProgress?: (state: RoutePlaybackState) => void;\n  onComplete?: (state: RoutePlaybackState) => void;\n}\n\nexport interface RoutePlaybackState {\n  isPlaying: boolean;\n  isPaused: boolean;\n  progress: number;\n  currentPosition: LatLng | null;\n  currentAngle: number;\n  totalDistance: number;\n  traveledDistance: number;\n  durationSeconds: number;\n  smoothMovePath?: LatLng[];\n  smoothMoveDuration?: number;\n}\n\nexport interface RoutePlaybackController extends RoutePlaybackState {\n  start(): void;\n  pause(): void;\n  resume(): void;\n  stop(): void;\n  seek(progress: number): void;\n  setSpeedMultiplier(multiplier: number): void;\n}\n\nexport interface RouteOverlayProps {\n  points: LatLngPoint[];\n  showStartMarker?: boolean;\n  showEndMarker?: boolean;\n  polylineProps?: Omit<PolylineProps, 'points'>;\n  startMarkerProps?: Omit<MarkerProps, 'position'>;\n  endMarkerProps?: Omit<MarkerProps, 'position'>;\n}\n\nexport interface AreaMaskOverlayProps {\n  rings: LatLngPoint[][] | string;\n  polygonProps?: Omit<PolygonProps, 'points'>;\n}\n\nexport interface MultiRingPolyline {\n  rings: LatLng[][];\n  bounds: LatLngBounds | null;\n}\n\nexport type SmoothMoveProgressEventHandler = (\n  event: NativeSyntheticEvent<SmoothMoveProgressEvent>\n) => void;\n\nexport type SmoothMoveEndEventHandler = (\n  event: NativeSyntheticEvent<SmoothMoveEndEvent>\n) => void;\n\nexport interface FitToCoordinatesTarget {\n  moveCamera(\n    position: {\n      target?: LatLng;\n      zoom?: number;\n      bearing?: number;\n      tilt?: number;\n    },\n    duration?: number\n  ): Promise<void>;\n  getCameraPosition(): Promise<{\n    target?: LatLng;\n    zoom?: number;\n    bearing?: number;\n    tilt?: number;\n  }>;\n}\n\nexport interface EdgePadding {\n  top?: number;\n  right?: number;\n  bottom?: number;\n  left?: number;\n}\n\nexport interface CoordinateScreenProjector {\n  getLatLng(point: Point): Promise<LatLng>;\n}\n"]}

package/build/utils/RouteUtils.d.ts

@@ -0,0 +1,8 @@
+import type { LatLngBounds, LatLngPoint } from '../types/common.types';
+import type { FitToCoordinatesOptions, FitToCoordinatesTarget, MultiRingPolyline, RouteBounds } from '../types/route-playback.types';
+export declare function estimateZoomLevel(latitudeDelta: number, longitudeDelta: number, options?: Pick<FitToCoordinatesOptions, 'minZoom' | 'maxZoom'>): number;
+export declare function getRouteBounds(points: LatLngPoint[], options?: Pick<FitToCoordinatesOptions, 'paddingFactor' | 'minZoom' | 'maxZoom'>): RouteBounds | null;
+export declare function parseMultiRingPolyline(polyline: string): MultiRingPolyline;
+export declare function fitCameraToCoordinates(map: FitToCoordinatesTarget, points: LatLngPoint[], options?: FitToCoordinatesOptions): Promise<void>;
+export declare function buildLatLngBounds(points: LatLngPoint[]): LatLngBounds | null;
+//# sourceMappingURL=RouteUtils.d.ts.map

package/build/utils/RouteUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteUtils.d.ts","sourceRoot":"","sources":["../../src/utils/RouteUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,WAAW,EACZ,MAAM,+BAA+B,CAAC;AAQvC,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,SAAS,CAAM,GACjE,MAAM,CAQR;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,GAAE,IAAI,CAAC,uBAAuB,EAAE,eAAe,GAAG,SAAS,GAAG,SAAS,CAAM,GACnF,WAAW,GAAG,IAAI,CAmCpB;AAyBD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA0B1E;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,sBAAsB,EAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,GAAG,IAAI,CAgB5E"}

package/build/utils/RouteUtils.js

@@ -0,0 +1,140 @@
+import { normalizeLatLng, normalizeLatLngList } from './GeoUtils';
+const MIN_ZOOM = 3;
+const MAX_ZOOM = 20;
+const DEFAULT_SINGLE_POINT_ZOOM = 16;
+const DEFAULT_PADDING_FACTOR = 1.2;
+export function estimateZoomLevel(latitudeDelta, longitudeDelta, options = {}) {
+    // 使用经纬度跨度估算一个“足够看全路径”的缩放级别。
+    // 这是高层 TS 兜底逻辑，不依赖具体原生 SDK 的 fitBounds 能力。
+    const span = Math.max(latitudeDelta, longitudeDelta, 0.0001);
+    const rawZoom = Math.log2(360 / span);
+    const minZoom = options.minZoom ?? MIN_ZOOM;
+    const maxZoom = options.maxZoom ?? MAX_ZOOM;
+    return Math.max(minZoom, Math.min(maxZoom, Number(rawZoom.toFixed(2))));
+}
+export function getRouteBounds(points, options = {}) {
+    // 统一将路径点转换为对象坐标，再计算中心点、边界和推荐缩放。
+    const normalized = normalizeLatLngList(points);
+    if (normalized.length === 0) {
+        return null;
+    }
+    const latitudes = normalized.map((point) => point.latitude);
+    const longitudes = normalized.map((point) => point.longitude);
+    const north = Math.max(...latitudes);
+    const south = Math.min(...latitudes);
+    const east = Math.max(...longitudes);
+    const west = Math.min(...longitudes);
+    const paddingFactor = options.paddingFactor ?? DEFAULT_PADDING_FACTOR;
+    const latitudeDelta = Math.max((north - south) * paddingFactor, 0.0001);
+    const longitudeDelta = Math.max((east - west) * paddingFactor, 0.0001);
+    return {
+        center: {
+            latitude: (north + south) / 2,
+            longitude: (east + west) / 2,
+        },
+        bounds: {
+            north,
+            south,
+            east,
+            west,
+        },
+        span: {
+            latitudeDelta,
+            longitudeDelta,
+        },
+        recommendedZoom: estimateZoomLevel(latitudeDelta, longitudeDelta, options),
+    };
+}
+function parsePolylineRing(polyline) {
+    if (!polyline.trim()) {
+        return [];
+    }
+    return polyline
+        .split(';')
+        .map((segment) => segment.trim())
+        .filter(Boolean)
+        .map((segment) => {
+        const [longitude, latitude] = segment.split(',').map((value) => Number(value.trim()));
+        if (!Number.isFinite(longitude) || !Number.isFinite(latitude)) {
+            return null;
+        }
+        return {
+            latitude,
+            longitude,
+        };
+    })
+        .filter((point) => point !== null);
+}
+export function parseMultiRingPolyline(polyline) {
+    // 高德 AOI / 多边形边界常见格式为 ring1|ring2，
+    // 这里按“外环/内环”统一拆成二维坐标数组。
+    const rings = polyline
+        .split('|')
+        .map((ring) => parsePolylineRing(ring))
+        .filter((ring) => ring.length > 0);
+    const flattened = rings.flat();
+    const bounds = flattened.length
+        ? {
+            southwest: {
+                latitude: Math.min(...flattened.map((point) => point.latitude)),
+                longitude: Math.min(...flattened.map((point) => point.longitude)),
+            },
+            northeast: {
+                latitude: Math.max(...flattened.map((point) => point.latitude)),
+                longitude: Math.max(...flattened.map((point) => point.longitude)),
+            },
+        }
+        : null;
+    return {
+        rings,
+        bounds,
+    };
+}
+export async function fitCameraToCoordinates(map, points, options = {}) {
+    // 高层相机适配：
+    // 1. 单点时直接移动到该点；
+    // 2. 多点时计算中心点与推荐缩放；
+    // 3. 尽量保留当前朝向和俯仰，避免突兀跳变。
+    const normalized = normalizeLatLngList(points);
+    if (normalized.length === 0) {
+        return;
+    }
+    const currentCamera = await map.getCameraPosition().catch(() => ({}));
+    if (normalized.length === 1) {
+        const single = normalizeLatLng(normalized[0]);
+        await map.moveCamera({
+            target: single,
+            zoom: options.singlePointZoom ?? currentCamera.zoom ?? DEFAULT_SINGLE_POINT_ZOOM,
+            bearing: options.preserveBearing === false ? options.bearing : currentCamera.bearing ?? options.bearing,
+            tilt: options.preserveTilt === false ? options.tilt : currentCamera.tilt ?? options.tilt,
+        }, options.duration ?? 0);
+        return;
+    }
+    const routeBounds = getRouteBounds(normalized, options);
+    if (!routeBounds) {
+        return;
+    }
+    await map.moveCamera({
+        target: routeBounds.center,
+        zoom: routeBounds.recommendedZoom,
+        bearing: options.preserveBearing === false ? options.bearing : currentCamera.bearing ?? options.bearing,
+        tilt: options.preserveTilt === false ? options.tilt : currentCamera.tilt ?? options.tilt,
+    }, options.duration ?? 0);
+}
+export function buildLatLngBounds(points) {
+    const routeBounds = getRouteBounds(points);
+    if (!routeBounds) {
+        return null;
+    }
+    return {
+        southwest: {
+            latitude: routeBounds.bounds.south,
+            longitude: routeBounds.bounds.west,
+        },
+        northeast: {
+            latitude: routeBounds.bounds.north,
+            longitude: routeBounds.bounds.east,
+        },
+    };
+}
+//# sourceMappingURL=RouteUtils.js.map

package/build/utils/RouteUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteUtils.js","sourceRoot":"","sources":["../../src/utils/RouteUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { LatLng, LatLngBounds, LatLngPoint } from '../types/common.types';\nimport type {\n  FitToCoordinatesOptions,\n  FitToCoordinatesTarget,\n  MultiRingPolyline,\n  RouteBounds,\n} from '../types/route-playback.types';\nimport { normalizeLatLng, normalizeLatLngList } from './GeoUtils';\n\nconst MIN_ZOOM = 3;\nconst MAX_ZOOM = 20;\nconst DEFAULT_SINGLE_POINT_ZOOM = 16;\nconst DEFAULT_PADDING_FACTOR = 1.2;\n\nexport function estimateZoomLevel(\n  latitudeDelta: number,\n  longitudeDelta: number,\n  options: Pick<FitToCoordinatesOptions, 'minZoom' | 'maxZoom'> = {}\n): number {\n  // 使用经纬度跨度估算一个“足够看全路径”的缩放级别。\n  // 这是高层 TS 兜底逻辑，不依赖具体原生 SDK 的 fitBounds 能力。\n  const span = Math.max(latitudeDelta, longitudeDelta, 0.0001);\n  const rawZoom = Math.log2(360 / span);\n  const minZoom = options.minZoom ?? MIN_ZOOM;\n  const maxZoom = options.maxZoom ?? MAX_ZOOM;\n  return Math.max(minZoom, Math.min(maxZoom, Number(rawZoom.toFixed(2))));\n}\n\nexport function getRouteBounds(\n  points: LatLngPoint[],\n  options: Pick<FitToCoordinatesOptions, 'paddingFactor' | 'minZoom' | 'maxZoom'> = {}\n): RouteBounds | null {\n  // 统一将路径点转换为对象坐标，再计算中心点、边界和推荐缩放。\n  const normalized = normalizeLatLngList(points) as LatLng[];\n  if (normalized.length === 0) {\n    return null;\n  }\n\n  const latitudes = normalized.map((point) => point.latitude);\n  const longitudes = normalized.map((point) => point.longitude);\n\n  const north = Math.max(...latitudes);\n  const south = Math.min(...latitudes);\n  const east = Math.max(...longitudes);\n  const west = Math.min(...longitudes);\n  const paddingFactor = options.paddingFactor ?? DEFAULT_PADDING_FACTOR;\n  const latitudeDelta = Math.max((north - south) * paddingFactor, 0.0001);\n  const longitudeDelta = Math.max((east - west) * paddingFactor, 0.0001);\n\n  return {\n    center: {\n      latitude: (north + south) / 2,\n      longitude: (east + west) / 2,\n    },\n    bounds: {\n      north,\n      south,\n      east,\n      west,\n    },\n    span: {\n      latitudeDelta,\n      longitudeDelta,\n    },\n    recommendedZoom: estimateZoomLevel(latitudeDelta, longitudeDelta, options),\n  };\n}\n\nfunction parsePolylineRing(polyline: string): LatLng[] {\n  if (!polyline.trim()) {\n    return [];\n  }\n\n  return polyline\n    .split(';')\n    .map((segment) => segment.trim())\n    .filter(Boolean)\n    .map((segment) => {\n      const [longitude, latitude] = segment.split(',').map((value) => Number(value.trim()));\n      if (!Number.isFinite(longitude) || !Number.isFinite(latitude)) {\n        return null;\n      }\n\n      return {\n        latitude,\n        longitude,\n      };\n    })\n    .filter((point): point is LatLng => point !== null);\n}\n\nexport function parseMultiRingPolyline(polyline: string): MultiRingPolyline {\n  // 高德 AOI / 多边形边界常见格式为 ring1|ring2，\n  // 这里按“外环/内环”统一拆成二维坐标数组。\n  const rings = polyline\n    .split('|')\n    .map((ring) => parsePolylineRing(ring))\n    .filter((ring) => ring.length > 0);\n\n  const flattened = rings.flat();\n  const bounds = flattened.length\n    ? {\n        southwest: {\n          latitude: Math.min(...flattened.map((point) => point.latitude)),\n          longitude: Math.min(...flattened.map((point) => point.longitude)),\n        },\n        northeast: {\n          latitude: Math.max(...flattened.map((point) => point.latitude)),\n          longitude: Math.max(...flattened.map((point) => point.longitude)),\n        },\n      }\n    : null;\n\n  return {\n    rings,\n    bounds,\n  };\n}\n\nexport async function fitCameraToCoordinates(\n  map: FitToCoordinatesTarget,\n  points: LatLngPoint[],\n  options: FitToCoordinatesOptions = {}\n): Promise<void> {\n  // 高层相机适配：\n  // 1. 单点时直接移动到该点；\n  // 2. 多点时计算中心点与推荐缩放；\n  // 3. 尽量保留当前朝向和俯仰，避免突兀跳变。\n  const normalized = normalizeLatLngList(points) as LatLng[];\n  if (normalized.length === 0) {\n    return;\n  }\n\n  const currentCamera: Awaited<ReturnType<FitToCoordinatesTarget['getCameraPosition']>> =\n    await map.getCameraPosition().catch(() => ({}));\n\n  if (normalized.length === 1) {\n    const single = normalizeLatLng(normalized[0]);\n    await map.moveCamera(\n      {\n        target: single,\n        zoom: options.singlePointZoom ?? currentCamera.zoom ?? DEFAULT_SINGLE_POINT_ZOOM,\n        bearing: options.preserveBearing === false ? options.bearing : currentCamera.bearing ?? options.bearing,\n        tilt: options.preserveTilt === false ? options.tilt : currentCamera.tilt ?? options.tilt,\n      },\n      options.duration ?? 0\n    );\n    return;\n  }\n\n  const routeBounds = getRouteBounds(normalized, options);\n  if (!routeBounds) {\n    return;\n  }\n\n  await map.moveCamera(\n    {\n      target: routeBounds.center,\n      zoom: routeBounds.recommendedZoom,\n      bearing: options.preserveBearing === false ? options.bearing : currentCamera.bearing ?? options.bearing,\n      tilt: options.preserveTilt === false ? options.tilt : currentCamera.tilt ?? options.tilt,\n    },\n    options.duration ?? 0\n  );\n}\n\nexport function buildLatLngBounds(points: LatLngPoint[]): LatLngBounds | null {\n  const routeBounds = getRouteBounds(points);\n  if (!routeBounds) {\n    return null;\n  }\n\n  return {\n    southwest: {\n      latitude: routeBounds.bounds.south,\n      longitude: routeBounds.bounds.west,\n    },\n    northeast: {\n      latitude: routeBounds.bounds.north,\n      longitude: routeBounds.bounds.east,\n    },\n  };\n}\n"]}

package/ios/ExpoGaodeMapModule.swift

@@ -116,7 +116,7 @@ public class ExpoGaodeMapModule: Module {
          * 获取 SDK 版本号
          */
         Function("getVersion") {
-            "iOS SDK Version"
+            MAMapKitVersion
         }
         
         /**
@@ -195,6 +195,7 @@ public class ExpoGaodeMapModule: Module {
                         "longitude": location.coordinate.longitude,
                         "accuracy": location.horizontalAccuracy,
                         "altitude": location.altitude,
+                        "heading": location.course,
                         "bearing": location.course,
                         "speed": location.speed,
                         "timestamp": location.timestamp.timeIntervalSince1970 * 1000
@@ -578,7 +579,7 @@ public class ExpoGaodeMapModule: Module {
         }
         
         Function("setInterval") { (interval: Int) in
-            self.getLocationManager().setDistanceFilter(Double(interval))
+            self.getLocationManager().setInterval(interval)
         }
         
         Function("setDistanceFilter") { (distance: Double) in
@@ -621,7 +622,7 @@ public class ExpoGaodeMapModule: Module {
         /**
          * 设置逆地理语言 (iOS 实现)
          */
-        Function("setGeoLanguage") { (language: Int) in
+        Function("setGeoLanguage") { (language: String) in
             self.getLocationManager().setGeoLanguage(language)
         }
         
@@ -688,12 +689,7 @@ public class ExpoGaodeMapModule: Module {
          */
         AsyncFunction("checkLocationPermission") { (promise: Promise) in
             let status = self.currentAuthorizationStatus()
-            let granted = status == .authorizedAlways || status == .authorizedWhenInUse
-            
-            promise.resolve([
-                "granted": granted,
-                "status": self.getAuthorizationStatusString(status)
-            ])
+            promise.resolve(self.buildPermissionStatus(status))
         }
         
         /**
@@ -708,13 +704,7 @@ public class ExpoGaodeMapModule: Module {
                 // 无论结果如何,都延迟后再次检查最终状态
                 DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
                     let finalStatus = self.currentAuthorizationStatus()
-                    let finalGranted = finalStatus == .authorizedAlways || finalStatus == .authorizedWhenInUse
-                    let finalStatusString = self.getAuthorizationStatusString(finalStatus)
-                    
-                    promise.resolve([
-                        "granted": finalGranted,
-                        "status": finalStatusString
-                    ])
+                    promise.resolve(self.buildPermissionStatus(finalStatus))
                 }
             }
         }
@@ -736,12 +726,14 @@ public class ExpoGaodeMapModule: Module {
             // 这里返回当前状态
             let hasBackground = status == .authorizedAlways
             
-            promise.resolve([
-                "granted": hasBackground,
-                "backgroundLocation": hasBackground,
-                "status": self.getAuthorizationStatusString(status),
-                "message": hasBackground ? "已授予后台权限" : "需要在系统设置中手动授予'始终'权限"
-            ])
+            promise.resolve(
+                self.buildPermissionStatus(
+                    status,
+                    grantedOverride: hasBackground,
+                    backgroundLocationOverride: hasBackground,
+                    message: hasBackground ? "已授予后台权限" : "需要在系统设置中手动授予'始终'权限"
+                )
+            )
         }
         
   
@@ -809,4 +801,31 @@ public class ExpoGaodeMapModule: Module {
         @unknown default: return "unknown"
         }
     }
+
+    private func buildPermissionStatus(
+        _ status: CLAuthorizationStatus,
+        grantedOverride: Bool? = nil,
+        backgroundLocationOverride: Bool? = nil,
+        message: String? = nil
+    ) -> [String: Any] {
+        let granted = grantedOverride ?? (status == .authorizedAlways || status == .authorizedWhenInUse)
+        let canAskAgain = status == .notDetermined
+        let isPermanentlyDenied = status == .denied || status == .restricted
+        let backgroundLocation = backgroundLocationOverride ?? (status == .authorizedAlways)
+
+        var result: [String: Any] = [
+            "granted": granted,
+            "status": self.getAuthorizationStatusString(status),
+            "canAskAgain": canAskAgain,
+            "backgroundLocation": backgroundLocation,
+            "isPermanentlyDenied": isPermanentlyDenied,
+            "shouldShowRationale": false
+        ]
+
+        if let message {
+            result["message"] = message
+        }
+
+        return result
+    }
 }