expo-gaode-map 2.2.0 → 2.2.1

package/src/ExpoGaodeMapModule.ts

@@ -1,315 +0,0 @@
-/**
- * 高德地图原生模块
- * 提供 SDK 初始化、定位、权限管理等功能
- */
-
-import { NativeModule, requireNativeModule } from 'expo';
-import type { ExpoGaodeMapModuleEvents } from './ExpoGaodeMap.types';
-import type {
-  LatLng,
-  CoordinateType,
-  Coordinates,
-  ReGeocode,
-  LocationMode,
-  LocationAccuracy,
-  LocationListener,
-} from './types';
-
-/**
- * SDK 配置参数
- */
-export interface SDKConfig {
-  /** Android 平台的高德地图 API Key */
-  androidKey?: string;
-  /** iOS 平台的高德地图 API Key */
-  iosKey?: string;
-  /** web api key 如果要使用expo-gaode-map-web-api相关的功能，需要配置web api key*/
-  webKey?: string;
-}
-
-/**
- * 权限状态
- */
-export interface PermissionStatus {
-  /** 是否已授权 */
-  granted: boolean;
-  /** iOS 权限状态字符串 */
-  status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';
-  /** Android 精确位置权限 */
-  fineLocation?: boolean;
-  /** Android 粗略位置权限 */
-  coarseLocation?: boolean;
-}
-
-/**
- * 高德地图原生模块类声明
- */
-declare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {
-  // ==================== 隐私合规管理 ====================
-  
-  /**
-   * 更新隐私合规状态
-   * 必须在用户同意隐私协议后调用
-   * @param hasAgreed 用户是否已同意隐私协议
-   */
-  updatePrivacyCompliance(hasAgreed: boolean): void;
-  
-  // ==================== SDK 初始化 ====================
-  
-  /**
-   * 初始化高德地图 SDK
-   * @param config SDK 配置参数，包含 Android 和 iOS 的 API Key
-   */
-  initSDK(config: SDKConfig): void;
-  
-  /**
-   * 获取高德地图 SDK 版本号
-   * @returns SDK 版本字符串
-   */
-  getVersion(): string;
-  
-  // ==================== 定位控制 ====================
-  
-  /**
-   * 开始连续定位
-   * 启动后会持续接收位置更新，通过 onLocationUpdate 事件回调
-   */
-  start(): void;
-  
-  /**
-   * 停止定位
-   * 停止接收位置更新
-   */
-  stop(): void;
-  
-  /**
-   * 检查是否正在定位
-   * @returns Promise<boolean> 是否正在定位
-   */
-  isStarted(): Promise<boolean>;
-  
-  /**
-   * 获取当前位置（单次定位）
-   * @returns Promise<Coordinates | ReGeocode> 位置信息，包含坐标和可选的逆地理编码信息
-   */
-  getCurrentLocation(): Promise<Coordinates | ReGeocode>;
-  
-  /**
-   * 坐标转换
-   * 将其他坐标系的坐标转换为高德地图使用的 GCJ-02 坐标系
-   * @param coordinate 需要转换的坐标
-   * @param type 原坐标系类型
-   * @returns Promise<LatLng> 转换后的 GCJ-02 坐标
-   */
-  coordinateConvert(coordinate: LatLng, type: CoordinateType): Promise<LatLng>;
-  
-  // ==================== 定位配置 ====================
-  
-  /**
-   * 设置是否返回逆地理编码信息
-   * @param isReGeocode true: 返回地址信息; false: 只返回坐标
-   */
-  setLocatingWithReGeocode(isReGeocode: boolean): void;
-  
-  /**
-   * 设置定位模式（Android）
-   * @param mode 定位模式：0-低功耗, 1-仅设备, 2-高精度
-   */
-  setLocationMode(mode: LocationMode): void;
-  
-  /**
-   * 设置定位间隔（毫秒）
-   * @param interval 定位间隔时间，单位毫秒，默认 2000ms
-   */
-  setInterval(interval: number): void;
-  
-  /**
-   * 设置是否单次定位（Android）
-   * @param isOnceLocation true: 单次定位; false: 连续定位
-   */
-  setOnceLocation(isOnceLocation: boolean): void;
-  
-  /**
-   * 设置是否使用设备传感器（Android）
-   * @param sensorEnable true: 使用传感器; false: 不使用
-   */
-  setSensorEnable(sensorEnable: boolean): void;
-  
-  /**
-   * 设置是否允许 WiFi 扫描（Android）
-   * @param wifiScan true: 允许; false: 不允许
-   */
-  setWifiScan(wifiScan: boolean): void;
-  
-  /**
-   * 设置是否 GPS 优先（Android）
-   * @param gpsFirst true: GPS 优先; false: 网络优先
-   */
-  setGpsFirst(gpsFirst: boolean): void;
-  
-  /**
-   * 设置是否等待 WiFi 列表刷新（Android）
-   * @param onceLocationLatest true: 等待; false: 不等待
-   */
-  setOnceLocationLatest(onceLocationLatest: boolean): void;
-  
-  /**
-   * 设置逆地理编码语言
-   * @param language 语言代码，如 "zh-CN", "en"
-   */
-  setGeoLanguage(language: string): void;
-  
-  /**
-   * 设置是否使用缓存策略（Android）
-   * @param locationCacheEnable true: 使用缓存; false: 不使用
-   */
-  setLocationCacheEnable(locationCacheEnable: boolean): void;
-  
-  /**
-   * 设置网络请求超时时间（Android）
-   * @param httpTimeOut 超时时间，单位毫秒
-   */
-  setHttpTimeOut(httpTimeOut: number): void;
-  
-  /**
-   * 设置期望的定位精度（iOS）
-   * @param accuracy 精度级别：0-最佳, 1-10米, 2-100米, 3-1公里, 4-3公里
-   */
-  setDesiredAccuracy(accuracy: LocationAccuracy): void;
-  
-  /**
-   * 设置定位超时时间（秒）
-   * @param timeout 超时时间，单位秒，默认 10 秒
-   */
-  setLocationTimeout(timeout: number): void;
-  
-  /**
-   * 设置逆地理编码超时时间（秒）
-   * @param timeout 超时时间，单位秒，默认 5 秒
-   */
-  setReGeocodeTimeout(timeout: number): void;
-  
-  /**
-   * 设置距离过滤器（米）（iOS）
-   * 只有移动超过指定距离才会更新位置
-   * @param distance 距离阈值，单位米
-   */
-  setDistanceFilter(distance: number): void;
-  
-  /**
-   * 设置是否自动暂停位置更新（iOS）
-   * @param pauses true: 自动暂停; false: 不暂停
-   */
-  setPausesLocationUpdatesAutomatically(pauses: boolean): void;
-  
-  /**
-   * 设置是否允许后台定位（iOS）
-   * @param allows true: 允许; false: 不允许
-   */
-  setAllowsBackgroundLocationUpdates(allows: boolean): void;
-  
-  /**
-   * 设置定位协议
-   * @param protocol 协议类型
-   */
-  setLocationProtocol(protocol: string): void;
-  
-  // ==================== 方向更新 (iOS) ====================
-  
-  /**
-   * 开始更新设备方向（罗盘朝向）
-   * 通过 onHeadingUpdate 事件接收方向更新
-   * @platform ios
-   */
-  startUpdatingHeading(): void;
-  
-  /**
-   * 停止更新设备方向
-   * @platform ios
-   */
-  stopUpdatingHeading(): void;
-  
-  // ==================== 权限管理 ====================
-  
-  /**
-   * 检查位置权限状态
-   * @returns Promise<PermissionStatus> 权限状态
-   */
-  checkLocationPermission(): Promise<PermissionStatus>;
-  
-  /**
-   * 请求位置权限
-   * @returns Promise<PermissionStatus> 请求后的权限状态
-   */
-  requestLocationPermission(): Promise<PermissionStatus>;
-  
-  // ==================== 便捷方法 ====================
-  
-  /**
-   * 添加定位监听器（便捷方法）
-   * 封装了 addListener，提供更简洁的 API
-   * @param listener 定位回调函数
-   * @returns 订阅对象，调用 remove() 取消监听
-   */
-  addLocationListener(listener: LocationListener): { remove: () => void };
-}
-
-// 获取原生模块实例 - 添加容错处理
-let nativeModule: ExpoGaodeMapModule | null = null;
-
-try {
-  nativeModule = requireNativeModule<ExpoGaodeMapModule>('ExpoGaodeMap');
-} catch (error) {
-  console.warn('ExpoGaodeMap 原生模块加载失败:', error);
-}
-
-// 如果模块加载失败，创建一个空的代理对象防止崩溃
-if (!nativeModule) {
-  console.error('ExpoGaodeMap: 原生模块不可用，请检查配置');
-}
-
-// 记录最近一次 initSDK 的配置（含 webKey）
-let _sdkConfig: SDKConfig | null = null;
-
-// 扩展原生模块，添加便捷方法
-const ExpoGaodeMapModuleWithHelpers = {
- ...(nativeModule || {}),
-
- /**
-  * 初始化 SDK，并缓存配置（包含 webKey）
-  */
- initSDK(config: SDKConfig): void {
-   _sdkConfig = config ?? null;
-   nativeModule?.initSDK?.(config);
- },
-
- /**
-  * 添加定位监听器（便捷方法）
-  * 自动订阅 onLocationUpdate 事件，提供容错处理
-  * @param listener 定位回调函数
-  * @returns 订阅对象，调用 remove() 取消监听
-  * @throws 如果底层模块不可用，返回一个空操作的订阅对象
-  */
- addLocationListener(listener: LocationListener): { remove: () => void } {
-   // 使用可选链和空值合并，确保即使模块不可用也不会崩溃
-   return nativeModule?.addListener?.('onLocationUpdate', listener) || {
-     remove: () => {},
-   };
- },
-};
-
-/**
-* 获取最近一次 initSDK 的配置
-*/
-export function getSDKConfig(): SDKConfig | null {
- return _sdkConfig;
-}
-
-/**
-* 获取用于 Web API 的 webKey（若未初始化或未提供则返回 undefined）
-*/
-export function getWebKey(): string | undefined {
- return _sdkConfig?.webKey;
-}
-
-export default ExpoGaodeMapModuleWithHelpers as ExpoGaodeMapModule;

