expo-gaode-map-web-api 1.0.1-next.0

package/build/services/InputTipsService.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * 高德地图 Web API - 输入提示服务
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InputTipsService = void 0;
+/**
+ * 输入提示服务
+ * 提供根据用户输入的关键词查询返回建议列表
+ */
+class InputTipsService {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 获取输入提示
+     * 根据用户输入的关键词返回建议列表
+     *
+     * @param keywords 查询关键词
+     * @param options 可选参数
+     * @returns 输入提示结果
+     *
+     * @example
+     * ```typescript
+     * // 基础搜索
+     * const result = await inputTips.getTips('肯德基');
+     *
+     * // 指定城市搜索
+     * const result = await inputTips.getTips('肯德基', {
+     *   city: '北京',
+     *   citylimit: true
+     * });
+     *
+     * // 指定位置和类型
+     * const result = await inputTips.getTips('银行', {
+     *   location: '116.481488,39.990464',
+     *   type: '150100',
+     *   city: '010'
+     * });
+     *
+     * // 搜索公交站点
+     * const result = await inputTips.getTips('天安门', {
+     *   city: '北京',
+     *   datatype: 'bus'
+     * });
+     *
+     * // 搜索公交线路
+     * const result = await inputTips.getTips('1路', {
+     *   city: '北京',
+     *   datatype: 'busline'
+     * });
+     * ```
+     */
+    async getTips(keywords, options) {
+        const params = {
+            keywords,
+            ...options,
+        };
+        return this.client.request('/v3/assistant/inputtips', params);
+    }
+    /**
+     * 获取 POI 输入提示
+     * 仅返回 POI 类型的建议
+     *
+     * @param keywords 查询关键词
+     * @param options 可选参数
+     * @returns 输入提示结果
+     *
+     * @example
+     * ```typescript
+     * const result = await inputTips.getPOITips('餐厅', {
+     *   city: '北京',
+     *   type: '050000'
+     * });
+     * ```
+     */
+    async getPOITips(keywords, options) {
+        return this.getTips(keywords, {
+            ...options,
+            datatype: 'poi',
+        });
+    }
+    /**
+     * 获取公交站点输入提示
+     * 仅返回公交站点类型的建议
+     *
+     * @param keywords 查询关键词
+     * @param options 可选参数
+     * @returns 输入提示结果
+     *
+     * @example
+     * ```typescript
+     * const result = await inputTips.getBusTips('天安门', {
+     *   city: '北京'
+     * });
+     * ```
+     */
+    async getBusTips(keywords, options) {
+        return this.getTips(keywords, {
+            ...options,
+            datatype: 'bus',
+        });
+    }
+    /**
+     * 获取公交线路输入提示
+     * 仅返回公交线路类型的建议
+     *
+     * @param keywords 查询关键词
+     * @param options 可选参数
+     * @returns 输入提示结果
+     *
+     * @example
+     * ```typescript
+     * const result = await inputTips.getBuslineTips('1路', {
+     *   city: '北京'
+     * });
+     * ```
+     */
+    async getBuslineTips(keywords, options) {
+        return this.getTips(keywords, {
+            ...options,
+            datatype: 'busline',
+        });
+    }
+}
+exports.InputTipsService = InputTipsService;

package/build/services/POIService.d.ts

