expo-gaode-map 0.1.0

package/src/types/overlays.types.ts

@@ -0,0 +1,346 @@
+/**
+ * 高德地图覆盖物相关类型定义
+ * 基于 Expo Modules API
+ */
+
+import type { ImageSourcePropType, ViewStyle } from 'react-native';
+import type { ColorValue, LatLng, Point } from './common.types';
+
+/**
+ * 标记点属性
+ */
+export interface MarkerProps {
+  /**
+   * 坐标
+   */
+  position: LatLng;
+
+  /**
+   * 图标
+   */
+  icon?: ImageSourcePropType;
+
+  /**
+   * 标题
+   */
+  title?: string;
+
+  /**
+   * 描述
+   */
+  snippet?: string;
+
+  /**
+   * 透明度 [0, 1]
+   * @platform android
+   */
+  opacity?: number;
+
+  /**
+   * 是否可拖拽
+   */
+  draggable?: boolean;
+
+  /**
+   * 是否平贴地图
+   * @platform android
+   */
+  flat?: boolean;
+
+  /**
+   * 层级
+   */
+  zIndex?: number;
+
+  /**
+   * 覆盖物锚点比例
+   * @platform android
+   */
+  anchor?: Point;
+
+  /**
+   * 覆盖物偏移位置
+   * @platform ios
+   */
+  centerOffset?: Point;
+
+  /**
+   * 自定义视图
+   */
+  children?: React.ReactNode;
+
+  /**
+   * 点击事件
+   */
+  onPress?: () => void;
+
+  /**
+   * 拖拽开始事件
+   */
+  onDragStart?: () => void;
+
+  /**
+   * 拖拽中事件
+   */
+  onDrag?: () => void;
+
+  /**
+   * 拖拽结束事件
+   */
+  onDragEnd?: (event: { nativeEvent: LatLng }) => void;
+}
+
+/**
+ * 折线属性
+ */
+export interface PolylineProps {
+  /**
+   * 节点坐标数组
+   */
+  points: LatLng[];
+
+  /**
+   * 线宽
+   */
+  width?: number;
+
+  /**
+   * 线条颜色
+   */
+  color?: ColorValue;
+
+  /**
+   * 层级
+   */
+  zIndex?: number;
+
+  /**
+   * 分段颜色
+   */
+  colors?: ColorValue[];
+
+  /**
+   * 是否使用渐变色
+   */
+  gradient?: boolean;
+
+  /**
+   * 是否绘制大地线
+   */
+  geodesic?: boolean;
+
+  /**
+   * 是否绘制虚线
+   */
+  dotted?: boolean;
+
+  /**
+   * 点击事件
+   */
+  onPress?: () => void;
+}
+
+/**
+ * 多边形属性
+ */
+export interface PolygonProps {
+  /**
+   * 节点坐标数组
+   */
+  points: LatLng[];
+
+  /**
+   * 边线宽度
+   */
+  strokeWidth?: number;
+
+  /**
+   * 边线颜色
+   */
+  strokeColor?: ColorValue;
+
+  /**
+   * 填充颜色
+   */
+  fillColor?: ColorValue;
+
+  /**
+   * 层级
+   */
+  zIndex?: number;
+
+  /**
+   * 点击事件
+   */
+  onPress?: () => void;
+}
+
+/**
+ * 圆形属性
+ */
+export interface CircleProps {
+  /**
+   * 圆心坐标
+   */
+  center: LatLng;
+
+  /**
+   * 半径（米）
+   */
+  radius: number;
+
+  /**
+   * 边线宽度
+   */
+  strokeWidth?: number;
+
+  /**
+   * 边线颜色
+   */
+  strokeColor?: ColorValue;
+
+  /**
+   * 填充颜色
+   */
+  fillColor?: ColorValue;
+
+  /**
+   * 层级
+   */
+  zIndex?: number;
+
+  /**
+   * 点击事件
+   */
+  onPress?: () => 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: { nativeEvent: { 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?: (params: ClusterParams) => void;
+}

package/src/types/sdk.types.ts

@@ -0,0 +1,128 @@
+/**
+ * 高德地图 SDK 模块类型定义
+ * 基于 Expo Modules API
+ */
+
+import type { LatLng } from './common.types';
+import type { 
+  Coordinates, 
+  ReGeocode, 
+  LocationOptions, 
+  LocationListener,
+  CoordinateType 
+} from './location.types';
+
+/**
+ * SDK 初始化配置
+ */
+export interface SDKConfig {
+  /**
+   * iOS API Key
+   */
+  iosKey?: string;
+
+  /**
+   * Android API Key
+   */
+  androidKey?: string;
+}
+
+/**
+ * 高德地图 SDK 模块接口
+ */
+export interface AMapSDKModule {
+  /**
+   * 初始化 SDK
+   * @param config SDK配置
+   */
+  initSDK(config: SDKConfig): void;
+
+  /**
+   * 获取 SDK 版本号
+   */
+  getVersion(): Promise<string>;
+
+  /**
+   * 设置 API Key（单平台）
+   * @param key API密钥
+   */
+  setApiKey(key: string): void;
+}
+
+/**
+ * 高德定位模块接口
+ */
+export interface AMapLocationModule {
+  /**
+   * 配置定位选项
+   * @param options 定位配置选项
+   */
+  configure(options: LocationOptions): void;
+
+  /**
+   * 开始连续定位
+   */
+  start(): void;
+
+  /**
+   * 停止定位
+   */
+  stop(): void;
+
+  /**
+   * 是否正在定位
+   */
+  isStarted(): Promise<boolean>;
+
+  /**
+   * 获取当前位置（单次定位）
+   */
+  getCurrentLocation(): Promise<Coordinates | ReGeocode>;
+
+  /**
+   * 添加定位监听器
+   * @param listener 定位回调函数
+   * @returns 订阅对象，用于取消监听
+   */
+  addLocationListener(listener: LocationListener): { remove: () => void };
+
+  /**
+   * 坐标转换
+   * @param coordinate 待转换的坐标
+   * @param type 坐标系类型
+   */
+  coordinateConvert(coordinate: LatLng, type: CoordinateType): Promise<LatLng>;
+
+  /**
+   * 开始获取设备朝向
+   * @platform ios
+   */
+  startUpdatingHeading(): void;
+
+  /**
+   * 停止获取设备朝向
+   * @platform ios
+   */
+  stopUpdatingHeading(): void;
+}
+
+/**
+ * 模块事件类型
+ */
+export interface ModuleEvents {
+  /**
+   * 定位更新事件
+   */
+  onLocationUpdate: (location: Coordinates | ReGeocode) => void;
+
+  /**
+   * 定位错误事件
+   */
+  onLocationError: (error: { code: number; message: string }) => void;
+
+  /**
+   * 朝向更新事件
+   * @platform ios
+   */
+  onHeadingUpdate: (heading: { magneticHeading: number; trueHeading: number }) => void;
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+// @generated by expo-module-scripts
+{
+  "extends": "expo-module-scripts/tsconfig.base",
+  "compilerOptions": {
+    "outDir": "./build"
+  },
+  "include": ["./src"],
+  "exclude": ["**/__mocks__/*", "**/__tests__/*", "**/__rsc_tests__/*"]
+}