package/src/ExpoGaodeMapView.tsx

@@ -1,120 +0,0 @@
-import { requireNativeViewManager } from 'expo-modules-core';
-import * as React from 'react';
-
-import type {
-  MapViewProps,
-  MapViewRef,
-  CameraPosition,
-  LatLng,
-  Point,
-
-} from './types';
-
-export type { MapViewRef } from './types';
-
-const NativeView: React.ComponentType<MapViewProps & { ref?: React.Ref<MapViewRef> }> = requireNativeViewManager('ExpoGaodeMapView');
-
-
-/**
- * 高德地图视图组件，提供地图操作API和覆盖物管理功能
- * 
- * @param props - 组件属性
- * @param ref - 外部ref引用，用于访问地图API方法
- * @returns 返回包含地图视图和上下文提供者的React组件
- * 
- * @remarks
- * 该组件内部维护两个ref：
- * - nativeRef: 指向原生地图视图的引用
- * - internalRef: 内部使用的API引用，通过MapContext共享
- * 
- * 提供的主要API功能包括：
- * - 相机控制（移动、缩放、获取当前位置）
- * - 覆盖物管理（添加/删除/更新标记、折线、多边形、圆形等）
- * 
- * 所有API方法都会检查地图是否已初始化，未初始化时抛出错误
- */
-const ExpoGaodeMapView = React.forwardRef<MapViewRef, MapViewProps>((props, ref) => {
-  const nativeRef = React.useRef<MapViewRef>(null);
-  const internalRef = React.useRef<MapViewRef | null>(null);
-  
-
-  const apiRef: MapViewRef = React.useMemo(() => ({
-    /**
-     * 移动地图相机到指定位置
-     * @param position 相机位置参数对象，包含目标经纬度、缩放级别等信息
-     * @param duration 动画持续时间（毫秒），默认300毫秒
-     * @throws 如果地图视图未初始化则抛出错误
-     * @returns Promise<void> 异步操作完成后的Promise
-     */
-    moveCamera: async (position: CameraPosition, duration: number = 300) => {
-      if (!nativeRef.current) throw new Error('MapView not initialized');
-      return nativeRef.current.moveCamera(position, duration);
-    },
-    /**
-     * 将屏幕坐标点转换为地理坐标（经纬度）
-     * @param point 屏幕坐标点 {x: number, y: number}
-     * @returns 返回Promise，解析为对应的地理坐标 {latitude: number, longitude: number}
-     * @throws 如果地图视图未初始化，抛出错误 'MapView not initialized'
-     */
-    getLatLng: async (point: Point) => {
-      if (!nativeRef.current) throw new Error('MapView not initialized');
-      return nativeRef.current.getLatLng(point);
-    },
-    /**
-     * 设置地图中心点坐标
-     * @param center 要设置的中心点坐标(LatLng格式)
-     * @param animated 是否使用动画效果移动地图(默认为false)
-     * @throws 如果地图视图未初始化则抛出错误
-     */
-    setCenter: async (center: LatLng, animated: boolean = false) => {
-      if (!nativeRef.current) throw new Error('MapView not initialized');
-      return nativeRef.current.setCenter(center, animated);
-    },
-    /**
-     * 设置地图的缩放级别
-     * @param zoom 目标缩放级别
-     * @param animated 是否使用动画过渡效果，默认为false
-     * @throws 如果地图视图未初始化，抛出错误
-     */
-    setZoom: async (zoom: number, animated: boolean = false) => {
-      if (!nativeRef.current) throw new Error('MapView not initialized');
-      return nativeRef.current.setZoom(zoom, animated);
-    },
-    /**
-     * 获取当前地图的相机位置（视角中心点、缩放级别、倾斜角度等）
-     * @returns 返回一个Promise，解析为当前相机位置的对象
-     * @throws 如果地图视图未初始化，则抛出错误
-     */
-    getCameraPosition: async () => {
-      if (!nativeRef.current) throw new Error('MapView not initialized');
-      return nativeRef.current.getCameraPosition();
-    }
-
-  }), []);
-
-  /**
-   * 将传入的apiRef赋值给internalRef.current
-   * 用于在组件内部保存对地图API实例的引用
-   */
-  React.useEffect(() => {
-    internalRef.current = apiRef;
-  }, [apiRef]);
-
-  /**
-   * 获取当前地图实例的API引用
-   * @returns 返回地图API的引用对象，可用于调用地图相关方法
-   */
-  React.useImperativeHandle(ref, () => apiRef, [apiRef]);
-
-  return (
-    <NativeView
-        ref={nativeRef}
-          {...props}>
-          {props.children}
-        </NativeView>
-  );
-});
-
-ExpoGaodeMapView.displayName = 'ExpoGaodeMapView';
-
-export default ExpoGaodeMapView;

