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

package/android/src/main/java/expo/modules/gaodemap/ExpoGaodeMapModule.kt

@@ -30,6 +30,12 @@ class ExpoGaodeMapModule : Module() {
   override fun definition() = ModuleDefinition {
     Name("ExpoGaodeMap")
 
+    OnCreate {
+      appContext.reactContext?.let { context ->
+        SDKInitializer.restorePersistedState(context)
+      }
+    }
+
     // ==================== SDK 初始化 ====================
     
     /**
@@ -71,6 +77,14 @@ class ExpoGaodeMapModule : Module() {
       SDKInitializer.setPrivacyAgree(appContext.reactContext!!, hasAgree)
     }
 
+    Function("setPrivacyVersion") { version: String ->
+      SDKInitializer.setPrivacyVersion(appContext.reactContext!!, version)
+    }
+
+    Function("resetPrivacyConsent") {
+      SDKInitializer.resetPrivacyConsent(appContext.reactContext!!)
+    }
+
     Function("getPrivacyStatus") {
       SDKInitializer.getPrivacyStatus()
     }

package/android/src/main/java/expo/modules/gaodemap/modules/SDKInitializer.kt

@@ -14,23 +14,85 @@ import com.amap.api.maps.MapsInitializer
  * - 获取 SDK 版本信息
  */
 object SDKInitializer {
+    private const val PREFS_NAME = "expo_gaodemap_privacy"
+    private const val KEY_PRIVACY_SHOWN = "privacy_shown"
+    private const val KEY_PRIVACY_CONTAINS = "privacy_contains"
+    private const val KEY_PRIVACY_AGREED = "privacy_agreed"
+    private const val KEY_PRIVACY_VERSION = "privacy_version"
+    private const val KEY_AGREED_PRIVACY_VERSION = "agreed_privacy_version"
+
     private var privacyAgreed = false
     private var privacyShown = false
     private var privacyContains = false
+    private var privacyVersion: String? = null
+    private var agreedPrivacyVersion: String? = null
+    private var restoredFromStorage = false
 
     private fun resolveContext(context: Context): Context {
         return context.applicationContext ?: context
     }
 
+    private fun prefs(context: Context) =
+        resolveContext(context).getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
+
+    fun restorePersistedState(context: Context) {
+        val appContext = resolveContext(context)
+        val preferences = prefs(appContext)
+
+        privacyShown = preferences.getBoolean(KEY_PRIVACY_SHOWN, false)
+        privacyContains = preferences.getBoolean(KEY_PRIVACY_CONTAINS, false)
+        privacyAgreed = preferences.getBoolean(KEY_PRIVACY_AGREED, false)
+        privacyVersion = preferences.getString(KEY_PRIVACY_VERSION, null)
+        agreedPrivacyVersion = preferences.getString(KEY_AGREED_PRIVACY_VERSION, null)
+        restoredFromStorage = true
+
+        if (!privacyVersion.isNullOrEmpty() &&
+            !agreedPrivacyVersion.isNullOrEmpty() &&
+            privacyVersion != agreedPrivacyVersion
+        ) {
+            clearConsentPersistedState(appContext, keepCurrentVersion = true)
+        }
+
+        applyPrivacyState(appContext)
+    }
+
     fun setPrivacyShow(context: Context, hasShow: Boolean, hasContainsPrivacy: Boolean) {
         privacyShown = hasShow
         privacyContains = hasContainsPrivacy
-        applyPrivacyState(resolveContext(context))
+        val appContext = resolveContext(context)
+        persistState(appContext)
+        applyPrivacyState(appContext)
     }
 
     fun setPrivacyAgree(context: Context, hasAgree: Boolean) {
         privacyAgreed = hasAgree
-        applyPrivacyState(resolveContext(context))
+        agreedPrivacyVersion = if (hasAgree) privacyVersion else null
+        val appContext = resolveContext(context)
+        persistState(appContext)
+        applyPrivacyState(appContext)
+    }
+
+    fun setPrivacyVersion(context: Context, version: String) {
+        val sanitizedVersion = version.trim().takeIf { it.isNotEmpty() }
+        privacyVersion = sanitizedVersion
+
+        val appContext = resolveContext(context)
+        if (!privacyVersion.isNullOrEmpty() &&
+            !agreedPrivacyVersion.isNullOrEmpty() &&
+            privacyVersion != agreedPrivacyVersion
+        ) {
+            clearConsentPersistedState(appContext, keepCurrentVersion = true)
+        } else {
+            persistState(appContext)
+        }
+
+        applyPrivacyState(appContext)
+    }
+
+    fun resetPrivacyConsent(context: Context) {
+        val appContext = resolveContext(context)
+        clearConsentPersistedState(appContext, keepCurrentVersion = false)
+        applyPrivacyState(appContext)
     }
 
     fun applyPrivacyState(context: Context) {
@@ -49,12 +111,15 @@ object SDKInitializer {
         return privacyShown && privacyContains && privacyAgreed
     }
 
-    fun getPrivacyStatus(): Map<String, Boolean> {
+    fun getPrivacyStatus(): Map<String, Any?> {
         return mapOf(
             "hasShow" to privacyShown,
             "hasContainsPrivacy" to privacyContains,
             "hasAgree" to privacyAgreed,
-            "isReady" to isPrivacyReady()
+            "isReady" to isPrivacyReady(),
+            "privacyVersion" to privacyVersion,
+            "agreedPrivacyVersion" to agreedPrivacyVersion,
+            "restoredFromStorage" to restoredFromStorage,
         )
     }
 
@@ -67,9 +132,14 @@ object SDKInitializer {
      */
     fun initSDK(context: Context, androidKey: String) {
         val appContext = resolveContext(context)
+        restorePersistedState(appContext)
         // 检查隐私协议状态
         if (!isPrivacyReady()) {
-            throw expo.modules.kotlin.exception.CodedException("隐私协议未完成确认，请先调用 setPrivacyShow/setPrivacyAgree")
+            throw expo.modules.kotlin.exception.CodedException(
+                "PRIVACY_NOT_AGREED",
+                "隐私协议未完成确认，请先调用 setPrivacyShow/setPrivacyAgree",
+                null
+            )
         }
         
         try {
@@ -92,4 +162,36 @@ object SDKInitializer {
     fun getVersion(): String {
         return MapsInitializer.getVersion()
     }
+
+    private fun persistState(context: Context) {
+        prefs(context).edit()
+            .putBoolean(KEY_PRIVACY_SHOWN, privacyShown)
+            .putBoolean(KEY_PRIVACY_CONTAINS, privacyContains)
+            .putBoolean(KEY_PRIVACY_AGREED, privacyAgreed)
+            .putString(KEY_PRIVACY_VERSION, privacyVersion)
+            .putString(KEY_AGREED_PRIVACY_VERSION, agreedPrivacyVersion)
+            .apply()
+    }
+
+    private fun clearConsentPersistedState(context: Context, keepCurrentVersion: Boolean) {
+        privacyShown = false
+        privacyContains = false
+        privacyAgreed = false
+        agreedPrivacyVersion = null
+
+        val editor = prefs(context).edit()
+            .putBoolean(KEY_PRIVACY_SHOWN, false)
+            .putBoolean(KEY_PRIVACY_CONTAINS, false)
+            .putBoolean(KEY_PRIVACY_AGREED, false)
+            .remove(KEY_AGREED_PRIVACY_VERSION)
+
+        if (keepCurrentVersion) {
+            editor.putString(KEY_PRIVACY_VERSION, privacyVersion)
+        } else {
+            privacyVersion = null
+            editor.remove(KEY_PRIVACY_VERSION)
+        }
+
+        editor.apply()
+    }
 }

package/build/ExpoGaodeMapModule.d.ts

@@ -1,13 +1,254 @@
-import type { ExpoGaodeMapModule } from './types/native-module.types';
-import { SDKConfig } from './types/common.types';
+import { LatLng, Coordinates, ReGeocode, LocationListener, LatLngPoint, CoordinateType } from './types';
+import type { ExpoGaodeMapModule as NativeExpoGaodeMapModule } from './types/native-module.types';
+import { PrivacyConfig, PrivacyStatus, SDKConfig, PermissionStatus } from './types/common.types';
+declare const helperMethods: {
+    /**
+     * 初始化 SDK，并缓存配置（包含 webKey）
+     * 注意：允许不提供任何 API Key，因为原生端可能已通过 Config Plugin 配置
+     */
+    initSDK(config: SDKConfig): void;
+    isSDKInitialized(): boolean;
+    /**
+     * 设置是否显示隐私政策弹窗
+     * @deprecated 请优先使用 `setPrivacyConfig`
+     */
+    setPrivacyShow(hasShow: boolean, hasContainsPrivacy?: boolean): void;
+    /**
+     * 设置用户是否同意隐私政策
+     * @deprecated 请优先使用 `setPrivacyConfig`
+     */
+    setPrivacyAgree(hasAgree: boolean): void;
+    /**
+     * 设置当前隐私协议版本
+     * 当版本号变化时，之前的同意状态会失效
+     */
+    setPrivacyVersion(version: string): void;
+    /**
+     * 清空已持久化的隐私同意状态
+     */
+    resetPrivacyConsent(): void;
+    /**
+     * 一次性同步完整的隐私状态
+     * 推荐业务层只调用这个方法
+     */
+    setPrivacyConfig(config: PrivacyConfig): void;
+    getPrivacyStatus(): PrivacyStatus;
+    calculateDistanceBetweenPoints(p1: LatLngPoint, p2: LatLngPoint): number;
+    calculateDistance(lat1: number, lon1: number, lat2: number, lon2: number): number;
+    setLoadWorldVectorMap(enabled: boolean): void;
+    getVersion(): string;
+    start(): void;
+    stop(): void;
+    isStarted(): Promise<boolean>;
+    getCurrentLocation(): Promise<Coordinates | ReGeocode>;
+    coordinateConvert(coordinate: LatLngPoint, type: CoordinateType): Promise<LatLng>;
+    setLocatingWithReGeocode(isReGeocode: boolean): void;
+    readonly isBackgroundLocationEnabled: boolean;
+    /**
+     * 检查位置权限状态
+     */
+    checkLocationPermission(): Promise<PermissionStatus>;
+    /**
+     * 请求前台位置权限（增强版）
+     */
+    requestLocationPermission(): Promise<PermissionStatus>;
+    /**
+     * 请求后台位置权限
+     * 注意：必须在前台权限已授予后才能请求
+     */
+    requestBackgroundLocationPermission(): Promise<PermissionStatus>;
+    /**
+     * 打开应用设置页面
+     * 引导用户手动授予权限
+     */
+    openAppSettings(): void;
+    setAllowsBackgroundLocationUpdates(allows: boolean): void;
+    /**
+     * 添加定位监听器（便捷方法）
+     * 自动订阅 onLocationUpdate 事件，提供容错处理
+     * @param listener 定位回调函数
+     * @returns 订阅对象，调用 remove() 取消监听
+     * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()
+     */
+    addLocationListener(listener: LocationListener): {
+        remove: () => void;
+    };
+    /**
+     * 计算两个坐标点之间的距离
+     * @param coordinate1 第一个坐标点
+     * @param coordinate2 第二个坐标点
+     * @returns 两点之间的距离（单位：米）
+     */
+    distanceBetweenCoordinates(coordinate1: LatLngPoint, coordinate2: LatLngPoint): number;
+    /**
+     * 判断点是否在圆内
+     * @param point 要判断的点
+     * @param center 圆心坐标
+     * @param radius 圆半径（单位：米）
+     * @returns 是否在圆内
+     */
+    isPointInCircle(point: LatLngPoint, center: LatLngPoint, radius: number): boolean;
+    /**
+     * 判断点是否在多边形内
+     * @param point 要判断的点
+     * @param polygon 多边形的顶点坐标数组
+     * @returns 是否在多边形内
+     */
+    isPointInPolygon(point: LatLngPoint, polygon: LatLngPoint[]): boolean;
+    /**
+     * 计算多边形面积
+     * @param polygon 多边形的顶点坐标数组
+     * @returns 面积（单位：平方米）
+     */
+    calculatePolygonArea(polygon: LatLngPoint[]): number;
+    /**
+     * 计算矩形面积
+     * @param southWest 西南角坐标
+     * @param northEast 东北角坐标
+     * @returns 面积（单位：平方米）
+     */
+    calculateRectangleArea(southWest: LatLngPoint, northEast: LatLngPoint): number;
+    /**
+     * 获取路径上距离目标点最近的点
+     * @param path 路径点集合
+     * @param target 目标点
+     * @returns 最近点信息，包含坐标、索引和距离
+     */
+    getNearestPointOnPath(path: LatLngPoint[], target: LatLngPoint): {
+        latitude: number;
+        longitude: number;
+        index: number;
+        distanceMeters: number;
+    } | null;
+    /**
+     * 计算多边形质心
+     * @param polygon 多边形顶点坐标数组
+     * @returns 质心坐标
+     */
+    calculateCentroid(polygon: LatLngPoint[]): LatLng | null;
+    /**
+     * 计算路径边界和中心点
+     * @param points 路径点集合
+     * @returns 边界信息，包含 north, south, east, west 和 center
+     */
+    calculatePathBounds(points: LatLngPoint[]): {
+        north: number;
+        south: number;
+        east: number;
+        west: number;
+        center: LatLngPoint;
+    } | null;
+    /**
+     * GeoHash 编码
+     * @param coordinate 坐标点
+     * @param precision 精度 (1-12)
+     * @returns GeoHash 字符串
+     */
+    encodeGeoHash(coordinate: LatLngPoint, precision: number): string;
+    /**
+     * 轨迹抽稀 (RDP 算法)
+     * @param points 原始轨迹点
+     * @param tolerance 允许误差(米)
+     * @returns 简化后的轨迹点
+     */
+    simplifyPolyline(points: LatLngPoint[], tolerance: number): LatLng[];
+    /**
+     * 计算路径总长度
+     * @param points 路径点
+     * @returns 长度(米)
+     */
+    calculatePathLength(points: LatLngPoint[]): number;
+    /**
+     * 解析高德地图 API 返回的 Polyline 字符串
+     * 格式: "lng,lat;lng,lat;..."
+     * @param polylineStr 高德原始 polyline 字符串，或包含 polyline 属性的对象
+     * @returns 解析后的点集
+     */
+    parsePolyline(polylineStr: string | {
+        polyline: string;
+    }): LatLng[];
+    /**
+     * 获取路径上指定距离的点
+     * @param points 路径点
+     * @param distance 距离起点的米数
+     * @returns 点信息(坐标+角度)
+     */
+    getPointAtDistance(points: LatLngPoint[], distance: number): {
+        latitude: number;
+        longitude: number;
+        angle: number;
+    } | null;
+    /**
+     * 经纬度转换为地图瓦片坐标
+     * @param coordinate 经纬度点
+     * @param zoom 缩放级别
+     * @returns 瓦片坐标(x, y, z)
+     */
+    latLngToTile(coordinate: LatLngPoint, zoom: number): {
+        x: number;
+        y: number;
+        z: number;
+    } | null;
+    /**
+     * 地图瓦片坐标转换为经纬度
+     * @param tile 瓦片坐标(x, y, z)
+     * @returns 经纬度点
+     */
+    tileToLatLng(tile: {
+        x: number;
+        y: number;
+        z: number;
+    }): LatLng | null;
+    /**
+     * 经纬度转换为地图像素坐标
+     * @param coordinate 经纬度点
+     * @param zoom 缩放级别
+     * @returns 像素坐标(x, y)
+     */
+    latLngToPixel(coordinate: LatLngPoint, zoom: number): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * 地图像素坐标转换为经纬度
+     * @param pixel 像素坐标(x, y)
+     * @param zoom 缩放级别
+     * @returns 经纬度点
+     */
+    pixelToLatLng(pixel: {
+        x: number;
+        y: number;
+    }, zoom: number): LatLng | null;
+    /**
+     * 批量地理围栏检测
+     * @param point 待检查的点
+     * @param polygons 多边形数组，格式为 LatLngPoint[][] 或 LatLngPoint[][][]
+     * @returns 包含点索引的数组（-1 表示不在任何多边形内）
+     */
+    findPointInPolygons(point: LatLngPoint, polygons: LatLngPoint[][] | LatLngPoint[][][]): number;
+    /**
+     * 生成网格聚合数据 (常用于展示网格聚合图或大规模点数据处理)
+     * @param points 包含经纬度和权重的点数组
+     * @param gridSizeMeters 网格大小（米）
+     * @returns 包含经纬度和强度的网格点数组
+     */
+    generateHeatmapGrid(points: Array<LatLngPoint & {
+        weight?: number;
+    }>, gridSizeMeters: number): Array<{
+        latitude: number;
+        longitude: number;
+        intensity: number;
+    }>;
+};
 /**
 * 获取最近一次 initSDK 的配置
 */
 export declare function getSDKConfig(): SDKConfig | null;
+export type ExpoGaodeMapModule = Omit<NativeExpoGaodeMapModule, keyof typeof helperMethods> & typeof helperMethods;
+declare const ExpoGaodeMapModuleWithHelpers: ExpoGaodeMapModule;
 /**
 * 获取用于 Web API 的 webKey（若未初始化或未提供则返回 undefined）
 */
 export declare function getWebKey(): string | undefined;
-declare const _default: ExpoGaodeMapModule;
-export default _default;
+export default ExpoGaodeMapModuleWithHelpers;
 //# sourceMappingURL=ExpoGaodeMapModule.d.ts.map

package/build/ExpoGaodeMapModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapModule.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAiB,SAAS,EAAoB,MAAM,sBAAsB,CAAC;AAixBlF;;EAEE;AACF,wBAAgB,YAAY,IAAI,SAAS,GAAG,IAAI,CAE/C;AA4BD;;EAEE;AACF,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C;wBAE0D,kBAAkB;AAA7E,wBAA8E"}
+{"version":3,"file":"ExpoGaodeMapModule.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"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"}

package/build/ExpoGaodeMapModule.js

@@ -20,10 +20,17 @@ function getNativeModule(optional = false) {
         throw moduleError;
     }
 }
+function getBoundNativeValue(module, prop) {
+    const value = Reflect.get(module, prop, module);
+    if (typeof value === 'function') {
+        return (...args) => value.apply(module, args);
+    }
+    return value;
+}
 const nativeModule = new Proxy({}, {
     get(_target, prop) {
         const module = getNativeModule(true);
-        return module ? Reflect.get(module, prop) : undefined;
+        return module ? getBoundNativeValue(module, prop) : undefined;
     },
 });
 // 记录最近一次 initSDK 的配置（含 webKey）
@@ -81,6 +88,10 @@ const helperMethods = {
         if (!nativeModule)
             throw ErrorHandler.nativeModuleUnavailable();
         try {
+            const privacyStatus = nativeModule.getPrivacyStatus();
+            if (!privacyStatus.isReady) {
+                throw ErrorHandler.privacyNotAgreed('sdk');
+            }
             // 检查是否有任何 key 被提供
             const hasJSKeys = !!(config.androidKey || config.iosKey);
             const hasWebKey = !!config.webKey;
@@ -108,23 +119,57 @@ const helperMethods = {
     isSDKInitialized() {
         return _isSDKInitialized;
     },
+    /**
+     * 设置是否显示隐私政策弹窗
+     * @deprecated 请优先使用 `setPrivacyConfig`
+     */
     setPrivacyShow(hasShow, hasContainsPrivacy) {
         const nativeModule = getNativeModule();
         if (!nativeModule)
             throw ErrorHandler.nativeModuleUnavailable();
-        nativeModule.setPrivacyShow(hasShow, hasContainsPrivacy);
+        nativeModule.setPrivacyShow(hasShow, hasContainsPrivacy ?? hasShow);
     },
+    /**
+     * 设置用户是否同意隐私政策
+     * @deprecated 请优先使用 `setPrivacyConfig`
+     */
     setPrivacyAgree(hasAgree) {
         const nativeModule = getNativeModule();
         if (!nativeModule)
             throw ErrorHandler.nativeModuleUnavailable();
         nativeModule.setPrivacyAgree(hasAgree);
     },
+    /**
+     * 设置当前隐私协议版本
+     * 当版本号变化时，之前的同意状态会失效
+     */
+    setPrivacyVersion(version) {
+        const nativeModule = getNativeModule();
+        if (!nativeModule)
+            throw ErrorHandler.nativeModuleUnavailable();
+        nativeModule.setPrivacyVersion(version);
+    },
+    /**
+     * 清空已持久化的隐私同意状态
+     */
+    resetPrivacyConsent() {
+        const nativeModule = getNativeModule();
+        if (!nativeModule)
+            throw ErrorHandler.nativeModuleUnavailable();
+        nativeModule.resetPrivacyConsent();
+    },
+    /**
+     * 一次性同步完整的隐私状态
+     * 推荐业务层只调用这个方法
+     */
     setPrivacyConfig(config) {
         const nativeModule = getNativeModule();
         if (!nativeModule)
             throw ErrorHandler.nativeModuleUnavailable();
-        nativeModule.setPrivacyShow(config.hasShow, config.hasContainsPrivacy);
+        if (typeof config.privacyVersion === 'string') {
+            nativeModule.setPrivacyVersion(config.privacyVersion);
+        }
+        nativeModule.setPrivacyShow(config.hasShow, config.hasContainsPrivacy ?? config.hasShow);
         nativeModule.setPrivacyAgree(config.hasAgree);
     },
     getPrivacyStatus() {
@@ -135,6 +180,9 @@ const helperMethods = {
                 hasContainsPrivacy: false,
                 hasAgree: false,
                 isReady: false,
+                privacyVersion: null,
+                agreedPrivacyVersion: null,
+                restoredFromStorage: false,
             };
         }
         return nativeModule.getPrivacyStatus();
@@ -743,7 +791,7 @@ const ExpoGaodeMapModuleWithHelpers = new Proxy(helperMethods, {
         if (!nativeModule) {
             return undefined;
         }
-        const value = Reflect.get(nativeModule, prop);
+        const value = Reflect.get(nativeModule, prop, nativeModule);
         if (typeof prop === 'string' &&
             privacySensitiveMethodNames.has(prop) &&
             typeof value === 'function') {
@@ -752,7 +800,7 @@ const ExpoGaodeMapModuleWithHelpers = new Proxy(helperMethods, {
                 return value.apply(nativeModule, args);
             };
         }
-        return value;
+        return getBoundNativeValue(nativeModule, prop);
     },
 });
 /**