expo-gaode-map 0.1.0

package/src/components/overlays/Polygon.tsx

@@ -0,0 +1,107 @@
+/*
+ * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @Date         : 2025-11-13 15:01:45
+ * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @LastEditTime : 2025-11-13 19:24:22
+ * @FilePath     : /expo-gaode-map/src/components/overlays/Polygon.tsx
+ * @Description  : 地图多边形组件 - 命令式 API
+ * 
+ * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
+ */
+
+
+import { useContext, useEffect, useRef } from 'react';
+import type { PolygonProps } from '../../types';
+import { MapContext } from '../../ExpoGaodeMapView';
+
+/**
+ * 地图多边形组件 - 命令式 API
+ * 
+ * @example
+ * ```tsx
+ * <MapView>
+ *   <Polygon
+ *     points={[
+ *       { latitude: 39.9, longitude: 116.4 },
+ *       { latitude: 39.91, longitude: 116.41 },
+ *       { latitude: 39.92, longitude: 116.40 },
+ *     ]}
+ *     fillColor={0x44FF0000}
+ *     strokeColor={-65536}
+ *     strokeWidth={5}
+ *   />
+ * </MapView>
+ * ```
+ */
+export default function Polygon(props: PolygonProps) {
+  const { points, fillColor, strokeColor, strokeWidth, zIndex } = props;
+  const nativeRef = useContext(MapContext);
+  const polygonIdRef = useRef<string>(`polygon_${Date.now()}_${Math.random()}`);
+
+  useEffect(() => {
+    const polygonId = polygonIdRef.current;
+
+    // 添加多边形
+    if (nativeRef?.current && points && points.length >= 3) {
+      try {
+        console.log('🟦 Polygon 组件调用 addPolygon:', polygonId, {
+          points,
+          fillColor: fillColor ?? 0x440000FF,
+          strokeColor: strokeColor ?? -16776961,
+          strokeWidth: strokeWidth ?? 10,
+          zIndex: zIndex ?? 0,
+        });
+        
+        nativeRef.current.addPolygon(polygonId, {
+          points,
+          fillColor: fillColor ?? 0x440000FF,
+          strokeColor: strokeColor ?? -16776961,
+          strokeWidth: strokeWidth ?? 10,
+          zIndex: zIndex ?? 0,
+        });
+        
+        console.log('✅ Polygon addPolygon 调用完成');
+      } catch (error) {
+        console.error('❌ 添加多边形失败:', error);
+      }
+    } else {
+      console.warn('⚠️ Polygon 组件条件不满足:', {
+        hasNativeRef: !!nativeRef?.current,
+        hasPoints: !!points,
+        pointsLength: points?.length,
+      });
+    }
+
+    // 清理函数
+    return () => {
+      if (nativeRef?.current) {
+        try {
+          nativeRef.current.removePolygon(polygonId);
+        } catch (error) {
+          console.error('移除多边形失败:', error);
+        }
+      }
+    };
+  }, []);
+
+  // 更新多边形属性
+  useEffect(() => {
+    const polygonId = polygonIdRef.current;
+
+    if (nativeRef?.current) {
+      try {
+        nativeRef.current.updatePolygon(polygonId, {
+          points,
+          fillColor,
+          strokeColor,
+          strokeWidth,
+          zIndex,
+        });
+      } catch (error) {
+        console.error('更新多边形失败:', error);
+      }
+    }
+  }, [points, fillColor, strokeColor, strokeWidth, zIndex]);
+
+  return null;
+}

package/src/components/overlays/Polyline.tsx