package/src/components/overlays/Circle.tsx

@@ -1,19 +0,0 @@
-import * as React from 'react';
-import { requireNativeViewManager } from 'expo-modules-core';
-import type { CircleProps } from '../../types';
-
-const NativeCircleView = requireNativeViewManager<CircleProps>('CircleView');
-
-/**
- * 高德地图圆形覆盖物组件（声明式）
- *
- *
- * @param props 圆形组件的属性配置
- * @returns 渲染原生圆形组件
- */
-function Circle(props: CircleProps) {
-  return <NativeCircleView {...props} />;
-}
-
-// 导出优化后的组件
-export default React.memo(Circle);

package/src/components/overlays/Cluster.tsx

@@ -1,16 +0,0 @@
-
-import { requireNativeViewManager } from 'expo-modules-core';
-import * as React from 'react';
-import type { ClusterProps } from '../../types';
-
-const NativeCluster = requireNativeViewManager('ClusterView');
-
-/**
- * 高德地图点聚合组件
- * 
- * @param props 点聚合组件的属性配置
- * @returns 渲染原生点聚合组件
- */
-export default function Cluster(props: ClusterProps) {
-  return <NativeCluster {...props} />;
-}

package/src/components/overlays/HeatMap.tsx

@@ -1,17 +0,0 @@
-
-import { requireNativeViewManager } from 'expo-modules-core';
-import * as React from 'react';
-import type { HeatMapProps } from '../../types';
-
-const NativeHeatMap = requireNativeViewManager('HeatMapView');
-
-
-/**
- * 高德地图热力图组件
- * 
- * @param props - 热力图配置属性，继承自NativeHeatMap组件的属性
- * @returns 渲染高德地图原生热力图组件
- */
-export default function HeatMap(props: HeatMapProps) {
-  return <NativeHeatMap {...props} />;
-}

