expo-gaode-map 1.2.2 → 1.2.3

package/build/ExpoGaodeMapModule.js

@@ -1,31 +1,204 @@
 import { requireNativeModule } from 'expo';
 import { Platform } from 'react-native';
+import { CoordinateType, } from './types';
 import { ErrorHandler, ErrorLogger } from './utils/ErrorHandler';
 import { normalizeLatLng, normalizeLatLngList } from './utils/GeoUtils';
-// 获取原生模块实例 - 添加容错处理
-let nativeModule = null;
-try {
-    nativeModule = requireNativeModule('ExpoGaodeMap');
+let nativeModuleCache = null;
+function normalizeCoordinateType(type) {
+    switch (type) {
+        case CoordinateType.AMap:
+            return null;
+        case CoordinateType.MapBar:
+            return 1;
+        case CoordinateType.Baidu:
+            return 2;
+        case CoordinateType.MapABC:
+        case CoordinateType.SoSoMap:
+            return 3;
+        case CoordinateType.Google:
+        case CoordinateType.GPS:
+            return 0;
+        default:
+            throw ErrorHandler.invalidParameter('type', 'CoordinateType.AMap | MapBar | Baidu | MapABC | SoSoMap | Google | GPS', type);
+    }
+}
+function normalizeGeoLanguage(language) {
+    const normalized = String(language).trim().toUpperCase();
+    switch (normalized) {
+        case 'DEFAULT':
+            return 'DEFAULT';
+        case 'EN':
+        case 'EN-US':
+        case 'EN_US':
+        case 'EN-GB':
+        case 'EN_GB':
+            return 'EN';
+        case 'ZH':
+        case 'ZH-CN':
+        case 'ZH_CN':
+        case 'ZH-HANS':
+        case 'ZH_HANS':
+            return 'ZH';
+        default:
+            throw ErrorHandler.invalidParameter('language', "'DEFAULT' | 'EN' | 'ZH' | 常见别名（如 'en', 'zh-CN'）", language);
+    }
+}
+function normalizeLocationResult(location) {
+    const rawLocation = location;
+    const heading = rawLocation.heading ?? rawLocation.bearing ?? 0;
+    return {
+        ...rawLocation,
+        heading,
+    };
+}
+function normalizeHeadingEvent(payload) {
+    const raw = payload;
+    const fallbackHeading = Number(raw.heading ?? raw.trueHeading ?? raw.magneticHeading ?? 0);
+    const fallbackAccuracy = Number(raw.accuracy ?? raw.headingAccuracy ?? 0);
+    return {
+        magneticHeading: Number(raw.magneticHeading ?? fallbackHeading),
+        trueHeading: Number(raw.trueHeading ?? fallbackHeading),
+        headingAccuracy: fallbackAccuracy,
+        x: Number(raw.x ?? 0),
+        y: Number(raw.y ?? 0),
+        z: Number(raw.z ?? 0),
+        timestamp: Number(raw.timestamp ?? Date.now()),
+    };
+}
+function normalizePermissionStatus(permission) {
+    const raw = permission;
+    const rawStatus = String(raw.status ?? '');
+    let status;
+    switch (rawStatus) {
+        case 'granted':
+        case 'authorizedAlways':
+        case 'authorizedWhenInUse':
+            status = 'granted';
+            break;
+        case 'denied':
+        case 'restricted':
+            status = 'denied';
+            break;
+        case 'notDetermined':
+        case 'undetermined':
+        case 'unknown':
+        case '':
+        default:
+            status = 'undetermined';
+            break;
+    }
+    const granted = Boolean(raw.granted ?? (status === 'granted'));
+    const shouldShowRationale = typeof raw.shouldShowRationale === 'boolean' ? raw.shouldShowRationale : undefined;
+    const explicitPermanent = typeof raw.isPermanentlyDenied === 'boolean' ? raw.isPermanentlyDenied : undefined;
+    const canAskAgain = typeof raw.canAskAgain === 'boolean'
+        ? raw.canAskAgain
+        : granted
+            ? true
+            : typeof shouldShowRationale === 'boolean'
+                ? shouldShowRationale
+                : explicitPermanent === true
+                    ? false
+                    : status === 'undetermined';
+    const isPermanentlyDenied = explicitPermanent ??
+        (!granted && status === 'denied' && canAskAgain === false);
+    return {
+        ...raw,
+        expires: raw.expires ?? 'never',
+        granted,
+        status: status,
+        canAskAgain,
+        isPermanentlyDenied,
+    };
+}
+function getNativeModule(optional = false) {
+    if (nativeModuleCache) {
+        return nativeModuleCache;
+    }
+    try {
+        nativeModuleCache = requireNativeModule('ExpoGaodeMap');
+        return nativeModuleCache;
+    }
+    catch (error) {
+        if (optional) {
+            return null;
+        }
+        const moduleError = ErrorHandler.nativeModuleUnavailable();
+        ErrorLogger.log(moduleError);
+        throw moduleError;
+    }
 }
-catch (error) {
-    const moduleError = ErrorHandler.nativeModuleUnavailable();
-    ErrorLogger.log(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 ? getBoundNativeValue(module, prop) : undefined;
+    },
+});
 // 记录最近一次 initSDK 的配置（含 webKey）
 let _sdkConfig = null;
 let _isSDKInitialized = false;