@@ -0,0 +1,69 @@
+/*
+ * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @Date         : 2025-11-13 15:01:30
+ * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @LastEditTime : 2025-11-13 19:06:00
+ * @FilePath     : /expo-gaode-map/src/components/overlays/Polyline.tsx
+ * @Description  : 地图折线组件 - 使用命令式 API
+ * 
+ * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
+ */
+
+import * as React from 'react';
+import { MapContext } from '../../ExpoGaodeMapView';
+import type { PolylineProps } from '../../types';
+
+/**
+ * 地图折线组件
+ * 
+ * @example
+ * ```tsx
+ * <MapView>
+ *   <Polyline
+ *     points={[
+ *       { latitude: 39.9, longitude: 116.4 },
+ *       { latitude: 39.91, longitude: 116.41 },
+ *     ]}
+ *     color="#FF0000"
+ *     width={5}
+ *   />
+ * </MapView>
+ * ```
+ */
+export default function Polyline(props: PolylineProps) {
+  const mapRef = React.useContext(MapContext);
+  const polylineIdRef = React.useRef<string>(`polyline_${Date.now()}_${Math.random()}`);
+
+  console.log('Polyline 组件渲染，props:', props);
+
+  // 添加折线
+  React.useEffect(() => {
+    const polylineId = polylineIdRef.current;
+    
+    console.log('Polyline useEffect - 添加折线到地图');
+    mapRef?.current?.addPolyline?.(polylineId, props).then(() => {
+      console.log('✅ 折线已添加:', polylineId);
+    }).catch((error: any) => {
+      console.error('❌ 添加折线失败:', error);
+    });
+
+    return () => {
+      console.log('Polyline useEffect cleanup - 移除折线');
+      mapRef?.current?.removePolyline?.(polylineId).catch((error: any) => {
+        console.error('❌ 移除折线失败:', error);
+      });
+    };
+  }, []);
+
+  // 监听 Props 变化，更新折线
+  React.useEffect(() => {
+    const polylineId = polylineIdRef.current;
+    
+    console.log('Polyline props 变化，更新折线:', props);
+    mapRef?.current?.updatePolyline?.(polylineId, props).catch((error: any) => {
+      console.error('❌ 更新折线失败:', error);
+    });
+  }, [props.points, props.width, props.color]);
+
+  return null;
+}

package/src/components/overlays/index.ts

@@ -0,0 +1,18 @@
+/*
+ * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @Date         : 2025-11-13 15:03:10
+ * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @LastEditTime : 2025-11-13 15:03:22
+ * @FilePath     : /expo-gaode-map/src/components/overlays/index.ts
+ * @Description  : 覆盖物组件统一导出
+ * 
+ * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
+ */
+
+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