package/src/components/overlays/Marker.tsx

@@ -1,87 +0,0 @@
-
-import * as React from 'react';
-import { requireNativeViewManager } from 'expo-modules-core';
-import type { MarkerProps } from '../../types';
-
-const NativeMarkerView = requireNativeViewManager('MarkerView');
-
-/**
- * Marker 组件 - 完全声明式 API
- *
- * 支持：
- * - 自定义图标（icon）
- * - 自定义内容（children）
- * - 大头针样式（pinColor）
- * - 拖拽功能
- * - 所有事件回调
- */
-function Marker(props: MarkerProps) {
-  // 根据是否有 children 来决定使用哪个尺寸属性
-  // 有 children：使用 customViewWidth/customViewHeight（默认 200x40）
-  // 无 children：使用 iconWidth/iconHeight（用于自定义图标，默认 40x40）
-  const containerWidth = props.children
-    ? (props.customViewWidth && props.customViewWidth > 0 ? props.customViewWidth : 200)
-    : (props.iconWidth && props.iconWidth > 0 ? props.iconWidth : 40);
-  const containerHeight = props.children
-    ? (props.customViewHeight && props.customViewHeight > 0 ? props.customViewHeight : 40)
-    : (props.iconHeight && props.iconHeight > 0 ? props.iconHeight : 40);
-  
-  // 从 props 中排除 position 属性，避免传递到原生层
-  const { position, ...restProps } = props;
-  
-  return (
-    <NativeMarkerView
-      latitude={position.latitude}
-      longitude={position.longitude}
-      iconWidth={containerWidth}
-      iconHeight={containerHeight}
-      customViewWidth={containerWidth}
-      customViewHeight={containerHeight}
-      {...restProps}
-    >
-      {props.children}
-    </NativeMarkerView>
-  );
-}
-
-/**
- * 自定义比较函数
- * 深度比较 position 和其他关键属性
- */
-function arePropsEqual(prevProps: MarkerProps, nextProps: MarkerProps): boolean {
-  // 比较 position
-  if (
-    prevProps.position.latitude !== nextProps.position.latitude ||
-    prevProps.position.longitude !== nextProps.position.longitude
-  ) {
-    return false;
-  }
-  
-  // 比较基础属性
-  if (
-    prevProps.title !== nextProps.title ||
-    prevProps.snippet !== nextProps.snippet ||
-    prevProps.icon !== nextProps.icon ||
-    prevProps.pinColor !== nextProps.pinColor ||
-    prevProps.draggable !== nextProps.draggable ||
-    prevProps.animatesDrop !== nextProps.animatesDrop ||
-    prevProps.iconWidth !== nextProps.iconWidth ||
-    prevProps.iconHeight !== nextProps.iconHeight ||
-    prevProps.customViewWidth !== nextProps.customViewWidth ||
-    prevProps.customViewHeight !== nextProps.customViewHeight
-  ) {
-    return false;
-  }
-  
-  // 比较 children（简单比较，可根据需要深度比较）
-  if (prevProps.children !== nextProps.children) {
-    return false;
-  }
-  
-  // 其他属性相同，不需要重新渲染
-  return true;
-}
-
-// 导出优化后的组件
-export default React.memo(Marker, arePropsEqual);
-

