expo-gaode-map-search 1.3.3 → 1.3.5

package/build/ExpoGaodeMapSearch.types.d.ts

@@ -11,7 +11,9 @@ export declare enum SearchType {
     /** 多边形搜索 */
     POLYGON = "polygon",
     /** 输入提示 */
-    INPUT_TIPS = "inputTips"
+    INPUT_TIPS = "inputTips",
+    /** 逆地理编码 */
+    RE_GEOCODE = "reGeocode"
 }
 /**
  * 坐标点
@@ -50,6 +52,161 @@ export interface POI {
     adName?: string;
     /** 区域编码 */
     adCode?: string;
+    /**
+     * 深度信息 (Android SDK V9.4.0+ 新增)
+     * 包含评分、营业时间、人均消费等扩展信息
+     */
+    business?: {
+        opentime?: string;
+        opentimeToday?: string;
+        rating?: string;
+        cost?: string;
+        parkingType?: string;
+        tag?: string;
+        tel?: string;
+        alias?: string;
+        businessArea?: string;
+    };
+    /**
+     * 图片信息
+     */
+    photos?: Array<{
+        title?: string;
+        url?: string;
+    }>;
+    /** 室内地图信息 */
+    indoor?: {
+        /** 楼层 */
+        floor?: string;
+        /** 楼层名称 */
+        floorName?: string;
+        /** POI ID */
+        poiId?: string;
+        /** 是否有室内地图 */
+        hasIndoorMap?: boolean;
+    };
+}
+/**
+ * 商圈信息
+ */
+export interface BusinessArea {
+    /** 名称 */
+    name: string;
+    /** 中心坐标 */
+    location: Coordinates;
+}
+/**
+ * 地址组成要素
+ */
+export interface AddressComponent {
+    /** 省名称 */
+    province: string;
+    /** 市名称 */
+    city: string;
+    /** 区名称 */
+    district: string;
+    /** 乡镇名称 */
+    township: string;
+    /** 社区名称 */
+    neighborhood: string;
+    /** 建筑名称 */
+    building: string;
+    /** 城市编码 */
+    cityCode: string;
+    /** 区域编码 */
+    adCode: string;
+    /** 门牌信息 */
+    streetNumber: {
+        /** 街道名称 */
+        street: string;
+        /** 门牌号 */
+        number: string;
+        /** 坐标点 */
+        location?: Coordinates;
+        /** 方向 */
+        direction: string;
+        /** 距离 */
+        distance: number;
+    };
+    /** 商圈列表 */
+    businessAreas?: BusinessArea[];
+}
+/**
+ * 道路信息
+ */
+export interface Road {
+    /** 道路ID */
+    id: string;
+    /** 道路名称 */
+    name: string;
+    /** 距离 */
+    distance: number;
+    /** 方向 */
+    direction: string;
+    /** 坐标点 */
+    location: Coordinates;
+}
+/**
+ * 道路交叉口信息
+ */
+export interface RoadCross {
+    /** 距离 */
+    distance: number;
+    /** 方向 */
+    direction: string;
+    /** 交叉口坐标 */
+    location: Coordinates;
+    /** 第一条道路ID */
+    firstId: string;
+    /** 第一条道路名称 */
+    firstName: string;
+    /** 第二条道路ID */
+    secondId: string;
+    /** 第二条道路名称 */
+    secondName: string;
+}
+/**
+ * 兴趣区域信息
+ */
+export interface AOI {
+    /** AOI ID */
+    id: string;
+    /** AOI 名称 */
+    name: string;
+    /** 区域编码 */
+    adCode: string;
+    /** 中心点坐标 */
+    location: Coordinates;
+    /** 面积 */
+    area: number;
+}
+/**
+ * 逆地理编码选项
+ */
+export interface ReGeocodeOptions {
+    /** 经纬度坐标 */
+    location: Coordinates;
+    /** 搜索半径，默认 1000 米 */
+    radius?: number;
+    /** 是否返回扩展信息，默认 true */
+    requireExtension?: boolean;
+}
+/**
+ * 逆地理编码结果
+ */
+export interface ReGeocodeResult {
+    /** 格式化地址 */
+    formattedAddress: string;
+    /** 地址组成要素 */
+    addressComponent: AddressComponent;
+    /** 兴趣点列表 */
+    pois: POI[];
+    /** 道路列表 */
+    roads: Road[];
+    /** 道路交叉口列表 */
+    roadCrosses: RoadCross[];
+    /** 兴趣区域列表 */
+    aois: AOI[];
 }
 /**
  * POI 搜索选项

package/build/ExpoGaodeMapSearch.types.js

@@ -16,4 +16,6 @@ var SearchType;
     SearchType["POLYGON"] = "polygon";
     /** 输入提示 */
     SearchType["INPUT_TIPS"] = "inputTips";
