expo-gaode-map-navigation 1.0.1-next.0

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

@@ -0,0 +1,404 @@
+/**
+ * 高德地图覆盖物相关类型定义
+ * 基于 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

@@ -0,0 +1,23 @@
+/**
+ * 通用事件管理器
+ * 用于管理地图覆盖物的事件回调
+ */
+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

@@ -0,0 +1,115 @@
+/**
+ * 模块检测器 - 用于检测可选模块是否已安装
+ */
+
+/**
+ * 可选模块名称常量
+ */
+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

@@ -0,0 +1,25 @@
+/**
+ * 导航模块坐标类型定义
+ * 简化版本，仅包含导航所需的基础坐标
+ */
+
+/**
+ * 导航坐标点（简化版）
+ */
+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;