package/src/components/overlays/MultiPoint.tsx

@@ -1,17 +0,0 @@
-
-import { requireNativeViewManager } from 'expo-modules-core';
-import * as React from 'react';
-import type { MultiPointProps } from '../../types';
-
-const NativeMultiPoint = requireNativeViewManager('MultiPointView');
-
-
-/**
- * 高德地图多点标记组件
- * 
- * @param props 多点标记的配置属性，继承自MultiPointProps接口
- * @returns 渲染原生高德地图多点标记组件
- */
-export default function MultiPoint(props: MultiPointProps) {
-  return <NativeMultiPoint {...props} />;
-}

package/src/components/overlays/Polygon.tsx

@@ -1,18 +0,0 @@
-import * as React from 'react';
-import type { PolygonProps } from '../../types';
-
-import { requireNativeViewManager } from 'expo-modules-core';
-const NativePolygonView = requireNativeViewManager<PolygonProps>('PolygonView');
-
-/**
- * 渲染一个高德地图多边形覆盖物组件
- *
- * @param props - 多边形属性配置，继承自PolygonProps类型
- * @returns 高德地图原生多边形视图组件
- */
-function Polygon(props: PolygonProps) {
-  return <NativePolygonView {...props} />;
-}
-
-// 导出优化后的组件
-export default React.memo(Polygon);

