expo-gaode-map-search 1.2.0-beta.0 → 1.3.0

package/ios/ExpoGaodeMapSearchModule.swift

@@ -0,0 +1,415 @@
+import ExpoModulesCore
+import AMapSearchKit
+import AMapFoundationKit
+
+public class ExpoGaodeMapSearchModule: Module {
+  private var searchAPI: AMapSearchAPI!
+  private var searchDelegate: SearchDelegate!
+  
+  public func definition() -> ModuleDefinition {
+    Name("ExpoGaodeMapSearch")
+    
+    // 不在 OnCreate 中初始化，改为延迟初始化
+    
+    /**
+     * 手动初始化搜索模块（可选）
+     * 如果 API Key 已经设置，则直接初始化
+     * 如果未设置，会尝试从 Info.plist 读取
+     */
+    Function("initSearch") {
+      self.initSearchAPI()
+    }
+
+    /**
+     * POI 搜索
+     */
+    AsyncFunction("searchPOI") { (options: [String: Any], promise: Promise) in
+      // 延迟初始化：在首次使用时才初始化
+      self.initSearchAPI()
+      
+      guard let keyword = options["keyword"] as? String else {
+        promise.reject("SEARCH_ERROR", "keyword is required")
+        return
+      }
+      
+      let city = options["city"] as? String ?? ""
+      let types = options["types"] as? String ?? ""
+      let pageSize = options["pageSize"] as? Int ?? 20
+      let pageNum = options["pageNum"] as? Int ?? 1
+      
+      let request = AMapPOIKeywordsSearchRequest()
+      request.keywords = keyword
+      request.city = city
+      request.types = types
+      request.page = pageNum
+      request.offset = pageSize
+      
+      self.searchDelegate.currentPromise = promise
+      self.searchAPI.aMapPOIKeywordsSearch(request)
+    }
+
+    /**
+     * 周边搜索
+     */
+    AsyncFunction("searchNearby") { (options: [String: Any], promise: Promise) in
+      self.initSearchAPI()
+      
+      guard let keyword = options["keyword"] as? String else {
+        promise.reject("SEARCH_ERROR", "keyword is required")
+        return
+      }
+      
+      guard let center = options["center"] as? [String: Any],
+            let latitude = center["latitude"] as? Double,
+            let longitude = center["longitude"] as? Double else {
+        promise.reject("SEARCH_ERROR", "center is required")
+        return
+      }
+      
+      let radius = options["radius"] as? Int ?? 1000
+      let types = options["types"] as? String ?? ""
+      let pageSize = options["pageSize"] as? Int ?? 20
+      let pageNum = options["pageNum"] as? Int ?? 1
+      
+      let request = AMapPOIAroundSearchRequest()
+      request.keywords = keyword
+      request.location = AMapGeoPoint.location(
+        withLatitude: CGFloat(latitude),
+        longitude: CGFloat(longitude)
+      )
+      request.radius = radius
+      request.types = types
+      request.page = pageNum
+      request.offset = pageSize
+      
+      self.searchDelegate.currentPromise = promise
+      self.searchAPI.aMapPOIAroundSearch(request)
+    }
+
+    /**
+     * 沿途搜索
+     * iOS SDK 支持的沿途搜索类型：加油站、ATM、汽修、厕所
+     */
+    AsyncFunction("searchAlong") { (options: [String: Any], promise: Promise) in
+      self.initSearchAPI()
+      
+      guard let keyword = options["keyword"] as? String else {
+        promise.reject("SEARCH_ERROR", "keyword is required")
+        return
+      }
+      
+      guard let polyline = options["polyline"] as? [[String: Any]] else {
+        promise.reject("SEARCH_ERROR", "polyline is required")
+        return
+      }
+      
+      guard polyline.count >= 2 else {
+        promise.reject("SEARCH_ERROR", "polyline must have at least 2 points")
+        return
+      }
+      
+      // 转换路线点
+      var points: [AMapGeoPoint] = []
+      for point in polyline {
+        if let lat = point["latitude"] as? Double,
+           let lng = point["longitude"] as? Double {
+          points.append(AMapGeoPoint.location(
+            withLatitude: CGFloat(lat),
+            longitude: CGFloat(lng)
+          ))
+        }
+      }
+      
+      guard let startPoint = points.first,
+            let endPoint = points.last else {
+        promise.reject("SEARCH_ERROR", "Invalid polyline points")
+        return
+      }
+      
+      // 根据关键词确定搜索类型
+      let lowercaseKeyword = keyword.lowercased()
+      var searchType: AMapRoutePOISearchType = .gasStation
+      if lowercaseKeyword.contains("加油") || lowercaseKeyword == "加油站" {
+        searchType = .gasStation
+      } else if lowercaseKeyword.contains("atm") || lowercaseKeyword.contains("银行") {
+        searchType = .ATM
+      } else if lowercaseKeyword.contains("汽修") || lowercaseKeyword.contains("维修") {
+        searchType = .maintenanceStation
+      } else if lowercaseKeyword.contains("厕所") || lowercaseKeyword.contains("卫生间") {
+        searchType = .toilet
+      }
+      
+      let request = AMapRoutePOISearchRequest()
+      request.origin = startPoint
+      request.destination = endPoint
+      request.searchType = searchType
+      request.range = 250
+      request.strategy = 0
+      
+      self.searchDelegate.currentPromise = promise
+      self.searchAPI.aMapRoutePOISearch(request)
+    }
+
+    /**
+     * 多边形搜索
+     */
+    AsyncFunction("searchPolygon") { (options: [String: Any], promise: Promise) in
+      self.initSearchAPI()
+      
+      guard let keyword = options["keyword"] as? String else {
+        promise.reject("SEARCH_ERROR", "keyword is required")
+        return
+      }
+      
+      guard let polygon = options["polygon"] as? [[String: Any]] else {
+        promise.reject("SEARCH_ERROR", "polygon is required")
+        return
+      }
+      
+      let types = options["types"] as? String ?? ""
+      let pageSize = options["pageSize"] as? Int ?? 20
+      let pageNum = options["pageNum"] as? Int ?? 1
+      
+      var points: [AMapGeoPoint] = []
+      for point in polygon {
+        if let lat = point["latitude"] as? Double,
+           let lng = point["longitude"] as? Double {
+          points.append(AMapGeoPoint.location(
+            withLatitude: CGFloat(lat),
+            longitude: CGFloat(lng)
+          ))
+        }
+      }
+      
+      let request = AMapPOIPolygonSearchRequest()
+      request.keywords = keyword
+      request.polygon = AMapGeoPolygon(points: points)
+      request.types = types
+      request.page = pageNum
+      request.offset = pageSize
+      
+      self.searchDelegate.currentPromise = promise
+      self.searchAPI.aMapPOIPolygonSearch(request)
+    }
+
+    /**
+     * 输入提示
+     */
+    AsyncFunction("getInputTips") { (options: [String: Any], promise: Promise) in
+      self.initSearchAPI()
+      
+      guard let keyword = options["keyword"] as? String else {
+        promise.reject("TIPS_ERROR", "keyword is required")
+        return
+      }
+      
+      let city = options["city"] as? String ?? ""
+      let types = options["types"] as? String ?? ""
+      
+      let request = AMapInputTipsSearchRequest()
+      request.keywords = keyword
+      request.city = city
+      request.types = types
+      
+      self.searchDelegate.currentPromise = promise
+      self.searchAPI.aMapInputTipsSearch(request)
+    }
+  }
+  
+  // MARK: - Private Methods
+  
+  /**
+   * 初始化搜索 API（延迟初始化）
+   */
+  private func initSearchAPI() {
+    if searchAPI == nil {
+      // 确保 API Key 已设置
+      self.ensureAPIKeyIsSet()
+      
+      searchDelegate = SearchDelegate()
+      searchAPI = AMapSearchAPI()
+      searchAPI.delegate = searchDelegate
+      
+      let apiKey = AMapServices.shared().apiKey
+      print("[ExpoGaodeMapSearch] 搜索 API 已初始化，API Key: \(apiKey ?? "未设置")")
+    }
+  }
+  
+  /**
+   * 确保 API Key 已设置
+   * 优先级：已设置 > Info.plist > 提示错误
+   */
+  private func ensureAPIKeyIsSet() {
+    // 1. 检查是否已经设置（通过 initSDK 或 AppDelegate）
+    if let existingKey = AMapServices.shared().apiKey, !existingKey.isEmpty {
+      print("[ExpoGaodeMapSearch] ✓ API Key 已设置")
+      return
+    }
+    
+    // 2. 尝试从 Info.plist 读取（Config Plugin 会写入）
+    if let apiKey = Bundle.main.object(forInfoDictionaryKey: "AMapApiKey") as? String, !apiKey.isEmpty {
+      AMapServices.shared().apiKey = apiKey
+      AMapServices.shared().enableHTTPS = true
+      print("[ExpoGaodeMapSearch] ✓ 从 Info.plist 读取并设置 API Key")
+      return
+    }
+    
+    // 3. 都没有，提示错误
+    print("[ExpoGaodeMapSearch] ✗ 错误: API Key 未设置！")
+    print("[ExpoGaodeMapSearch] 请通过以下任一方式设置：")
+    print("[ExpoGaodeMapSearch]   1. 在 app.json 的 plugins 中配置 iosApiKey（推荐）")
+    print("[ExpoGaodeMapSearch]   2. 调用 ExpoGaodeMap.initSDK({ iosKey: 'your-key' })")
+    print("[ExpoGaodeMapSearch]   3. 在 AppDelegate 中调用 [AMapServices sharedServices].apiKey = @\"your-key\"")
+  }
+}
+
+// MARK: - Search Delegate
+class SearchDelegate: NSObject, AMapSearchDelegate {
+  var currentPromise: Promise?
+  
+  /**
+   * POI 搜索回调
+   */
+  func onPOISearchDone(_ request: AMapPOISearchBaseRequest!, response: AMapPOISearchResponse!) {
+    guard let promise = currentPromise else { return }
+    
+    if let response = response {
+      promise.resolve(convertPOISearchResponse(response))
+    } else {
+      promise.reject("SEARCH_ERROR", "Search failed")
+    }
+    
+    currentPromise = nil
+  }
+  
+  /**
+   * 沿途搜索回调
+   */
+  func onRoutePOISearchDone(_ request: AMapRoutePOISearchRequest!, response: AMapRoutePOISearchResponse!) {
+    guard let promise = currentPromise else { return }
+    
+    if let response = response {
+      promise.resolve(convertRoutePOISearchResponse(response))
+    } else {
+      promise.reject("SEARCH_ERROR", "Route search failed")
+    }
+    
+    currentPromise = nil
+  }
+  
+  /**
+   * 输入提示回调
+   */
+  func onInputTipsSearchDone(_ request: AMapInputTipsSearchRequest!, response: AMapInputTipsSearchResponse!) {
+    guard let promise = currentPromise else { return }
+    
+    if let response = response {
+      promise.resolve(convertInputTipsResponse(response))
+    } else {
+      promise.reject("TIPS_ERROR", "Input tips failed")
+    }
+    
+    currentPromise = nil
+  }
+  
+  /**
+   * 搜索失败回调
+   */
+  func aMapSearchRequest(_ request: Any!, didFailWithError error: Error!) {
+    guard let promise = currentPromise else { return }
+    
+    let errorMessage = error?.localizedDescription ?? "Unknown error"
+    promise.reject("SEARCH_ERROR", errorMessage)
+    currentPromise = nil
+  }
+  
+  // MARK: - 转换方法
+  
+  /**
+   * 转换 POI 搜索结果
+   */
+  private func convertPOISearchResponse(_ response: AMapPOISearchResponse) -> [String: Any] {
+    let pois = response.pois?.map { poi -> [String: Any] in
+      var result: [String: Any] = [
+        "id": poi.uid ?? "",
+        "name": poi.name ?? "",
+        "address": poi.address ?? "",
+        "location": [
+          "latitude": poi.location?.latitude ?? 0,
+          "longitude": poi.location?.longitude ?? 0
+        ],
+        "typeCode": poi.typecode ?? "",
+        "typeDes": poi.type ?? "",
+        "tel": poi.tel ?? "",
+        "distance": poi.distance,
+        "cityName": poi.city ?? "",
+        "provinceName": poi.province ?? "",
+        "adName": poi.district ?? "",
+        "adCode": poi.adcode ?? ""
+      ]
+      return result
+    } ?? []
+    
+    return [
+      "pois": pois,
+      "total": response.count,
+      "pageNum": response.pois?.first?.uid != nil ? 1 : 0,
+      "pageSize": response.pois?.count ?? 0,
+      "pageCount": (response.count + 19) / 20
+    ]
+  }
+
+  /**
+   * 转换输入提示结果
+   */
+  private func convertInputTipsResponse(_ response: AMapInputTipsSearchResponse) -> [String: Any] {
+    let tips = response.tips?.map { tip -> [String: Any] in
+      var result: [String: Any] = [
+        "id": tip.uid ?? "",
+        "name": tip.name ?? "",
+        "address": tip.address ?? "",
+        "typeCode": tip.typecode ?? "",
+        "cityName": tip.district ?? "",
+        "adName": tip.district ?? ""
+      ]
+      
+      if let location = tip.location {
+        result["location"] = [
+          "latitude": location.latitude,
+          "longitude": location.longitude
+        ]
+      }
+      
+      return result
+    } ?? []
+    
+    return ["tips": tips]
+  }
+
+  /**
+   * 转换沿途 POI 搜索结果
+   */
+  private func convertRoutePOISearchResponse(_ response: AMapRoutePOISearchResponse) -> [String: Any] {
+    let pois = response.pois?.map { poi -> [String: Any] in
+      var result: [String: Any] = [
+        "id": poi.uid ?? "",
+        "name": poi.name ?? "",
+        "address": "",
+        "location": [
+          "latitude": poi.location?.latitude ?? 0,
+          "longitude": poi.location?.longitude ?? 0
+        ],
+        "distance": poi.distance
+      ]
+      return result
+    } ?? []
+    
+    return [
+      "pois": pois,
+      "total": pois.count,
+      "pageNum": 1,
+      "pageSize": pois.count,
+      "pageCount": 1
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-gaode-map-search",
-  "version": "1.2.0-beta.0",
+  "version": "1.3.0",
   "description": "高德地图搜索功能模块 - POI搜索、关键词搜索、周边搜索，需先安装expo-gaode-map",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -21,8 +21,17 @@
   "author": "尚博信_王强 <wangqiang03@sunboxsoft.com> (https://github.com/TomWq)",
   "license": "MIT",
   "homepage": "https://github.com/TomWq/expo-gaode-map#readme",
-  "dependencies": {
-    "expo-gaode-map": "^2.2.0-beta.0"
+  "files": [
+    "build/**/*",
+    "src/**/*",
+    "android/**/*",
+    "ios/**/*",
+    "expo-module.config.json",
+    "README.md",
+    "package.json"
+  ],
+  "publishConfig": {
+    "access": "public"
   },
   "devDependencies": {
     "@types/react": "~19.1.0",
@@ -33,20 +42,18 @@
   },
   "peerDependencies": {
     "expo": "*",
-    "expo-gaode-map": ">=2.0.0",
     "react": "*",
     "react-native": "*"
   },
-  "peerDependenciesMeta": {
-    "expo-gaode-map": {
-      "optional": false
-    }
+  "dependencies": {
+    "expo-gaode-map": "^2.2.0"
   },
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",
     "lint": "expo-module lint",
     "test": "expo-module test",
-    "expo-module": "expo-module"
+    "expo-module": "expo-module",
+    "postinstall": "node -e \"try{require.resolve('expo-gaode-map');process.exit(0)}catch(e1){try{require.resolve('expo-gaode-map-navigation');process.exit(0)}catch(e2){console.error('[expo-gaode-map-search] 需要安装基础地图组件：expo-gaode-map 或 expo-gaode-map-navigation 中的任意一个。\\n请执行：pnpm add expo-gaode-map 或 pnpm add expo-gaode-map-navigation');process.exit(1)}}\""
   }
 }

package/src/ExpoGaodeMapSearch.types.ts

@@ -0,0 +1,179 @@
+/**
+ * 搜索类型
+ */
+export enum SearchType {
+  /** POI 搜索 */
+  POI = 'poi',
+  /** 周边搜索 */
+  NEARBY = 'nearby',
+  /** 沿途搜索 */
+  ALONG = 'along',
+  /** 多边形搜索 */
+  POLYGON = 'polygon',
+  /** 输入提示 */
+  INPUT_TIPS = 'inputTips',
+}
+
+/**
+ * 坐标点
+ */
+export interface Coordinates {
+  latitude: number;
+  longitude: number;
+}
+
+/**
+ * POI 信息
+ */
+export interface POI {
+  /** POI ID */
+  id: string;
+  /** 名称 */
+  name: string;
+  /** 地址 */
+  address: string;
+  /** 坐标 */
+  location: Coordinates;
+  /** 类型编码 */
+  typeCode: string;
+  /** 类型描述 */
+  typeDes: string;
+  /** 电话 */
+  tel?: string;
+  /** 距离（米），仅周边搜索返回 */
+  distance?: number;
+  /** 城市名称 */
+  cityName?: string;
+  /** 城市编码 */
+  cityCode?: string;
+  /** 省份名称 */
+  provinceName?: string;
+  /** 区域名称 */
+  adName?: string;
+  /** 区域编码 */
+  adCode?: string;
+}
+
+/**
+ * POI 搜索选项
+ */
+export interface POISearchOptions {
+  /** 搜索关键词 */
+  keyword: string;
+  /** 城市名称或城市编码（可选） */
+  city?: string;
+  /** POI 类型（可选），多个类型用 | 分隔 */
+  types?: string;
+  /** 每页记录数，默认 20，最大 50 */
+  pageSize?: number;
+  /** 当前页码，从 1 开始，默认 1 */
+  pageNum?: number;
+  /** 是否按照距离排序，需要设置中心点 */
+  sortByDistance?: boolean;
+  /** 中心点坐标，用于距离排序或周边搜索 */
+  center?: Coordinates;
+}
+
+/**
+ * 周边搜索选项
+ */
+export interface NearbySearchOptions {
+  /** 搜索关键词 */
+  keyword: string;
+  /** 中心点坐标 */
+  center: Coordinates;
+  /** 搜索半径，单位：米，默认 1000，最大 50000 */
+  radius?: number;
+  /** POI 类型（可选），多个类型用 | 分隔 */
+  types?: string;
+  /** 每页记录数，默认 20，最大 50 */
+  pageSize?: number;
+  /** 当前页码，从 1 开始，默认 1 */
+  pageNum?: number;
+}
+
+/**
+ * 沿途搜索选项
+ */
+export interface AlongSearchOptions {
+  /** 搜索关键词 */
+  keyword: string;
+  /** 路线坐标点数组 */
+  polyline: Coordinates[];
+  /** 搜索范围，单位：米，默认 500，最大 1000 */
+  range?: number;
+  /** POI 类型（可选），多个类型用 | 分隔 */
+  types?: string;
+}
+
+/**
+ * 多边形搜索选项
+ */
+export interface PolygonSearchOptions {
+  /** 搜索关键词 */
+  keyword: string;
+  /** 多边形顶点坐标数组 */
+  polygon: Coordinates[];
+  /** POI 类型（可选），多个类型用 | 分隔 */
+  types?: string;
+  /** 每页记录数，默认 20，最大 50 */
+  pageSize?: number;
+  /** 当前页码，从 1 开始，默认 1 */
+  pageNum?: number;
+}
+
+/**
+ * 输入提示选项
+ */
+export interface InputTipsOptions {
+  /** 关键词 */
+  keyword: string;
+  /** 城市名称或城市编码（可选） */
+  city?: string;
+  /** POI 类型（可选），多个类型用 | 分隔 */
+  types?: string;
+}
+
+/**
+ * 输入提示结果
+ */
+export interface InputTip {
+  /** 提示 ID */
+  id: string;
+  /** 名称 */
+  name: string;
+  /** 地址 */
+  address: string;
+  /** 坐标（可能为空） */
+  location?: Coordinates;
+  /** 类型编码 */
+  typeCode?: string;
+  /** 城市名称 */
+  cityName?: string;
+  /** 区域名称 */
+  adName?: string;
+}
+
+/**
+ * 搜索结果
+ */
+export interface SearchResult {
+  /** POI 列表 */
+  pois: POI[];
+  /** 总记录数 */
+  total: number;
+  /** 当前页码 */
+  pageNum: number;
+  /** 每页记录数 */
+  pageSize: number;
+  /** 总页数 */
+  pageCount: number;
+}
+
+/**
+ * 输入提示结果
+ */
+export interface InputTipsResult {
+  /** 提示列表 */
+  tips: InputTip[];
+}

package/src/ExpoGaodeMapSearchModule.ts

@@ -0,0 +1,46 @@
+
+import { requireNativeModule } from 'expo-modules-core';
+
+/**
+ * 在加载原生搜索模块前，强制校验基础地图组件是否已安装。
+ * 支持两种“基础地图提供者”：expo-gaode-map 或 expo-gaode-map-navigation（导航内置地图）。
+ * 这样可避免导航与核心包的 SDK 冲突时无法使用搜索模块的问题。
+ */
+function ensureBaseInstalled() {
+  let installed = false;
+  try {
+    // 优先检测核心地图包
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    require('expo-gaode-map');
+    installed = true;
+  } catch (_) {
+    // 再尝试导航包（内置地图能力）
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      require('expo-gaode-map-navigation');
+      installed = true;
+    } catch (_) {
+      installed = false;
+    }
+  }
+
+  if (!installed) {
+    const msg =
+      '[expo-gaode-map-search] 需要先安装基础地图组件，支持以下任一包：\n' +
+      '  - expo-gaode-map（核心地图包），或\n' +
+      '  - expo-gaode-map-navigation（导航包，内置地图能力）\n' +
+      '请先安装并完成原生配置后再重试。';
+    throw new Error(msg);
+  }
+}
+
+ensureBaseInstalled();
+
+/**
+ * 高德地图搜索模块
+ *
+ * 提供 POI 搜索、周边搜索、沿途搜索、多边形搜索和输入提示功能
+ */
+const ExpoGaodeMapSearchModule = requireNativeModule('ExpoGaodeMapSearch');
+
+export default ExpoGaodeMapSearchModule;