@@ -0,0 +1,55 @@
+/*
+ * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @Date         : 2025-11-13 14:45:15
+ * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @LastEditTime : 2025-11-13 18:26:20
+ * @FilePath     : /expo-gaode-map/src/index.ts
+ * @Description  : 高德地图 Expo Module 主导出文件
+ * 
+ * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
+ */
+
+// 导出类型定义
+export * from './ExpoGaodeMap.types';
+export * from './types';
+
+// 导出原生模块
+export { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';
+
+// 导出 SDK 模块
+export { default as AMapSDK, initSDK, setApiKey, getVersion } from './modules/AMapSDK';
+
+// 导出定位模块
+export {
+  default as AMapLocation,
+  configure,
+  start,
+  stop,
+  isStarted,
+  getCurrentLocation,
+  addLocationListener,
+  coordinateConvert,
+  startUpdatingHeading,
+  stopUpdatingHeading,
+} from './modules/AMapLocation';
+
+// 地图视图控制已移至 MapView 的 ref 调用
+// 使用方式: const mapRef = useRef<MapViewRef>(null); mapRef.current.moveCamera() 等
+
+// 导出地图视图组件
+export { default as MapView } from './ExpoGaodeMapView';
+export type { MapViewRef } from './ExpoGaodeMapView';
+
+// 导出覆盖物组件
+export {
+  Marker,
+  Polyline,
+  Polygon,
+  Circle,
+  HeatMap,
+  MultiPoint,
+  Cluster,
+} from './components/overlays';
+
+// 默认导出：直接重新导出所有模块
+export { default } from './ExpoGaodeMapModule';

package/src/modules/AMapLocation.ts

@@ -0,0 +1,164 @@
+/*
+ * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @Date         : 2025-11-13 14:42:10
+ * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @LastEditTime : 2025-11-13 14:42:15
+ * @FilePath     : /expo-gaode-map/src/modules/AMapLocation.ts
+ * @Description  : 高德地图定位模块
+ * 
+ * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
+ */
+
+import { EventSubscription } from 'expo-modules-core';
+import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
+import type {
+  Coordinates,
+  ReGeocode,
+  LocationOptions,
+  LocationListener,
+  LatLng,
+  CoordinateType,
+} from '../types';
+
+/**
+ * 配置定位选项
+ */
+export function configure(options: LocationOptions): void {
+  if (options.withReGeocode !== undefined) {
+    ExpoGaodeMapModule.setLocatingWithReGeocode?.(options.withReGeocode);
+  }
+  if (options.accuracy !== undefined) {
+    ExpoGaodeMapModule.setDesiredAccuracy?.(options.accuracy);
+  }
+  if (options.mode !== undefined) {
+    ExpoGaodeMapModule.setLocationMode?.(options.mode);
+  }
+  if (options.onceLocation !== undefined) {
+    ExpoGaodeMapModule.setOnceLocation?.(options.onceLocation);
+  }
+  if (options.interval !== undefined) {
+    ExpoGaodeMapModule.setInterval?.(options.interval);
+  }
+  if (options.timeout !== undefined) {
+    ExpoGaodeMapModule.setLocationTimeout?.(options.timeout);
+  }
+  if (options.reGeocodeTimeout !== undefined) {
+    ExpoGaodeMapModule.setReGeocodeTimeout?.(options.reGeocodeTimeout);
+  }
+  if (options.distanceFilter !== undefined) {
+    ExpoGaodeMapModule.setDistanceFilter?.(options.distanceFilter);
+  }
+  if (options.sensorEnable !== undefined) {
+    ExpoGaodeMapModule.setSensorEnable?.(options.sensorEnable);
+  }
+  if (options.wifiScan !== undefined) {
+    ExpoGaodeMapModule.setWifiScan?.(options.wifiScan);
+  }
+  if (options.gpsFirst !== undefined) {
+    ExpoGaodeMapModule.setGpsFirst?.(options.gpsFirst);
+  }
+  if (options.onceLocationLatest !== undefined) {
+    ExpoGaodeMapModule.setOnceLocationLatest?.(options.onceLocationLatest);
+  }
+  if (options.geoLanguage !== undefined) {
+    ExpoGaodeMapModule.setGeoLanguage?.(options.geoLanguage);
+  }
+  if (options.allowsBackgroundLocationUpdates !== undefined) {
+    ExpoGaodeMapModule.setAllowsBackgroundLocationUpdates?.(options.allowsBackgroundLocationUpdates);
+  }
+  if (options.pausesLocationUpdatesAutomatically !== undefined) {
+    ExpoGaodeMapModule.setPausesLocationUpdatesAutomatically?.(options.pausesLocationUpdatesAutomatically);
+  }
+  if (options.locationCacheEnable !== undefined) {
+    ExpoGaodeMapModule.setLocationCacheEnable?.(options.locationCacheEnable);
+  }
+  if (options.httpTimeout !== undefined) {
+    ExpoGaodeMapModule.setHttpTimeOut?.(options.httpTimeout);
+  }
+  if (options.protocol !== undefined) {
+    ExpoGaodeMapModule.setLocationProtocol?.(options.protocol);
+  }
+}
+
+/**
+ * 开始连续定位
+ */
+export function start(): void {
+  ExpoGaodeMapModule.start?.();
+}
+
+/**
+ * 停止定位
+ */
+export function stop(): void {
+  ExpoGaodeMapModule.stop?.();
+}
+
+/**
+ * 是否正在定位
+ */
+export async function isStarted(): Promise<boolean> {
+  return ExpoGaodeMapModule.isStarted?.() || Promise.resolve(false);
+}
+
+/**
+ * 获取当前位置（单次定位）
+ */
+export async function getCurrentLocation(): Promise<Coordinates | ReGeocode> {
+  return ExpoGaodeMapModule.getCurrentLocation?.();
+}
+
+/**
+ * 添加定位监听器
+ */
+export function addLocationListener(listener: LocationListener): EventSubscription {
+  return ExpoGaodeMapModule.addListener?.('onLocationUpdate', listener) || {
+    remove: () => {},
+  } as EventSubscription;
+}
+
+/**
+ * 坐标转换
+ */
+export async function coordinateConvert(
+  coordinate: LatLng,
+  type: CoordinateType
+): Promise<LatLng> {
+  return ExpoGaodeMapModule.coordinateConvert?.(coordinate, type) || Promise.resolve(coordinate);
+}
+
+/**
+ * 开始获取设备朝向
+ * @platform ios
+ */
+export function startUpdatingHeading(): void {
+  ExpoGaodeMapModule.startUpdatingHeading?.();
+}
+
+/**
+ * 停止获取设备朝向
+ * @platform ios
+ */
+export function stopUpdatingHeading(): void {
+  ExpoGaodeMapModule.stopUpdatingHeading?.();
+}
+
+/**
+ * 设置 API Key
+ */
+export function setApiKey(key: string): void {
+  ExpoGaodeMapModule.setApiKey?.(key);
+}
+
+export default {
+  configure,
+  start,
+  stop,
+  isStarted,
+  getCurrentLocation,
+  addLocationListener,
+  coordinateConvert,
+  startUpdatingHeading,
+  stopUpdatingHeading,
+  setApiKey,
+};

package/src/modules/AMapSDK.ts

@@ -0,0 +1,48 @@
+/*
+ * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @Date         : 2025-11-13 14:41:55
+ * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @LastEditTime : 2025-11-13 14:42:00
+ * @FilePath     : /expo-gaode-map/src/modules/AMapSDK.ts
+ * @Description  : 
+ * 
+ * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
+ */
+/**
+ * 高德地图 SDK 模块
+ * 基于 Expo Modules 实现
+ */
+
+import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
+import type { SDKConfig } from '../types';
+
+/**
+ * 初始化高德地图 SDK
+ * @param config SDK 配置
+ */
+export function initSDK(config: SDKConfig): void {
+  const apiKey = config.iosKey || config.androidKey || '';
+  ExpoGaodeMapModule.setApiKey?.(apiKey);
+}
+
+/**
+ * 设置 API Key
+ * @param key API 密钥
+ */
+export function setApiKey(key: string): void {
+  ExpoGaodeMapModule.setApiKey?.(key);
+}
+
+/**
+ * 获取 SDK 版本号
+ * @returns SDK 版本
+ */
+export async function getVersion(): Promise<string> {
+  return ExpoGaodeMapModule.getVersion?.() || Promise.resolve('unknown');
+}
+
+export default {
+  initSDK,
+  setApiKey,
+  getVersion,
+};

package/src/modules/AMapView.ts

@@ -0,0 +1,68 @@
+/*
+ * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @Date         : 2025-11-13 14:57:30
+ * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @LastEditTime : 2025-11-13 14:57:35
+ * @FilePath     : /expo-gaode-map/src/modules/AMapView.ts
+ * @Description  : 高德地图视图控制模块
+ * 
+ * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
+ */
+
+import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
+import type { CameraPosition, Point, LatLng } from '../types';
+
+/**
+ * 移动地图相机到指定位置
+ * @param cameraPosition 相机位置参数
+ * @param duration 动画时长（毫秒），默认为0（无动画）
+ */
+export function moveCamera(cameraPosition: CameraPosition, duration = 0): void {
+  ExpoGaodeMapModule.moveCamera?.(cameraPosition, duration);
+}
+
+/**
+ * 将屏幕坐标转换为地理坐标
+ * @param point 屏幕坐标点
+ * @returns 地理坐标
+ */
+export async function getLatLng(point: Point): Promise<LatLng> {
+  return ExpoGaodeMapModule.getLatLng?.(point) || Promise.resolve({ latitude: 0, longitude: 0 });
+}
+
+/**
+ * 设置地图中心点
+ * @param center 中心点坐标
+ * @param animated 是否使用动画
+ */
+export function setCenter(center: LatLng, animated = true): void {
+  ExpoGaodeMapModule.setCenter?.(center, animated);
+}
+
+/**
+ * 设置地图缩放级别
+ * @param zoom 缩放级别（3-20）
+ * @param animated 是否使用动画
+ */
+export function setZoom(zoom: number, animated = true): void {
+  ExpoGaodeMapModule.setZoom?.(zoom, animated);
+}
+
+/**
+ * 获取当前地图状态
+ * @returns 当前相机位置
+ */
+export async function getCameraPosition(): Promise<CameraPosition> {
+  return ExpoGaodeMapModule.getCameraPosition?.() || Promise.resolve({
+    target: { latitude: 0, longitude: 0 },
+    zoom: 10,
+  });
+}
+
+export default {
+  moveCamera,
+  getLatLng,
+  setCenter,
+  setZoom,
+  getCameraPosition,
+};