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

package/src/map/types/location.types.ts

@@ -0,0 +1,368 @@
+/**
+ * 高德地图定位相关类型定义
+ * 基于 Expo Modules API
+ */
+
+import type { LatLng } from './common.types';
+
+/**
+ * 坐标信息（基础定位）
+ */
+export interface Coordinates extends LatLng {
+  /**
+   * 海拔高度（米）
+   */
+  altitude: number;
+
+  /**
+   * 水平精度（米）
+   */
+  accuracy: number;
+
+  /**
+   * 移动方向（度，需要 GPS）
+   */
+  heading: number;
+
+  /**
+   * 移动速度（米/秒，需要 GPS）
+   */
+  speed: number;
+
+  /**
+   * 时间戳
+   */
+  timestamp: number;
+
+  /**
+   * 是否有可用坐标
+   * @platform ios
+   */
+  isAvailableCoordinate?: boolean;
+
+  /**
+   * 格式化地址（仅在启用逆地理编码时可用）
+   */
+  address?: string;
+}
+
+/**
+ * 逆地理编码信息
+ */
+export interface ReGeocode extends Coordinates {
+  /**
+   * 格式化地址
+   */
+  address: string;
+
+  /**
+   * 国家
+   */
+  country: string;
+
+  /**
+   * 省/直辖市，如 `湖北省`
+   */
+  province: string;
+
+  /**
+   * 市，如 `武汉市`
+   */
+  city: string;
+
+  /**
+   * 区，如 `武昌区`
+   */
+  district: string;
+
+  /**
+   * 城市编码
+   */
+  cityCode: string;
+
+  /**
+   * 区域编码
+   */
+  adCode: string;
+
+  /**
+   * 街道名称
+   */
+  street: string;
+
+  /**
+   * 门牌号
+   */
+  streetNumber: string;
+
+  /**
+   * 兴趣点名称
+   */
+  poiName: string;
+
+  /**
+   * 所属兴趣点名称
+   */
+  aoiName: string;
+
+  /**
+   * 定位信息描述
+   * @platform android
+   */
+  description?: string;
+
+  /**
+   * 坐标系类型
+   * @platform android
+   */
+  coordType?: 'GCJ02' | 'WGS84';
+
+  /**
+   * 室内定位建筑物ID
+   * @platform android
+   */
+  buildingId?: string;
+}
+
+/**
+ * 定位精度级别
+ * @platform ios
+ */
+export enum LocationAccuracy {
+  /**
+   * 最适合导航
+   */
+  BestForNavigation = 0,
+
+  /**
+   * 最高精度（约10米，耗时约10秒）
+   */
+  Best = 1,
+
+  /**
+   * 10米精度
+   */
+  NearestTenMeters = 2,
+
+  /**
+   * 100米精度（推荐）
+   */
+  HundredMeters = 3,
+
+  /**
+   * 1公里精度
+   */
+  Kilometer = 4,
+
+  /**
+   * 3公里精度
+   */
+  ThreeKilometers = 5,
+}
+
+/**
+ * 定位模式
+ * @platform android
+ */
+export enum LocationMode {
+  /**
+   * 高精度模式（网络+卫星）
+   */
+  HighAccuracy = 1,
+
+  /**
+   * 低功耗模式（仅网络）
+   */
+  BatterySaving = 2,
+
+  /**
+   * 仅设备模式（仅卫星）
+   */
+  DeviceSensors = 3,
+}
+
+/**
+ * 坐标系类型
+ */
+export enum CoordinateType {
+  /**
+   * 高德坐标系
+   */
+  AMap = -1,
+
+  /**
+   * 百度坐标系
+   */
+  Baidu = 0,
+
+  /**
+   * MapBar坐标系
+   */
+  MapBar = 1,
+
+  /**
+   * MapABC坐标系
+   */
+  MapABC = 2,
+
+  /**
+   * 搜搜地图坐标系
+   */
+  SoSoMap = 3,
+
+  /**
+   * 阿里云坐标系
+   */
+  AliYun = 4,
+
+  /**
+   * 谷歌坐标系
+   */
+  Google = 5,
+
+  /**
+   * GPS坐标系
+   */
+  GPS = 6,
+}
+
+/**
+ * 地理语言
+ */
+export type GeoLanguage = 'DEFAULT' | 'EN' | 'ZH';
+
+/**
+ * 网络协议
+ * @platform android
+ */
+export type LocationProtocol = 'HTTP' | 'HTTPS';
+
+/**
+ * 定位配置选项
+ */
+export interface LocationOptions {
+  /**
+   * 是否返回逆地理信息
+   * @default true
+   */
+  withReGeocode?: boolean;
+
+  /**
+   * 定位精度
+   * @platform ios
+   */
+  accuracy?: LocationAccuracy;
+
+  /**
+   * 定位模式
+   * @platform android
+   */
+  mode?: LocationMode;
+
+  /**
+   * 是否单次定位
+   * @platform android
+   * @default false
+   */
+  onceLocation?: boolean;
+
+  /**
+   * 定位间隔（毫秒）
+   * @platform android
+   * @default 2000
+   */
+  interval?: number;
+
+  /**
+   * 定位超时时间（秒）
+   * @platform ios
+   * @default 10
+   */
+  timeout?: number;
+
+  /**
+   * 逆地理编码超时时间（秒）
+   * @platform ios
+   * @default 2
+   */
+  reGeocodeTimeout?: number;
+
+  /**
+   * 最小更新距离（米）
+   * @platform ios
+   */
+  distanceFilter?: number;
+
+  /**
+   * 是否启用设备传感器
+   * @platform android
+   * @default false
+   */
+  sensorEnable?: boolean;
+
+  /**
+   * 是否允许WIFI刷新
+   * @platform android
+   * @default true
+   */
+  wifiScan?: boolean;
+
+  /**
+   * 是否GPS优先
+   * @platform android
+   * @default false
+   */
+  gpsFirst?: boolean;
+
+  /**
+   * 是否等待WIFI列表刷新
+   * 定位精度会更高，但是定位速度会变慢1-3秒
+   * @platform android
+   * @default false
+   */
+  onceLocationLatest?: boolean;
+
+  /**
+   * 逆地理语言
+   */
+  geoLanguage?: GeoLanguage;
+
+  /**
+   * 是否允许后台定位
+   * @default false
+   */
+  allowsBackgroundLocationUpdates?: boolean;
+
+  /**
+   * 是否自动暂停定位
+   * @platform ios
+   * @default false
+   */
+  pausesLocationUpdatesAutomatically?: boolean;
+
+  /**
+   * 是否使用缓存策略
+   * @platform android
+   * @default true
+   */
+  locationCacheEnable?: boolean;
+
+  /**
+   * 网络请求超时时间（毫秒）
+   * @platform android
+   * @default 30000
+   */
+  httpTimeout?: number;
+
+  /**
+   * 网络协议
+   * @platform android
+   * @default 'HTTP'
+   */
+  protocol?: LocationProtocol;
+}
+
+/**
+ * 定位事件监听器
+ */
+export type LocationListener = (location: Coordinates | ReGeocode) => void;