+const privacySensitiveMethodNames = new Set([
+    'start',
+    'stop',
+    'isStarted',
+    'getCurrentLocation',
+    'coordinateConvert',
+    'setLocatingWithReGeocode',
+    'setLocationMode',
+    'setInterval',
+    'setOnceLocation',
+    'setSensorEnable',
+    'setWifiScan',
+    'setGpsFirst',
+    'setOnceLocationLatest',
+    'setGeoLanguage',
+    'setLocationCacheEnable',
+    'setHttpTimeOut',
+    'setDesiredAccuracy',
+    'setLocationTimeout',
+    'setReGeocodeTimeout',
+    'setDistanceFilter',
+    'setPausesLocationUpdatesAutomatically',
+    'setAllowsBackgroundLocationUpdates',
+    'setLocationProtocol',
+    'startUpdatingHeading',
+    'stopUpdatingHeading',
+    'checkLocationPermission',
+    'requestLocationPermission',
+    'requestBackgroundLocationPermission',
+    'addLocationListener',
+]);
+function assertPrivacyReady(scene = 'sdk') {
+    const nativeModule = getNativeModule();
+    if (!nativeModule) {
+        throw ErrorHandler.nativeModuleUnavailable();
+    }
+    const status = nativeModule.getPrivacyStatus();
+    if (!status.isReady) {
+        throw ErrorHandler.privacyNotAgreed(scene);
+    }
+}
 // 扩展原生模块，添加便捷方法