+    /** 逆地理编码 */
+    SearchType["RE_GEOCODE"] = "reGeocode";
 })(SearchType || (exports.SearchType = SearchType = {}));

package/build/ExpoGaodeMapSearchModule.d.ts

@@ -1,7 +1,77 @@
+import { AlongSearchOptions, InputTipsOptions, InputTipsResult, NearbySearchOptions, POI, POISearchOptions, PolygonSearchOptions, ReGeocodeOptions, ReGeocodeResult, SearchResult } from './ExpoGaodeMapSearch.types';
+declare class ExpoGaodeMapSearchModuleType {
+    /**
+     * 初始化搜索模块（可选）
+     *
+     * 如果 API Key 已通过以下方式设置，则无需调用此方法：
+     * 1. app.json 的 plugins 中配置了 iosKey（推荐）
+     * 2. 调用了 ExpoGaodeMap.initSDK()
+     * 3. 在 AppDelegate 中手动设置
+     *
+     * 此方法会在首次调用搜索功能时自动执行，手动调用可以提前检测配置问题。
+     */
+    initSearch(): void;
+    /**
+     * 搜索 POI（兴趣点）
+     * 根据关键词和可选参数返回匹配的 POI 列表。
+     *
+     * @param options 搜索参数，包含关键词、城市、类型等
+     * @returns 匹配的 POI 列表
+     */
+    searchPOI(options: POISearchOptions): Promise<SearchResult>;
+    /**
+     * 搜索周边 POI
+     * 根据位置和半径返回周边的 POI 列表。
+     *
+     * @param options 搜索参数，包含位置、半径、类型等
+     * @returns 周边的 POI 列表
+     */
+    searchNearby(options: NearbySearchOptions): Promise<SearchResult>;
+    /**
+     * 搜索沿途 POI
+     * 根据路线和半径返回沿途的 POI 列表。
+     *
+     * @param options 搜索参数，包含路线、半径、类型等
+     * @returns 沿途的 POI 列表
+     */
+    searchAlong(options: AlongSearchOptions): Promise<SearchResult>;
+    /**
+     * 搜索多边形内的 POI
+     * 根据多边形区域返回其内的 POI 列表。
+     *
+     * @param options 搜索参数，包含多边形区域、类型等
+     * @returns 多边形内的 POI 列表
+     */
+    searchPolygon(options: PolygonSearchOptions): Promise<SearchResult>;
+    /**
+     * 获取输入提示
+     * 根据用户输入返回可能的搜索建议。
+     *
+     * @param options 输入提示参数，包含关键词、城市等
+     * @returns 输入提示结果
+     */
+    getInputTips(options: InputTipsOptions): Promise<InputTipsResult>;
+    /**
+     * 逆地理编码
+     * 根据经纬度返回地址信息。
+     *
+     * @param options 逆地理编码参数，包含经纬度等
+     * @returns 逆地理编码结果
+     */
+    reGeocode(options: ReGeocodeOptions): Promise<ReGeocodeResult>;
+    /**
+     * 获取 POI 详情
+     * 根据 POI ID 返回详细信息。
+     *
+     * @param id POI 唯一标识符
+     * @returns POI 详情
+     */
+    getPoiDetail(id: string): Promise<POI>;
+}
 /**
  * 高德地图搜索模块
  *
  * 提供 POI 搜索、周边搜索、沿途搜索、多边形搜索和输入提示功能
  */
-declare const ExpoGaodeMapSearchModule: any;
+declare const ExpoGaodeMapSearchModule: ExpoGaodeMapSearchModuleType;
 export default ExpoGaodeMapSearchModule;

package/build/index.d.ts