@@ -0,0 +1,133 @@
+/**
+ * 高德地图 Web API - POI 搜索服务
+ */
+import { GaodeWebAPIClient } from '../utils/client';
+import type { POISearchParams, POIAroundParams, POIPolygonParams, POISearchResponse } from '../types/poi.types';
+/**
+ * POI 搜索服务
+ */
+export declare class POIService {
+    private client;
+    constructor(client: GaodeWebAPIClient);
+    /**
+     * 关键字搜索
+     * 根据关键字搜索POI
+     *
+     * @param keywords 查询关键字（keywords 或 types 二选一必填）
+     * @param options 可选参数
+     * @returns POI 搜索结果
+     *
+     * @example
+     * ```typescript
+     * // 基础搜索
+     * const result = await poi.search('肯德基', { region: '北京市' });
+     *
+     * // 限制城市
+     * const result = await poi.search('肯德基', {
+     *   region: '北京市',
+     *   city_limit: true,
+     *   page_size: 20,
+     *   page_num: 1
+     * });
+     *
+     * // 指定类型搜索
+     * const result = await poi.search('', {
+     *   types: '050000',  // 餐饮服务
+     *   region: '北京市',
+     *   show_fields: 'children,business,photos'
+     * });
+     * ```
+     */
+    search(keywords?: string, options?: Omit<POISearchParams, 'keywords'>): Promise<POISearchResponse>;
+    /**
+     * 周边搜索
+     * 搜索指定位置周边的POI
+     *
+     * @param location 中心点坐标，格式：经度,纬度
+     * @param options 可选参数
+     * @returns POI 搜索结果
+     *
+     * @example
+     * ```typescript
+     * // 搜索周边所有POI
+     * const result = await poi.searchAround('116.473168,39.993015', {
+     *   radius: 1000
+     * });
+     *
+     * // 搜索周边特定类型POI
+     * const result = await poi.searchAround('116.473168,39.993015', {
+     *   keywords: '餐厅',
+     *   radius: 500,
+     *   sortrule: 'distance'
+     * });
+     *
+     * // 搜索周边肯德基
+     * const result = await poi.searchAround('116.473168,39.993015', {
+     *   keywords: '肯德基',
+     *   types: '050301',  // 中餐厅
+     *   radius: 2000,
+     *   page_size: 10,
+     *   show_fields: 'business,photos'
+     * });
+     * ```
+     */
+    searchAround(location: string | {
+        longitude: number;
+        latitude: number;
+    }, options?: Omit<POIAroundParams, 'location'>): Promise<POISearchResponse>;
+    /**
+     * 多边形搜索
+     * 搜索指定多边形区域内的POI
+     *
+     * @param polygon 多边形坐标，格式：经度1,纬度1|经度2,纬度2|...
+     * @param options 可选参数
+     * @returns POI 搜索结果
+     *
+     * @example
+     * ```typescript
+     * const result = await poi.searchPolygon(
+     *   '116.460656,39.996059|116.469543,39.996059|116.469543,39.989723',
+     *   {
+     *     keywords: '酒店',
+     *     offset: 20
+     *   }
+     * );
+     * ```
+     */
+    searchPolygon(polygon: string, options?: Omit<POIPolygonParams, 'polygon'>): Promise<POISearchResponse>;
+    /**
+     * POI详情查询
+     * 根据POI ID查询详细信息
+     *
+     * @param id POI ID（最多可以传入10个 id，多个 id 之间用"|"分隔）
+     * @param show_fields 返回结果控制，可选值：children, business, indoor, navi, photos
+     * @returns POI 详情
+     *
+     * @example
+     * ```typescript
+     * // 单个POI详情
+     * const result = await poi.getDetail('B000A8VE1H', 'business,photos');
+     * console.log(result.pois[0].name);
+     *
+     * // 批量查询（最多10个）
+     * const result = await poi.getDetail('B000A8VE1H|B0FFKEPXS2', 'business,photos');
+     * ```
+     */
+    getDetail(id: string, show_fields?: string): Promise<POISearchResponse>;
+    /**
+     * 批量查询POI详情
+     *
+     * @param ids POI ID列表（最多10个）
+     * @param show_fields 返回结果控制
+     * @returns POI 详情列表
+     *
+     * @example
+     * ```typescript
+     * const result = await poi.batchGetDetail([
+     *   'B000A8VE1H',
+     *   'B000A8VE2I'
+     * ], 'business,photos');
+     * ```
+     */
+    batchGetDetail(ids: string[], show_fields?: string): Promise<POISearchResponse>;
+}