package/src/components/overlays/Polyline.tsx

@@ -1,19 +0,0 @@
-
-import * as React from 'react';
-import type { PolylineProps } from '../../types';
-
-import { requireNativeViewManager } from 'expo-modules-core';
-const NativePolylineView = requireNativeViewManager<PolylineProps>('PolylineView');
-
-/**
- * 渲染高德地图上的折线覆盖物组件
- *
- * @param props - 折线属性配置，继承自PolylineProps类型
- * @returns 高德地图原生折线视图组件
- */
-function Polyline(props: PolylineProps) {
-  return <NativePolylineView {...props} />;
-}
-
-// 导出优化后的组件
-export default React.memo(Polyline);

package/src/components/overlays/index.ts

@@ -1,7 +0,0 @@
-export { default as Marker } from './Marker';
-export { default as Polyline } from './Polyline';
-export { default as Polygon } from './Polygon';
-export { default as Circle } from './Circle';
-export { default as HeatMap } from './HeatMap';
-export { default as MultiPoint } from './MultiPoint';
-export { default as Cluster } from './Cluster';

package/src/index.ts

@@ -1,50 +0,0 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-12-03 14:27:06
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-12-09 11:32:54
- * @FilePath     : /expo-gaode-map/packages/core/src/index.ts
- * @Description  : 
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
-// 导出类型定义
-export * from './ExpoGaodeMap.types';
-export * from './types';
-
-// 导出原生模块 - 直接使用，无需封装
-export { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';
-
-// 从 ExpoGaodeMapModule 重新导出类型，方便使用
-export type { SDKConfig, PermissionStatus } from './ExpoGaodeMapModule';
-
-// 导出地图视图组件
-export { default as MapView } from './ExpoGaodeMapView';
-export type { MapViewRef } from './ExpoGaodeMapView';
-
-// 导出覆盖物组件
-export {
-  Marker,
-  Polyline,
-  Polygon,
-  Circle,
-  HeatMap,
-  MultiPoint,
-  Cluster,
-} from './components/overlays';
-
-// 导出模块检测工具
-export {
-  requireModule,
-  OptionalModules,
-  getInstalledModules,
-  printModuleInfo,
-  createLazyLoader,
-} from './utils/ModuleLoader';
-
-// 导出便捷读取的 SDK 配置与 webKey
-export { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';
-
-// 默认导出原生模块
-export { default } from './ExpoGaodeMapModule';