expo-gaode-map-navigation 1.1.0 → 1.1.2-next.0

package/src/map/types/overlays.types.ts

@@ -1,404 +0,0 @@
-/**
- * 高德地图覆盖物相关类型定义
- * 基于 Expo Modules API
- */
-
-import type { ImageSourcePropType, ViewStyle, NativeSyntheticEvent } from 'react-native';
-import type { ColorValue, LatLng, Point } from './common.types';
-
-/**
- * 标记点属性
- */
-export interface MarkerProps {
-  /**
-   * 坐标
-   */
-  position: LatLng;
-
-  /**
-   * 图标
-   */
-  icon?: string | ImageSourcePropType;
-
-  /**
-   * 图标宽度（像素）
-   * 仅在使用 icon 属性时有效
-   */
-  iconWidth?: number;
-
-  /**
-   * 图标高度（像素）
-   * 仅在使用 icon 属性时有效
-   */
-  iconHeight?: number;
-
-  /**
-   * 标题
-   */
-  title?: string;
-
-  /**
-   * 描述
-   */
-  snippet?: string;
-
-  /**
-   * 透明度 [0, 1]
-   * @platform android
-   * @note iOS 不支持
-   */
-  opacity?: number;
-
-  /**
-   * 是否可拖拽
-   */
-  draggable?: boolean;
-
-  /**
-   * 是否平贴地图
-   * @platform android
-   * @note iOS 不支持
-   */
-  flat?: boolean;
-
-  /**
-   * 层级
-   * @platform android
-   * @note iOS 不支持 (使用 displayPriority)
-   */
-  zIndex?: number;
-
-  /**
-   * 覆盖物锚点比例
-   * @platform android
-   * @note iOS 使用 centerOffset
-   */
-  anchor?: Point;
-
-  /**
-   * 覆盖物偏移位置
-   * @platform ios
-   */
-  centerOffset?: Point;
-
-  /**
-   * 是否显示动画
-   * @platform ios
-   */
-  animatesDrop?: boolean;
-
-  /**
-   * 大头针颜色
-   * Android 支持更多颜色，iOS 只支持 red, green, purple
-   */
-  pinColor?: 'red' | 'orange' | 'yellow' | 'green' | 'cyan' | 'blue' | 'violet' | 'magenta' | 'rose' | 'purple';
-
-  /**
-   * 自定义视图
-   * 当使用 children 时，会将 React Native 组件渲染为图片显示在地图上
-   */
-  children?: React.ReactNode;
-
-  /**
-   * 自定义视图宽度（像素）
-   * 仅在使用 children 属性时有效 
-   * @default 80
-   */
-  customViewWidth?: number;
-
-  /**
-   * 自定义视图高度（像素）
-   * 仅在使用 children 属性时有效
-   * @default 30
-   */
-  customViewHeight?: number;
-
-  /**
-   * 点击事件
-   */
-  onMarkerPress?: (event: NativeSyntheticEvent<LatLng>) => void;
-
-  /**
-   * 拖拽开始事件
-   */
-  onMarkerDragStart?: (event: NativeSyntheticEvent<LatLng>) => void;
-
-  /**
-   * 拖拽中事件
-   */
-  onMarkerDrag?: (event: NativeSyntheticEvent<LatLng>) => void;
-
-  /**
-   * 拖拽结束事件
-   */
-  onMarkerDragEnd?: (event: NativeSyntheticEvent<LatLng>) => void;
-}
-
-/**
- * 折线属性
- */
-export interface PolylineProps {
-  /**
-   * 节点坐标数组
-   */
-  points: LatLng[];
-
-  /**
-   * 线宽
-   */
-  strokeWidth?: number;
-
-  /**
-   * 线条颜色
-   */
-  strokeColor?: ColorValue;
-
-  /**
-   * 层级
-   */
-  zIndex?: number;
-
-  /**
-   * 分段颜色
-   */
-  colors?: ColorValue[];
-
-  /**
-   * 是否使用渐变色
-   * @platform android
-   * @note iOS 不支持
-   */
-  gradient?: boolean;
-
-  /**
-   * 是否绘制大地线
-   * @platform android
-   * @note iOS 不支持
-   */
-  geodesic?: boolean;
-
-  /**
-   * 是否绘制虚线
-   * @platform android
-   * @note iOS 不支持
-   */
-  dotted?: boolean;
-
-  /**
-   * 纹理图片
-   * 支持网络图片(http/https)、本地文件(file://)或资源名称
-   */
-  texture?: string;
-
-  /**
-   * 点击事件
-   */
-  onPolylinePress?: (event: NativeSyntheticEvent<{}>) => void;
-}
-
-/**
- * 多边形属性
- */
-export interface PolygonProps {
-  /**
-   * 节点坐标数组
-   */
-  points: LatLng[];
-
-  /**
-   * 边线宽度
-   */
-  strokeWidth?: number;
-
-  /**
-   * 边线颜色
-   */
-  strokeColor?: ColorValue;
-
-  /**
-   * 填充颜色
-   */
-  fillColor?: ColorValue;
-
-  /**
-   * 层级
-   */
-  zIndex?: number;
-
-  /**
-   * 点击事件
-   */
-  onPolygonPress?: (event: NativeSyntheticEvent<{}>) => void;
-}
-
-/**
- * 圆形属性
- */
-export interface CircleProps {
-  /**
-   * 圆心坐标
-   */
-  center: LatLng;
-
-  /**
-   * 半径（米）
-   */
-  radius: number;
-
-  /**
-   * 边线宽度
-   */
-  strokeWidth?: number;
-
-  /**
-   * 边线颜色
-   */
-  strokeColor?: ColorValue;
-
-  /**
-   * 填充颜色
-   */
-  fillColor?: ColorValue;
-
-  /**
-   * 层级
-   */
-  zIndex?: number;
-
-  /**
-   * 点击事件
-   */
-  onCirclePress?: (event: NativeSyntheticEvent<{}>) => void;
-
-
-}
-
-/**
- * 热力图属性
- */
-export interface HeatMapProps {
-  /**
-   * 热力点数据
-   */
-  data: LatLng[];
-
-  /**
-   * 热力半径（米）
-   */
-  radius?: number;
-
-  /**
-   * 透明度 [0, 1]
-   */
-  opacity?: number;
-}
-
-/**
- * 海量点标记项
- */
-export interface MultiPointItem extends LatLng {
-  /**
-   * 唯一标识
-   */
-  id?: string | number;
-
-  /**
-   * 自定义数据
-   */
-  data?: any;
-}
-
-/**
- * 海量点属性
- */
-export interface MultiPointProps {
-  /**
-   * 点集合
-   */
-  items: MultiPointItem[];
-
-  /**
-   * 图标
-   */
-  icon?: ImageSourcePropType;
-
-  /**
-   * 点击事件
-   */
-  onPress?: (event: NativeSyntheticEvent<{ index: number; item: MultiPointItem }>) => void;
-}
-
-/**
- * 聚合点参数
- */
-export interface ClusterParams {
-  /**
-   * 唯一标识
-   */
-  id: number;
-
-  /**
-   * 包含的标记点数量
-   */
-  count: number;
-
-  /**
-   * 聚合点坐标
-   */
-  position: LatLng;
-}
-
-/**
- * 聚合点项
- */
-export interface ClusterPoint {
-  /**
-   * 坐标
-   */
-  position: LatLng;
-
-  /**
-   * 自定义数据
-   */
-  properties?: any;
-}
-
-/**
- * 聚合图层属性
- */
-export interface ClusterProps {
-  /**
-   * 聚合半径
-   */
-  radius?: number;
-
-  /**
-   * 聚合点样式
-   */
-  clusterStyle?: ViewStyle;
-
-  /**
-   * 聚合点文本样式
-   */
-  clusterTextStyle?: ViewStyle;
-
-  /**
-   * 坐标点列表
-   */
-  points: ClusterPoint[];
-
-  /**
-   * 渲染标记点
-   */
-  renderMarker: (item: ClusterPoint) => React.ReactNode;
-
-  /**
-   * 渲染聚合点
-   */
-  renderCluster?: (params: ClusterParams) => React.ReactNode;
-
-  /**
-   * 聚合点点击事件
-   */
-  onPress?: (event: NativeSyntheticEvent<ClusterParams>) => void;
-}