package/build/services/POIService.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * 高德地图 Web API - POI 搜索服务
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POIService = void 0;
+/**
+ * POI 搜索服务
+ */
+class POIService {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 关键字搜索
+     * 根据关键字搜索POI
+     *
+     * @param keywords 查询关键字（keywords 或 types 二选一必填）
+     * @param options 可选参数
+     * @returns POI 搜索结果
+     *
+     * @example
+     * ```typescript
+     * // 基础搜索
+     * const result = await poi.search('肯德基', { region: '北京市' });
+     *
+     * // 限制城市
+     * const result = await poi.search('肯德基', {
+     *   region: '北京市',
+     *   city_limit: true,
+     *   page_size: 20,
+     *   page_num: 1
+     * });
+     *
+     * // 指定类型搜索
+     * const result = await poi.search('', {
+     *   types: '050000',  // 餐饮服务
+     *   region: '北京市',
+     *   show_fields: 'children,business,photos'
+     * });
+     * ```
+     */
+    async search(keywords, options) {
+        const params = {
+            keywords,
+            ...options,
+        };
+        return this.client.request('/v5/place/text', params);
+    }
+    /**
+     * 周边搜索
+     * 搜索指定位置周边的POI
+     *
+     * @param location 中心点坐标，格式：经度,纬度
+     * @param options 可选参数
+     * @returns POI 搜索结果
+     *
+     * @example
+     * ```typescript
+     * // 搜索周边所有POI
+     * const result = await poi.searchAround('116.473168,39.993015', {
+     *   radius: 1000
+     * });
+     *
+     * // 搜索周边特定类型POI
+     * const result = await poi.searchAround('116.473168,39.993015', {
+     *   keywords: '餐厅',
+     *   radius: 500,
+     *   sortrule: 'distance'
+     * });
+     *
+     * // 搜索周边肯德基
+     * const result = await poi.searchAround('116.473168,39.993015', {
+     *   keywords: '肯德基',
+     *   types: '050301',  // 中餐厅
+     *   radius: 2000,
+     *   page_size: 10,
+     *   show_fields: 'business,photos'
+     * });
+     * ```
+     */
+    async searchAround(location, options) {
+        // 处理坐标参数
+        let locationStr;
+        if (typeof location === 'string') {
+            locationStr = location;
+        }
+        else {
+            locationStr = `${location.longitude},${location.latitude}`;
+        }
+        const params = {
+            location: locationStr,
+            ...options,
+        };
+        return this.client.request('/v5/place/around', params);
+    }
+    /**
+     * 多边形搜索
+     * 搜索指定多边形区域内的POI
+     *
+     * @param polygon 多边形坐标，格式：经度1,纬度1|经度2,纬度2|...
+     * @param options 可选参数
+     * @returns POI 搜索结果
+     *
+     * @example
+     * ```typescript
+     * const result = await poi.searchPolygon(
+     *   '116.460656,39.996059|116.469543,39.996059|116.469543,39.989723',
+     *   {
+     *     keywords: '酒店',
+     *     offset: 20
+     *   }
+     * );
+     * ```
+     */
+    async searchPolygon(polygon, options) {
+        const params = {
+            polygon,
+            ...options,
+        };
+        return this.client.request('/v5/place/polygon', params);
+    }
+    /**
+     * POI详情查询
+     * 根据POI ID查询详细信息
+     *
+     * @param id POI ID（最多可以传入10个 id，多个 id 之间用"|"分隔）
+     * @param show_fields 返回结果控制，可选值：children, business, indoor, navi, photos
+     * @returns POI 详情
+     *
+     * @example
+     * ```typescript
+     * // 单个POI详情
+     * const result = await poi.getDetail('B000A8VE1H', 'business,photos');
+     * console.log(result.pois[0].name);
+     *
+     * // 批量查询（最多10个）
+     * const result = await poi.getDetail('B000A8VE1H|B0FFKEPXS2', 'business,photos');
+     * ```
+     */
+    async getDetail(id, show_fields) {
+        const params = {
+            id,
+            show_fields,
+        };
+        return this.client.request('/v5/place/detail', params);
+    }
+    /**
+     * 批量查询POI详情
+     *
+     * @param ids POI ID列表（最多10个）
+     * @param show_fields 返回结果控制
+     * @returns POI 详情列表
+     *
+     * @example
+     * ```typescript
+     * const result = await poi.batchGetDetail([
+     *   'B000A8VE1H',
+     *   'B000A8VE2I'
+     * ], 'business,photos');
+     * ```
+     */
+    async batchGetDetail(ids, show_fields) {
+        if (ids.length > 10) {
+            throw new Error('批量查询最多支持10个POI ID');
+        }
+        const params = {
+            id: ids.join('|'),
+            show_fields,
+        };
+        return this.client.request('/v5/place/detail', params);
+    }
+}
+exports.POIService = POIService;

package/build/services/RouteService.d.ts