-const ExpoGaodeMapModuleWithHelpers = {
-    ...(nativeModule || {}),
+const helperMethods = {
     /**
      * 初始化 SDK，并缓存配置（包含 webKey）
      * 注意：允许不提供任何 API Key，因为原生端可能已通过 Config Plugin 配置
      */
     initSDK(config) {
-        if (!nativeModule) {
+        const nativeModule = getNativeModule();
+        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;
@@ -53,19 +226,90 @@ const ExpoGaodeMapModuleWithHelpers = {
     isSDKInitialized() {
         return _isSDKInitialized;
     },
+    /**
+     * 设置是否显示隐私政策弹窗
+     * @deprecated 请优先使用 `setPrivacyConfig`
+     */
+    setPrivacyShow(hasShow, hasContainsPrivacy) {
+        const nativeModule = getNativeModule();
+        if (!nativeModule)
+            throw ErrorHandler.nativeModuleUnavailable();
+        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();
+        if (typeof config.privacyVersion === 'string') {
+            nativeModule.setPrivacyVersion(config.privacyVersion);
+        }
+        nativeModule.setPrivacyShow(config.hasShow, config.hasContainsPrivacy ?? config.hasShow);
+        nativeModule.setPrivacyAgree(config.hasAgree);
+    },
+    getPrivacyStatus() {
+        const nativeModule = getNativeModule();
+        if (!nativeModule) {
+            return {
+                hasShow: false,
+                hasContainsPrivacy: false,
+                hasAgree: false,
+                isReady: false,
+                privacyVersion: null,
+                agreedPrivacyVersion: null,
+                restoredFromStorage: false,
+            };
+        }
+        return nativeModule.getPrivacyStatus();
+    },
     calculateDistanceBetweenPoints(p1, p2) {
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
         return nativeModule.distanceBetweenCoordinates(normalizeLatLng(p1), normalizeLatLng(p2));
     },
     calculateDistance(lat1, lon1, lat2, lon2) {
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
         return nativeModule.distanceBetweenCoordinates({ latitude: lat1, longitude: lon1 }, { latitude: lat2, longitude: lon2 });
     },
     setLoadWorldVectorMap(enabled) {
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return;
         try {
@@ -76,6 +320,7 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     getVersion() {
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return '0.0.0';
         try {
@@ -87,6 +332,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     start() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return;
         try {
@@ -97,6 +344,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     stop() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return;
         try {
@@ -107,6 +356,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     isStarted() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return Promise.resolve(false);
         try {
@@ -118,28 +369,52 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     async getCurrentLocation() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
         try {
-            return await nativeModule.getCurrentLocation();
+            const location = await nativeModule.getCurrentLocation();
+            return normalizeLocationResult(location);
         }
         catch (error) {
             throw ErrorHandler.wrapNativeError(error, '获取当前位置');
         }
     },
     async coordinateConvert(coordinate, type) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
         try {
-            return await nativeModule.coordinateConvert(normalizeLatLng(coordinate), type);
+            const normalizedCoordinate = normalizeLatLng(coordinate);
+            const normalizedType = normalizeCoordinateType(type);
+            if (normalizedType === null) {
+                return normalizedCoordinate;
+            }
+            return await nativeModule.coordinateConvert(normalizedCoordinate, normalizedType);
         }
         catch (error) {
             throw ErrorHandler.wrapNativeError(error, '坐标转换');
         }
     },
+    setGeoLanguage(language) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
+        if (!nativeModule)
+            return;
+        try {
+            nativeModule.setGeoLanguage(normalizeGeoLanguage(language));
+        }
+        catch (error) {
+            ErrorLogger.warn('setGeoLanguage 失败', { language, error });
+        }
+    },
     setLocatingWithReGeocode(isReGeocode) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return;
         try {
@@ -150,6 +425,7 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     get isBackgroundLocationEnabled() {
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return false;
         return nativeModule.isBackgroundLocationEnabled === true;
@@ -158,11 +434,13 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 检查位置权限状态
      */
     async checkLocationPermission() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
         try {
-            return await nativeModule.checkLocationPermission();
+            return normalizePermissionStatus(await nativeModule.checkLocationPermission());
         }
         catch (error) {
             throw ErrorHandler.wrapNativeError(error, '检查权限');
@@ -172,11 +450,13 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 请求前台位置权限（增强版）
      */
     async requestLocationPermission() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
         try {
-            const result = await nativeModule.requestLocationPermission();
+            const result = normalizePermissionStatus(await nativeModule.requestLocationPermission());
             if (!result.granted) {
                 ErrorLogger.warn('前台位置权限未授予', result);
             }
@@ -191,11 +471,13 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 注意：必须在前台权限已授予后才能请求
      */
     async requestBackgroundLocationPermission() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
         try {
-            const result = await nativeModule.requestBackgroundLocationPermission();
+            const result = normalizePermissionStatus(await nativeModule.requestBackgroundLocationPermission());
             if (!result.granted) {
                 ErrorLogger.warn('后台位置权限未授予', result);
             }
@@ -210,6 +492,7 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 引导用户手动授予权限
      */
     openAppSettings() {
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
@@ -221,6 +504,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     setAllowsBackgroundLocationUpdates(allows) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
@@ -255,13 +540,42 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()
      */
     addLocationListener(listener) {
-        if (!nativeModule) {
+        assertPrivacyReady('sdk');
+        const module = getNativeModule();
+        if (!module) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
-        if (!nativeModule?.addListener) {
+        if (!module.addListener) {
             ErrorLogger.warn('Native module does not support events');
+            return {
+                remove: () => { },
+            };
         }
-        return nativeModule?.addListener?.('onLocationUpdate', listener) || {
+        return module.addListener('onLocationUpdate', (location) => {
+            listener(normalizeLocationResult(location));
+        }) || {
+            remove: () => { },
+        };
+    },
+    /**
+     * 添加方向监听器（iOS）
+     * 自动归一化 heading 事件字段，兼容旧版原生返回结构
+     */
+    addHeadingListener(listener) {
+        assertPrivacyReady('sdk');
+        const module = getNativeModule();
+        if (!module) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        if (!module.addListener) {
+            ErrorLogger.warn('Native module does not support events');
+            return {
+                remove: () => { },
+            };
+        }
+        return module.addListener('onHeadingUpdate', (heading) => {
+            listener(normalizeHeadingEvent(heading));
+        }) || {
             remove: () => { },
         };
     },
@@ -304,7 +618,7 @@ const ExpoGaodeMapModuleWithHelpers = {
     /**
      * 判断点是否在多边形内
      * @param point 要判断的点
-     * @param polygon 多边形的顶点坐标数组
+     * @param polygon 多边形的顶点坐标数组，支持嵌套数组（多边形空洞）
      * @returns 是否在多边形内
      */
     isPointInPolygon(point, polygon) {
@@ -320,7 +634,7 @@ const ExpoGaodeMapModuleWithHelpers = {
     },
     /**
      * 计算多边形面积
-     * @param polygon 多边形的顶点坐标数组
+     * @param polygon 多边形的顶点坐标数组，支持嵌套数组（多边形空洞）
      * @returns 面积（单位：平方米）
      */
     calculatePolygonArea(polygon) {
@@ -575,16 +889,18 @@ const ExpoGaodeMapModuleWithHelpers = {
             return -1;
         try {
             const normalizedPoint = normalizeLatLng(point);
-            let normalizedPolygons;
             // 处理三维数组 (LatLngPoint[][][]) 和二维数组 (LatLngPoint[][])
             if (Array.isArray(polygons[0]) && Array.isArray(polygons[0][0])) {
-                // LatLngPoint[][][] -> 扁平化为 LatLngPoint[][] 用于 C++ 遍历
-                normalizedPolygons = polygons.reduce((acc, val) => acc.concat(val), []);
-            }
-            else {
-                normalizedPolygons = polygons;
+                const normalizedMultiPolygons = polygons.map((polygonRings) => normalizeLatLngList(polygonRings));
+                for (let index = 0; index < normalizedMultiPolygons.length; index += 1) {
+                    if (nativeModule.isPointInPolygon(normalizedPoint, normalizedMultiPolygons[index])) {
+                        return index;
+                    }
+                }
+                return -1;
             }
-            const processedPolygons = normalizedPolygons.map(p => normalizeLatLngList(p));
+            const normalizedPolygons = polygons;
+            const processedPolygons = normalizedPolygons.map((p) => normalizeLatLngList(p));
             return nativeModule.findPointInPolygons(normalizedPoint, processedPolygons);
         }
         catch (error) {
@@ -616,6 +932,28 @@ const ExpoGaodeMapModuleWithHelpers = {
 export function getSDKConfig() {
     return _sdkConfig;
 }
+;
+const ExpoGaodeMapModuleWithHelpers = new Proxy(helperMethods, {
+    get(target, prop, receiver) {
+        if (Reflect.has(target, prop)) {
+            return Reflect.get(target, prop, receiver);
+        }
+        const nativeModule = getNativeModule(true);
+        if (!nativeModule) {
+            return undefined;
+        }
+        const value = Reflect.get(nativeModule, prop, nativeModule);
+        if (typeof prop === 'string' &&
+            privacySensitiveMethodNames.has(prop) &&
+            typeof value === 'function') {
+            return (...args) => {
+                assertPrivacyReady('sdk');
+                return value.apply(nativeModule, args);
+            };
+        }
+        return getBoundNativeValue(nativeModule, prop);
+    },
+});
 /**
 * 获取用于 Web API 的 webKey（若未初始化或未提供则返回 undefined）
 */