package/src/map/types/map-view.types.ts

@@ -0,0 +1,281 @@
+/**
+ * 高德地图视图相关类型定义
+ * 基于 Expo Modules API
+ */
+
+import type { StyleProp, ViewStyle, NativeSyntheticEvent } from 'react-native';
+import type { CameraPosition, LatLng, LatLngBounds, MapPoi, MapType, Point } from './common.types';
+
+/**
+ * 定位事件数据
+ */
+export interface LocationEvent {
+  /**
+   * 纬度
+   */
+  latitude: number;
+  
+  /**
+   * 经度
+   */
+  longitude: number;
+  
+  /**
+   * 定位精度（米）
+   */
+  accuracy: number;
+}
+
+
+/**
+ * 地图相机事件
+ */
+export interface CameraEvent {
+  /**
+   * 相机位置
+   */
+  cameraPosition: CameraPosition;
+
+  /**
+   * 可见区域边界
+   */
+  latLngBounds: LatLngBounds;
+}
+
+/**
+ * 地图视图属性
+ */
+export interface MapViewProps {
+  /**
+   * 地图类型
+   */
+  mapType?: MapType;
+
+  /**
+   * 初始相机位置
+   */
+  initialCameraPosition?: CameraPosition;
+
+  /**
+   * 是否显示当前定位
+   */
+  myLocationEnabled?: boolean;
+
+  /**
+   * 是否跟随用户位置
+   * @default false
+   */
+  followUserLocation?: boolean;
+
+  /**
+   * 定位蓝点配置
+   */
+  userLocationRepresentation?: {
+    /** 精度圈是否显示 @default true */
+    showsAccuracyRing?: boolean;
+    /** 是否显示方向指示 @default true @platform ios */
+    showsHeadingIndicator?: boolean;
+    /** 精度圈填充颜色 支持 '#RRGGBB'、'red' 或 ARGB 数字 */
+    fillColor?: string | number;
+    /** 精度圈边线颜色 */
+    strokeColor?: string | number;
+    /** 精度圈边线宽度 @default 0 */
+    lineWidth?: number;
+    /** 内部蓝色圆点是否使用律动效果 @default true @platform ios */
+    enablePulseAnimation?: boolean;
+    /** 定位点背景色 @default 'white' @platform ios */
+    locationDotBgColor?: string | number;
+    /** 定位点蓝色圆点颜色 @default 'blue' @platform ios */
+    locationDotFillColor?: string | number;
+    /** 定位图标 支持网络图片(http/https)、本地文件(file://)或资源名称 */
+    image?: string;
+    /** 定位图标宽度(像素) */
+    imageWidth?: number;
+    /** 定位图标高度(像素) */
+    imageHeight?: number;
+  };
+
+  /**
+   * 是否显示室内地图
+   * 
+   */
+  indoorViewEnabled?: boolean;
+
+  /**
+   * 是否显示3D建筑
+   */
+  buildingsEnabled?: boolean;
+
+  /**
+   * 是否显示标注
+   */
+  labelsEnabled?: boolean;
+
+  /**
+   * 是否显示指南针
+   */
+  compassEnabled?: boolean;
+
+  /**
+   * 是否显示缩放按钮
+   * @platform android
+   */
+  zoomControlsEnabled?: boolean;
+
+  /**
+   * 是否显示比例尺
+   */
+  scaleControlsEnabled?: boolean;
+
+  /**
+   * 是否显示定位按钮
+   * @platform android
+   */
+  myLocationButtonEnabled?: boolean;
+
+  /**
+   * 是否显示路况
+   */
+  trafficEnabled?: boolean;
+
+  /**
+   * 最大缩放级别
+   */
+  maxZoom?: number;
+
+  /**
+   * 最小缩放级别
+   */
+  minZoom?: number;
+
+  /**
+   * 是否启用缩放手势
+   */
+  zoomGesturesEnabled?: boolean;
+
+  /**
+   * 是否启用滑动手势
+   */
+  scrollGesturesEnabled?: boolean;
+
+  /**
+   * 是否启用旋转手势
+   */
+  rotateGesturesEnabled?: boolean;
+
+  /**
+   * 是否启用倾斜手势
+   */
+  tiltGesturesEnabled?: boolean;
+
+  /**
+   * 定位的最小更新距离（米）
+   * @platform ios
+   */
+  distanceFilter?: number;
+
+  /**
+   * 最小更新角度（度）
+   * @platform ios
+   */
+  headingFilter?: number;
+
+  /**
+   * 样式
+   */
+  style?: StyleProp<ViewStyle>;
+
+  /**
+   * 点击地图事件
+   */
+  onMapPress?: (event: NativeSyntheticEvent<LatLng>) => void;
+
+  /**
+   * 点击标注点事件
+   */
+  onPressPoi?: (event: NativeSyntheticEvent<MapPoi>) => void;
+
+  /**
+   * 长按地图事件
+   */
+  onMapLongPress?: (event: NativeSyntheticEvent<LatLng>) => void;
+
+  /**
+   * 地图状态改变事件（实时触发）
+   */
+  onCameraMove?: (event: NativeSyntheticEvent<CameraEvent>) => void;
+
+  /**
+   * 地图状态改变完成事件
+   */
+  onCameraIdle?: (event: NativeSyntheticEvent<CameraEvent>) => void;
+
+  /**
+   * 地图加载完成事件
+   */
+  onLoad?: (event: NativeSyntheticEvent<{}>) => void;
+
+  /**
+   * 地图定位更新事件
+   */
+  onLocation?: (event: NativeSyntheticEvent<LocationEvent>) => void;
+
+  /**
+   * 子组件
+   */
+  children?: React.ReactNode;
+}
+
+/**
+ * 地图视图方法
+ */
+export interface MapViewMethods {
+  /**
+   * 移动相机
+   * @param cameraPosition 目标相机位置
+   * @param duration 动画时长（毫秒）
+   */
+  moveCamera(cameraPosition: CameraPosition, duration?: number): void;
+
+  /**
+   * 将屏幕坐标转换为地理坐标
+   * @param point 屏幕坐标
+   * @returns 地理坐标
+   */
+  getLatLng(point: Point): Promise<LatLng>;
+
+  /**
+   * 设置地图中心点
+   * @param center 中心点
+   * @param animated 是否启用动画
+   */
+  setCenter(center: LatLng, animated?: boolean): void;
+
+  /**
+   * 设置地图缩放级别
+   * @param zoom 缩放级别
+   * @param animated 是否启用动画
+   */
+  setZoom(zoom: number, animated?: boolean): void;
+
+  /**
+   * 获取相机位置
+   * @returns 相机位置
+   */
+  getCameraPosition(): Promise<CameraPosition>;
+
+  
+}
+
+/**
+ * MapView Ref 公开接口（用户使用）
+ */
+export interface MapViewRef {
+  moveCamera(position: CameraPosition, duration?: number): Promise<void>;
+  getLatLng(point: Point): Promise<LatLng>;
+  setCenter(center: LatLng, animated?: boolean): Promise<void>;
+  setZoom(zoom: number, animated?: boolean): Promise<void>;
+  getCameraPosition(): Promise<CameraPosition>;
+
+}
+