@@ -0,0 +1,149 @@
+import { GaodeWebAPIClient } from '../utils/client';
+import type { Coordinate, DrivingRouteParams, DrivingRouteResponse, WalkingRouteParams, WalkingRouteResponse, BicyclingRouteParams, BicyclingRouteResponse, ElectricBikeRouteParams, ElectricBikeRouteResponse, TransitRouteParams, TransitRouteResponse } from '../types/route.types';
+/**
+ * 路径规划服务
+ * 提供驾车、步行、骑行、电动车、公交等多种出行方式的路径规划
+ */
+export declare class RouteService {
+    private client;
+    constructor(client: GaodeWebAPIClient);
+    /**
+     * 坐标转换辅助方法
+     */
+    private formatCoordinate;
+    /**
+     * 驾车路径规划
+     * @param origin 出发点坐标
+     * @param destination 目的地坐标
+     * @param options 可选参数
+     * @returns 驾车路径规划结果
+     *
+     * @example
+     * ```typescript
+     * // 基础用法
+     * const result = await api.route.driving(
+     *   '116.481028,39.989643',
+     *   '116.434446,39.90816'
+     * );
+     *
+     * // 带途经点和策略（新版 V5 API）
+     * const result = await api.route.driving(
+     *   { longitude: 116.481028, latitude: 39.989643 },
+     *   { longitude: 116.434446, latitude: 39.90816 },
+     *   {
+     *     waypoints: ['116.45,39.95', '116.46,39.94'],
+     *     strategy: DrivingStrategy.AVOID_JAM,
+     *     show_fields: 'cost,navi,polyline',
+     *     plate: '京AHA322',
+     *     cartype: 0
+     *   }
+     * );
+     * ```
+     */
+    driving(origin: Coordinate, destination: Coordinate, options?: Omit<DrivingRouteParams, 'origin' | 'destination'>): Promise<DrivingRouteResponse>;
+    /**
+     * 步行路径规划
+     * @param origin 出发点坐标
+     * @param destination 目的地坐标
+     * @param options 可选参数
+     * @returns 步行路径规划结果
+     *
+     * @example
+     * ```typescript
+     * const result = await api.route.walking(
+     *   '116.481028,39.989643',
+     *   '116.434446,39.90816'
+     * );
+     *
+     * console.log(`步行距离：${result.route.paths[0].distance}米`);
+     * console.log(`预计时间：${result.route.paths[0].duration}秒`);
+     * ```
+     */
+    walking(origin: Coordinate, destination: Coordinate, options?: Omit<WalkingRouteParams, 'origin' | 'destination'>): Promise<WalkingRouteResponse>;
+    /**
+     * 骑行路径规划
+     * @param origin 出发点坐标
+     * @param destination 目的地坐标
+     * @param options 可选参数
+     * @returns 骑行路径规划结果
+     *
+     * @example
+     * ```typescript
+     * const result = await api.route.bicycling(
+     *   '116.481028,39.989643',
+     *   '116.434446,39.90816',
+     *   {
+     *     alternative_route: 2,
+     *     show_fields: 'cost,navi,polyline'
+     *   }
+     * );
+     * ```
+     */
+    bicycling(origin: Coordinate, destination: Coordinate, options?: Omit<BicyclingRouteParams, 'origin' | 'destination'>): Promise<BicyclingRouteResponse>;
+    /**
+     * 电动车路径规划
+     * @param origin 出发点坐标
+     * @param destination 目的地坐标
+     * @param options 可选参数
+     * @returns 电动车路径规划结果
+     *
+     * @example
+     * ```typescript
+     * const result = await api.route.electr icBike(
+     *   '116.481028,39.989643',
+     *   '116.434446,39.90816'
+     * );
+     * ```
+     */
+    electricBike(origin: Coordinate, destination: Coordinate, options?: Omit<ElectricBikeRouteParams, 'origin' | 'destination'>): Promise<ElectricBikeRouteResponse>;
+    /**
+     * 公交路径规划（新版 V5 API）
+     * @param origin 出发点坐标
+     * @param destination 目的地坐标
+     * @param city1 起点所在城市（citycode，必填）
+     * @param city2 目的地所在城市（citycode，必填）
+     * @param options 可选参数
+     * @returns 公交路径规划结果
+     *
+     * @example
+     * ```typescript
+     * // 同城公交（北京市 citycode: 010）
+     * const result = await api.route.transit(
+     *   '116.481028,39.989643',
+     *   '116.434446,39.90816',
+     *   '010',
+     *   '010',
+     *   {
+     *     strategy: TransitStrategy.RECOMMENDED,
+     *     show_fields: 'cost,polyline'
+     *   }
+     * );
+     *
+     * // 跨城公交（北京到上海，上海 citycode: 021）
+     * const result = await api.route.transit(
+     *   '116.481028,39.989643',
+     *   '121.472644,31.231706',
+     *   '010',
+     *   '021',
+     *   {
+     *     strategy: TransitStrategy.TIME_FIRST,
+     *     AlternativeRoute: 3
+     *   }
+     * );
+     *
+     * // 地铁图模式（起终点都是地铁站，需要提供 POI ID）
+     * const result = await api.route.transit(
+     *   '116.481028,39.989643',
+     *   '116.434446,39.90816',
+     *   '010',
+     *   '010',
+     *   {
+     *     strategy: TransitStrategy.SUBWAY_MAP,
+     *     originpoi: 'B000A83M2Z',
+     *     destinationpoi: 'B000A83M30'
+     *   }
+     * );
+     * ```
+     */
+    transit(origin: Coordinate, destination: Coordinate, city1: string, city2: string, options?: Omit<TransitRouteParams, 'origin' | 'destination' | 'city1' | 'city2'>): Promise<TransitRouteResponse>;
+}