package/src/map/utils/EventManager.ts

@@ -1,23 +0,0 @@
-/**
- * 通用事件管理器
- * 用于管理地图覆盖物的事件回调
- */
-export class EventManager<T extends Record<string, any>> {
-  private callbacks = new Map<string, T>();
-  
-  register(id: string, callbacks: T) {
-    this.callbacks.set(id, callbacks);
-  }
-  
-  unregister(id: string) {
-    this.callbacks.delete(id);
-  }
-  
-  trigger<K extends keyof T>(id: string, eventType: K, data?: any) {
-    const callbacks = this.callbacks.get(id);
-    const callback = callbacks?.[eventType];
-    if (typeof callback === 'function') {
-      callback(data);
-    }
-  }
-}

package/src/map/utils/ModuleLoader.ts

@@ -1,115 +0,0 @@
-/**
- * 模块检测器 - 用于检测可选模块是否已安装
- */
-
-/**
- * 可选模块名称常量
- */
-export const OptionalModules = {
-  SEARCH: 'expo-gaode-map-search',
-  NAVIGATION: 'expo-gaode-map-navigation',
-  ROUTE: 'expo-gaode-map-route',
-  GEOCODER: 'expo-gaode-map-geocoder',
-} as const;
-
-/**
- * 延迟加载可选模块
- * 使用示例:
- * 
- * @example
- * ```typescript
- * import { OptionalModules, lazyLoad } from 'expo-gaode-map';
- * 
- * let SearchModule = null;
- * 
- * function loadSearch() {
- *   if (SearchModule == null) {
- *     try {
- *       SearchModule = require('expo-gaode-map-search');
- *     } catch (error) {
- *       console.warn('搜索模块未安装');
- *       return null;
- *     }
- *   }
- *   return SearchModule;
- * }
- * 
- * // 使用
- * const search = loadSearch();
- * if (search) {
- *   const results = await search.searchPOI({ keyword: '餐厅' });
- * }
- * ```
- */
-
-/**
- * 检查必需模块,如果未安装则抛出错误
- * @param moduleName 模块名称
- * @param featureName 功能名称(用于错误提示)
- */
-export function requireModule(moduleName: string, featureName: string): void {
-  console.warn(
-    `[expo-gaode-map] 使用 ${featureName} 需要安装 ${moduleName}。\n` +
-    `请运行: npm install ${moduleName}\n` +
-    `然后使用 try-catch 包裹 require('${moduleName}') 来加载`
-  );
-}
-
-/**
- * 获取已安装的可选模块列表
- * 注意: 此函数无法在运行时准确检测,仅作为文档说明
- */
-export function getInstalledModules(): string[] {
-  console.warn(
-    '[expo-gaode-map] getInstalledModules() 无法在运行时检测。\n' +
-    '请在编译时检查 package.json 中安装的模块'
-  );
-  return [];
-}
-
-/**
- * 打印已安装模块信息(用于调试)
- */
-export function printModuleInfo(): void {
-  console.log('[expo-gaode-map] 核心模块: 已加载');
-  console.log('[expo-gaode-map] 可选模块检测:');
-  console.log('  - 使用 try-catch 包裹 require() 来检测可选模块');
-  console.log('  - 可用的可选模块:');
-  Object.entries(OptionalModules).forEach(([key, value]) => {
-    console.log(`    - ${key}: ${value}`);
-  });
-}
-
-/**
- * 创建延迟加载器
- * 
- * @example
- * ```typescript
- * import { createLazyLoader } from 'expo-gaode-map';
- * 
- * const loadSearch = createLazyLoader(() => require('expo-gaode-map-search'));
- * 
- * // 使用时
- * const SearchModule = loadSearch();
- * if (SearchModule) {
- *   const results = await SearchModule.searchPOI({ keyword: '餐厅' });
- * }
- * ```
- */
-export function createLazyLoader<T>(loader: () => T): () => T | null {
-  let cached: T | null = null;
-  let attempted = false;
-
-  return () => {
-    if (!attempted) {
-      attempted = true;
-      try {
-        cached = loader();
-      } catch (error) {
-        console.warn('[expo-gaode-map] 模块加载失败:', error);
-        cached = null;
-      }
-    }
-    return cached;
-  };
-}

package/src/types/coordinates.types.ts

@@ -1,25 +0,0 @@
-/**
- * 导航模块坐标类型定义
- * 简化版本，仅包含导航所需的基础坐标
- */
-
-/**
- * 导航坐标点（简化版）
- */
-export interface NaviPoint {
-  latitude: number;
-  longitude: number;
-}
-
-/**
- * 带名称的坐标点（POI）
- */
-export interface NamedCoordinates extends NaviPoint {
-  /** 名称 */
-  name?: string;
-  /** POI ID */
-  poiId?: string;
-}
-
-// 为了向后兼容，导出 NaviPoint 作为 Coordinates 别名
-export type Coordinates = NaviPoint;