@@ -1,4 +1,4 @@
-import type { Coordinates, POI, POISearchOptions, NearbySearchOptions, AlongSearchOptions, PolygonSearchOptions, InputTipsOptions, InputTip, SearchResult, InputTipsResult } from './ExpoGaodeMapSearch.types';
+import type { Coordinates, POI, POISearchOptions, NearbySearchOptions, AlongSearchOptions, PolygonSearchOptions, InputTipsOptions, InputTip, SearchResult, InputTipsResult, ReGeocodeOptions, ReGeocodeResult, AddressComponent, Road, RoadCross, AOI } from './ExpoGaodeMapSearch.types';
 /**
  * 初始化搜索模块（可选）
  *
@@ -111,7 +111,36 @@ export declare function searchPolygon(options: PolygonSearchOptions): Promise<Se
  * ```
  */
 export declare function getInputTips(options: InputTipsOptions): Promise<InputTipsResult>;
-export type { Coordinates, POI, POISearchOptions, NearbySearchOptions, AlongSearchOptions, PolygonSearchOptions, InputTipsOptions, InputTip, SearchResult, InputTipsResult, };
+/**
+ * 逆地理编码（坐标转地址）
+ *
+ * @param options 逆地理编码选项
+ * @returns 逆地理编码结果
+ *
+ * @example
+ * ```typescript
+ * const result = await reGeocode({
+ *   location: { latitude: 39.9, longitude: 116.4 },
+ *   radius: 1000,
+ * });
+ * console.log(result.formattedAddress);
+ * ```
+ */
+export declare function reGeocode(options: ReGeocodeOptions): Promise<ReGeocodeResult>;
+/**
+ * POI 详情查询
+ *
+ * @param id POI ID
+ * @returns POI 详情
+ *
+ * @example
+ * ```typescript
+ * const poi = await getPoiDetail('B000A83M61');
+ * console.log(poi.name, poi.address);
+ * ```
+ */
+export declare function getPoiDetail(id: string): Promise<POI>;
+export type { Coordinates, POI, POISearchOptions, NearbySearchOptions, AlongSearchOptions, PolygonSearchOptions, InputTipsOptions, InputTip, SearchResult, InputTipsResult, ReGeocodeOptions, ReGeocodeResult, AddressComponent, Road, RoadCross, AOI, };
 export { SearchType } from './ExpoGaodeMapSearch.types';
 declare const _default: {
     initSearch: typeof initSearch;
@@ -120,5 +149,6 @@ declare const _default: {
     searchAlong: typeof searchAlong;
     searchPolygon: typeof searchPolygon;
     getInputTips: typeof getInputTips;
+    reGeocode: typeof reGeocode;
 };
 export default _default;

package/build/index.js

@@ -10,6 +10,8 @@ exports.searchNearby = searchNearby;
 exports.searchAlong = searchAlong;
 exports.searchPolygon = searchPolygon;
 exports.getInputTips = getInputTips;
+exports.reGeocode = reGeocode;
+exports.getPoiDetail = getPoiDetail;
 const ExpoGaodeMapSearchModule_1 = __importDefault(require("./ExpoGaodeMapSearchModule"));
 /**
  * 初始化搜索模块（可选）
@@ -135,6 +137,39 @@ async function searchPolygon(options) {
 async function getInputTips(options) {
     return await ExpoGaodeMapSearchModule_1.default.getInputTips(options);
 }
+/**
+ * 逆地理编码（坐标转地址）
+ *
+ * @param options 逆地理编码选项
+ * @returns 逆地理编码结果
+ *
+ * @example
+ * ```typescript
+ * const result = await reGeocode({
+ *   location: { latitude: 39.9, longitude: 116.4 },
+ *   radius: 1000,
+ * });
+ * console.log(result.formattedAddress);
+ * ```
+ */
+async function reGeocode(options) {
+    return await ExpoGaodeMapSearchModule_1.default.reGeocode(options);
+}
+/**
+ * POI 详情查询
+ *
+ * @param id POI ID
+ * @returns POI 详情
+ *
+ * @example
+ * ```typescript
+ * const poi = await getPoiDetail('B000A83M61');
+ * console.log(poi.name, poi.address);
+ * ```
+ */
+async function getPoiDetail(id) {
+    return await ExpoGaodeMapSearchModule_1.default.getPoiDetail(id);
+}
 var ExpoGaodeMapSearch_types_1 = require("./ExpoGaodeMapSearch.types");
 Object.defineProperty(exports, "SearchType", { enumerable: true, get: function () { return ExpoGaodeMapSearch_types_1.SearchType; } });
 // 默认导出
@@ -145,4 +180,5 @@ exports.default = {
     searchAlong,
     searchPolygon,
     getInputTips,
+    reGeocode,
 };