expo-gaode-map 0.1.0

package/src/types/location.types.ts

@@ -0,0 +1,364 @@
+/**
+ * 高德地图定位相关类型定义
+ * 基于 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;
+}
+
+/**
+ * 逆地理编码信息
+ */
+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;
+
+  /**
+   * 是否允许后台定位
+   * @platform ios
+   * @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/types/map-view.types.ts

@@ -0,0 +1,249 @@
+/**
+ * 高德地图视图相关类型定义
+ * 基于 Expo Modules API
+ */
+
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { CameraPosition, LatLng, LatLngBounds, MapPoi, MapType, Point } from './common.types';
+
+/**
+ * 地图相机事件
+ */
+export interface CameraEvent {
+  /**
+   * 相机位置
+   */
+  cameraPosition: CameraPosition;
+
+  /**
+   * 可见区域边界
+   */
+  latLngBounds: LatLngBounds;
+}
+
+/**
+ * 地图视图属性
+ */
+export interface MapViewProps {
+  /**
+   * 地图类型
+   */
+  mapType?: MapType;
+
+  /**
+   * 初始相机位置
+   */
+  initialCameraPosition?: CameraPosition;
+
+  /**
+   * 是否显示当前定位
+   */
+  myLocationEnabled?: boolean;
+
+  /**
+   * 是否跟随用户位置
+   * 当为 true 时，地图会自动移动跟随用户位置（适合导航场景）
+   * 当为 false 时，只显示定位点，不会自动移动地图（默认值，适合浏览场景）
+   * @default false
+   */
+  followUserLocation?: boolean;
+
+  /**
+   * 是否显示定位图标
+   */
+  myLocationIcon?: boolean;
+
+  /**
+   * 是否显示室内地图
+   */
+  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>;
+
+  /**
+   * 点击地图事件
+   */
+  onPress?: (event: LatLng) => void;
+
+  /**
+   * 点击标注点事件
+   */
+  onPressPoi?: (event: MapPoi) => void;
+
+  /**
+   * 长按地图事件
+   */
+  onLongPress?: (event: LatLng) => void;
+
+  /**
+   * 地图状态改变事件（实时触发）
+   */
+  onCameraMove?: (event: CameraEvent) => void;
+
+  /**
+   * 地图状态改变完成事件
+   */
+  onCameraIdle?: (event: CameraEvent) => void;
+
+  /**
+   * 地图加载完成事件
+   */
+  onLoad?: (event: {}) => void;
+
+  /**
+   * 地图定位更新事件
+   */
+  onLocation?: (event: Location) => 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>;
+}
+
+/**
+ * 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>;
+  addCircle(id: string, props: import('./overlays.types').CircleProps): Promise<void>;
+  removeCircle(id: string): Promise<void>;
+  updateCircle(id: string, props: Partial<import('./overlays.types').CircleProps>): Promise<void>;
+  addMarker(id: string, props: import('./overlays.types').MarkerProps): Promise<void>;
+  removeMarker(id: string): Promise<void>;
+  updateMarker(id: string, props: Partial<import('./overlays.types').MarkerProps>): Promise<void>;
+  addPolyline(id: string, props: import('./overlays.types').PolylineProps): Promise<void>;
+  removePolyline(id: string): Promise<void>;
+  updatePolyline(id: string, props: Partial<import('./overlays.types').PolylineProps>): Promise<void>;
+  addPolygon(id: string, props: import('./overlays.types').PolygonProps): Promise<void>;
+  removePolygon(id: string): Promise<void>;
+  updatePolygon(id: string, props: Partial<import('./overlays.types').PolygonProps>): Promise<void>;
+}
+
+/**
+ * 原生 MapView Ref 接口（所有参数必需）
+ */
+export interface NativeMapViewRef {
+  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>;
+  addCircle(id: string, props: import('./overlays.types').CircleProps): Promise<void>;
+  removeCircle(id: string): Promise<void>;
+  updateCircle(id: string, props: Partial<import('./overlays.types').CircleProps>): Promise<void>;
+  addMarker(id: string, props: import('./overlays.types').MarkerProps): Promise<void>;
+  removeMarker(id: string): Promise<void>;
+  updateMarker(id: string, props: Partial<import('./overlays.types').MarkerProps>): Promise<void>;
+  addPolyline(id: string, props: import('./overlays.types').PolylineProps): Promise<void>;
+  removePolyline(id: string): Promise<void>;
+  updatePolyline(id: string, props: Partial<import('./overlays.types').PolylineProps>): Promise<void>;
+  addPolygon(id: string, props: import('./overlays.types').PolygonProps): Promise<void>;
+  removePolygon(id: string): Promise<void>;
+  updatePolygon(id: string, props: Partial<import('./overlays.types').PolygonProps>): Promise<void>;
+}