@baidumap/vue-bmap 1.0.0 → 1.0.2

package/dist/components/Panorama/PanoramaRef.d.ts

@@ -0,0 +1,75 @@
+import { Point } from '../../types';
+import { PanoramaPOIType, PanoramaSceneType } from '../../constants';
+
+/** 全景视角：heading 水平角（正北 0/正东 90…），pitch 垂直角（可选） */
+export interface PanoramaPov {
+    heading: number;
+    pitch?: number;
+}
+/** 全景可配置项（对应 SDK PanoramaOptions） */
+export interface PanoramaOptions {
+    /** 是否显示导航控件，默认 true */
+    navigationControl?: boolean;
+    /** 是否显示道路指示控件，默认 true */
+    linksControl?: boolean;
+    /** 是否显示室内场景切换控件（仅室内景生效），默认 true */
+    indoorSceneSwitchControl?: boolean;
+    /** 是否显示相册控件，默认 false */
+    albumsControl?: boolean;
+    /** 相册控件配置 */
+    albumsControlOptions?: unknown;
+}
+/** <Panorama> 命令式句柄 */
+export interface PanoramaRef {
+    getPosition(): Point | null;
+    getPov(): PanoramaPov | null;
+    getZoom(): number | null;
+    getId(): string | null;
+    getLinks(): unknown[];
+    getVisible(): boolean;
+    getSceneType(): PanoramaSceneType | null;
+    setPosition(point: Point): void;
+    setId(id: string, options?: unknown): void;
+    setPov(pov: PanoramaPov, options?: unknown): void;
+    setZoom(zoom: number, options?: unknown): void;
+    setOptions(options: PanoramaOptions): void;
+    setPanoramaPOIType(poiType: PanoramaPOIType): void;
+    show(): void;
+    hide(): void;
+    enableScrollWheelZoom(): void;
+    disableScrollWheelZoom(): void;
+    capture(options?: {
+        quality?: number;
+        type?: string;
+    }): string | undefined;
+    clearOverlays(): void;
+    /** 原生全景实例逃生舱 */
+    raw: unknown;
+}
+export declare class PanoramaRefImpl implements PanoramaRef {
+    private pano;
+    constructor(pano: any);
+    get raw(): unknown;
+    getPosition(): Point | null;
+    getPov(): PanoramaPov | null;
+    getZoom(): number | null;
+    getId(): string | null;
+    getLinks(): unknown[];
+    getVisible(): boolean;
+    getSceneType(): PanoramaSceneType | null;
+    setPosition(point: Point): void;
+    setId(id: string, options?: unknown): void;
+    setPov(pov: PanoramaPov, options?: unknown): void;
+    setZoom(zoom: number, options?: unknown): void;
+    setOptions(options: PanoramaOptions): void;
+    setPanoramaPOIType(poiType: PanoramaPOIType): void;
+    show(): void;
+    hide(): void;
+    enableScrollWheelZoom(): void;
+    disableScrollWheelZoom(): void;
+    capture(options?: {
+        quality?: number;
+        type?: string;
+    }): string | undefined;
+    clearOverlays(): void;
+}

package/dist/components/Panorama/index.d.ts

@@ -0,0 +1,306 @@
+import { PropType, StyleValue } from 'vue';
+import { Point } from '../../types';
+import { PanoramaPOIType } from '../../constants';
+import { PanoramaPov, PanoramaOptions } from './PanoramaRef';
+
+export type { PanoramaRef, PanoramaPov, PanoramaOptions } from './PanoramaRef';
+export interface PanoramaProps {
+    point?: Point;
+    /** 通过全景 id 展示（与 point 二选一） */
+    id?: string;
+    /** 全景视角（heading 必填，pitch 可选） */
+    pov?: PanoramaPov;
+    /** 缩放级别 */
+    zoom?: number;
+    /** 全景配置：导航/道路/室内切换/相册控件 */
+    options?: PanoramaOptions;
+    /** 显隐控制：true→show()，false→hide() */
+    visible?: boolean;
+    /** 鼠标滚轮缩放开关 */
+    enableScrollWheelZoom?: boolean;
+    /** 外景场景点内可见的 POI 类型 */
+    poiType?: PanoramaPOIType;
+    style?: StyleValue;
+    className?: string;
+    /** 全景位置变化回调（position_changed） */
+    onPositionChange?: (point: Point) => void;
+    /** 视角变化回调（pov_changed） */
+    onPovChange?: () => void;
+    /** 相邻道路数据变化回调（links_changed） */
+    onLinksChange?: () => void;
+    /** 缩放级别变化回调（zoom_changed） */
+    onZoomChange?: (zoom: number) => void;
+    /** 单击全景画面（click） */
+    onClick?: (e: unknown) => void;
+    /** 双击全景画面（dblclick） */
+    onDblClick?: (e: unknown) => void;
+    /** 单击道路链接（link_click） */
+    onLinkClick?: (e: unknown) => void;
+    /** 全景 id 变化（id_changed） */
+    onIdChange?: (id: string) => void;
+    /** 场景类型变化（scene_type_changed） */
+    onSceneTypeChange?: () => void;
+    /** 全景数据加载失败（pano_error） */
+    onError?: (e: unknown) => void;
+    /** 全景数据加载完成（dataload） */
+    onDataLoad?: (e: unknown) => void;
+}
+export declare const Panorama: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    point: {
+        type: PropType<Point>;
+        default: any;
+    };
+    id: {
+        type: StringConstructor;
+        default: any;
+    };
+    pov: {
+        type: PropType<PanoramaPov>;
+        default: any;
+    };
+    zoom: {
+        type: NumberConstructor;
+        default: any;
+    };
+    options: {
+        type: PropType<PanoramaOptions>;
+        default: any;
+    };
+    visible: {
+        type: BooleanConstructor;
+        default: any;
+    };
+    enableScrollWheelZoom: {
+        type: BooleanConstructor;
+        default: any;
+    };
+    poiType: {
+        type: PropType<PanoramaPOIType>;
+        default: any;
+    };
+    style: {
+        default: any;
+    };
+    className: {
+        type: StringConstructor;
+        default: any;
+    };
+    onPositionChange: {
+        type: PropType<(point: Point) => void>;
+        default: any;
+    };
+    onPovChange: {
+        type: PropType<() => void>;
+        default: any;
+    };
+    onLinksChange: {
+        type: PropType<() => void>;
+        default: any;
+    };
+    onZoomChange: {
+        type: PropType<(zoom: number) => void>;
+        default: any;
+    };
+    onClick: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+    onDblClick: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+    onLinkClick: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+    onIdChange: {
+        type: PropType<(id: string) => void>;
+        default: any;
+    };
+    onSceneTypeChange: {
+        type: PropType<() => void>;
+        default: any;
+    };
+    onError: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+    onDataLoad: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    point: {
+        type: PropType<Point>;
+        default: any;
+    };
+    id: {
+        type: StringConstructor;
+        default: any;
+    };
+    pov: {
+        type: PropType<PanoramaPov>;
+        default: any;
+    };
+    zoom: {
+        type: NumberConstructor;
+        default: any;
+    };
+    options: {
+        type: PropType<PanoramaOptions>;
+        default: any;
+    };
+    visible: {
+        type: BooleanConstructor;
+        default: any;
+    };
+    enableScrollWheelZoom: {
+        type: BooleanConstructor;
+        default: any;
+    };
+    poiType: {
+        type: PropType<PanoramaPOIType>;
+        default: any;
+    };
+    style: {
+        default: any;
+    };
+    className: {
+        type: StringConstructor;
+        default: any;
+    };
+    onPositionChange: {
+        type: PropType<(point: Point) => void>;
+        default: any;
+    };
+    onPovChange: {
+        type: PropType<() => void>;
+        default: any;
+    };
+    onLinksChange: {
+        type: PropType<() => void>;
+        default: any;
+    };
+    onZoomChange: {
+        type: PropType<(zoom: number) => void>;
+        default: any;
+    };
+    onClick: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+    onDblClick: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+    onLinkClick: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+    onIdChange: {
+        type: PropType<(id: string) => void>;
+        default: any;
+    };
+    onSceneTypeChange: {
+        type: PropType<() => void>;
+        default: any;
+    };
+    onError: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+    onDataLoad: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+}>> & Readonly<{}>, {
+    visible: boolean;
+    point: Point;
+    style: unknown;
+    zoom: number;
+    enableScrollWheelZoom: boolean;
+    onError: (e: unknown) => void;
+    id: string;
+    onClick: (e: unknown) => void;
+    onDblClick: (e: unknown) => void;
+    options: PanoramaOptions;
+    onZoomChange: (zoom: number) => void;
+    className: string;
+    pov: PanoramaPov;
+    poiType: PanoramaPOIType;
+    onPositionChange: (point: Point) => void;
+    onPovChange: () => void;
+    onLinksChange: () => void;
+    onLinkClick: (e: unknown) => void;
+    onIdChange: (id: string) => void;
+    onSceneTypeChange: () => void;
+    onDataLoad: (e: unknown) => void;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export interface PanoramaLabelProps {
+    position: Point;
+    altitude?: number;
+    content?: string;
+    /** 是否显示标签到当前全景场景点的距离，默认 true */
+    displayDistance?: boolean;
+    /** 自定义标签 css 样式 */
+    customStyle?: StyleValue;
+    /** 点击标注回调 */
+    onClick?: (e: unknown) => void;
+}
+export declare const PanoramaLabel: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    position: {
+        type: PropType<Point>;
+        required: true;
+    };
+    altitude: {
+        type: NumberConstructor;
+        default: any;
+    };
+    content: {
+        type: StringConstructor;
+        default: any;
+    };
+    displayDistance: {
+        type: BooleanConstructor;
+        default: any;
+    };
+    customStyle: {
+        default: any;
+    };
+    onClick: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+}>, () => any, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    position: {
+        type: PropType<Point>;
+        required: true;
+    };
+    altitude: {
+        type: NumberConstructor;
+        default: any;
+    };
+    content: {
+        type: StringConstructor;
+        default: any;
+    };
+    displayDistance: {
+        type: BooleanConstructor;
+        default: any;
+    };
+    customStyle: {
+        default: any;
+    };
+    onClick: {
+        type: PropType<(e: unknown) => void>;
+        default: any;
+    };
+}>> & Readonly<{}>, {
+    altitude: number;
+    content: string;
+    displayDistance: boolean;
+    customStyle: unknown;
+    onClick: (e: unknown) => void;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/composables/index.d.ts

@@ -10,3 +10,35 @@ export { useGeocoder } from './useGeocoder';
 export type { GeocoderHookResult } from './useGeocoder';
 export { useServiceTimeout, serviceTimeoutError, SERVICE_TIMEOUT_MS } from './useServiceTimeout';
 export type { ServiceTimeoutControl } from './useServiceTimeout';
+export { useDrivingRoute } from './useDrivingRoute';
+export type { DrivingRouteOptions, DrivingRouteHookResult, DrivingRouteRenderOptions } from './useDrivingRoute';
+export { useWalkingRoute } from './useWalkingRoute';
+export type { WalkingRouteOptions, WalkingRouteHookResult } from './useWalkingRoute';
+export { useRidingRoute } from './useRidingRoute';
+export type { RidingRouteOptions, RidingRouteHookResult } from './useRidingRoute';
+export { useTransitRoute } from './useTransitRoute';
+export type { TransitRouteOptions, TransitRouteHookResult } from './useTransitRoute';
+export { useTruckRoute } from './useTruckRoute';
+export type { TruckRouteOptions, TruckRouteHookResult } from './useTruckRoute';
+export { useLocalSearch } from './useLocalSearch';
+export type { LocalSearchOptions, LocalSearchHookResult, LocalSearchRenderOptions } from './useLocalSearch';
+export { useAutocomplete } from './useAutocomplete';
+export type { AutocompleteOptions, AutocompleteHookResult } from './useAutocomplete';
+export { useBusLineSearch } from './useBusLineSearch';
+export type { BusLineSearchOptions, BusLineSearchHookResult } from './useBusLineSearch';
+export { usePlaceDetail } from './usePlaceDetail';
+export type { PlaceDetailOptions, PlaceDetailHookResult } from './usePlaceDetail';
+export { useBoundary } from './useBoundary';
+export type { BoundaryHookResult } from './useBoundary';
+export { useLocalCity } from './useLocalCity';
+export type { LocalCityHookResult } from './useLocalCity';
+export { useConvertor } from './useConvertor';
+export type { ConvertorHookResult } from './useConvertor';
+export { useGeolocation } from './useGeolocation';
+export type { GeolocationHookResult } from './useGeolocation';
+export { usePanoramaService } from './usePanoramaService';
+export type { PanoramaServiceHookResult } from './usePanoramaService';
+export { useMapStatus } from './useMapStatus';
+export type { MapSnapshot } from './useMapStatus';
+export { useRawControl } from './useRawControl';
+export { useRawOverlay } from './useRawOverlay';

package/dist/composables/renderHelpers.d.ts

@@ -0,0 +1,12 @@
+import { BMapDriver } from '../drivers/types';
+
+/**
+ * 缺省 location 时的回退值：
+ * - 正常（会渲染）：用 renderMap（Map 实例）——与原生 `new BMap.XxxSearch(map, ...)` 一致
+ * - dataOnly（autoRender:false，仅取数据）：用地图中心点 Point，避免把 Map 交给 SDK 触发自动渲染
+ * renderMap 为空时返回空串（交给 SDK 用默认区域）。
+ */
+export declare function fallbackLocation(driver: BMapDriver, renderMap: {
+    __brand: string;
+    raw: unknown;
+} | null | undefined, dataOnly: boolean): unknown;

package/dist/composables/useAutocomplete.d.ts

@@ -0,0 +1,37 @@
+import { Ref } from 'vue';
+
+export interface AutocompleteOptions {
+    location?: unknown;
+    types?: string[];
+    input?: string | HTMLElement;
+    /** renderOptions.map 非必传：`<Map>` 内部自动取当前地图，外层需显式传已就绪 handle；见 `useMap`/`useMapReady`。 */
+    renderOptions?: {
+        map?: unknown;
+        panel?: string | HTMLElement;
+    };
+    onSearchComplete?: (results: unknown) => void;
+    /** 用户选中某条建议项时触发（对应 SDK 构造项 onConfirm / 原生 onconfirm 事件） */
+    onConfirm?: (item: unknown) => void;
+    /** 高亮项变化时触发（current, previous）（对应 SDK 构造项 onHighlight / 原生 onhighlight 事件） */
+    onHighlight?: (current: unknown, previous?: unknown) => void;
+}
+export interface AutocompleteHookResult {
+    data: Ref<unknown>;
+    loading: Ref<boolean>;
+    error: Ref<Error | null>;
+    supported: Ref<boolean>;
+    search: (keywords: string) => void;
+    show: () => void;
+    hide: () => void;
+    getResults: () => unknown;
+    /** 设置绑定输入框的值 */
+    setInputValue: (value: string) => void;
+    /** 运行时设置返回结果类型限定 */
+    setTypes: (types: string[]) => void;
+    /** 运行时设置检索城市/区域 */
+    setLocation: (location: unknown) => void;
+    /** 最近一次的状态码 */
+    getStatus: () => number | undefined;
+    cancel: () => void;
+}
+export declare function useAutocomplete(opts?: AutocompleteOptions): AutocompleteHookResult;

package/dist/composables/useBoundary.d.ts

@@ -0,0 +1,14 @@
+import { Ref } from 'vue';
+import { BoundaryResult } from '../types/results';
+
+export interface BoundaryHookResult {
+    data: Ref<BoundaryResult | undefined>;
+    loading: Ref<boolean>;
+    error: Ref<Error | null>;
+    supported: Ref<boolean>;
+    get: (name: string) => void;
+    /** 把 SDK 返回的边界字符串（"lng,lat;lng,lat;…"）解析成点集，对应 SDK parsebdStr，2.0.4 新增 */
+    parsebdStr: (boundaryStr: string) => unknown;
+    cancel: () => void;
+}
+export declare function useBoundary(): BoundaryHookResult;

package/dist/composables/useBusLineSearch.d.ts

@@ -0,0 +1,35 @@
+import { Ref } from 'vue';
+
+export interface BusLineSearchOptions {
+    location?: unknown;
+    /** renderOptions.map 非必传：`<Map>` 内部自动取当前地图，外层需显式传已就绪 handle；见 `useMap`/`useMapReady`。 */
+    renderOptions?: {
+        map?: unknown;
+        panel?: string | HTMLElement;
+        autoViewport?: boolean;
+    };
+    /** 是否自动在地图上渲染线路（默认 true）。传 false＝仅取数据：不注入地图、缺省 location 用中心点，避免自动画线路。 */
+    autoRender?: boolean;
+    onGetBusListComplete?: (results: unknown) => void;
+    onGetBusLineComplete?: (results: unknown) => void;
+}
+export interface BusLineSearchHookResult {
+    data: Ref<unknown>;
+    loading: Ref<boolean>;
+    error: Ref<Error | null>;
+    supported: Ref<boolean>;
+    getBusList: (keyword: string) => void;
+    getBusLine: (item: unknown) => void;
+    /** 只清 hook 的 data 状态；SDK 无原生 clear，地图上已渲染的线路不受影响 */
+    clearResults: () => void;
+    /** 开启检索后自动调整视野 */
+    enableAutoViewport: () => void;
+    /** 关闭自动调整视野 */
+    disableAutoViewport: () => void;
+    /** 运行时设置检索城市/区域 */
+    setLocation: (location: unknown) => void;
+    /** 最近一次检索的状态码（BMAP_STATUS_*） */
+    getStatus: () => number | undefined;
+    cancel: () => void;
+}
+export declare function useBusLineSearch(opts?: BusLineSearchOptions): BusLineSearchHookResult;

package/dist/composables/useConvertor.d.ts

@@ -0,0 +1,13 @@
+import { Ref } from 'vue';
+import { Point } from '../types';
+import { TranslateResults } from '../types/results';
+
+export interface ConvertorHookResult {
+    data: Ref<TranslateResults | undefined>;
+    loading: Ref<boolean>;
+    error: Ref<Error | null>;
+    supported: Ref<boolean>;
+    translate: (points: Point[], from?: number, to?: number) => void;
+    cancel: () => void;
+}
+export declare function useConvertor(): ConvertorHookResult;

package/dist/composables/useDrivingRoute.d.ts

@@ -0,0 +1,64 @@
+import { Ref } from 'vue';
+import { Point, MapHandle } from '../types';
+import { DrivingRouteResult } from '../types/results';
+
+export interface DrivingRouteRenderOptions {
+    /**
+     * 在地图上渲染路线用的 MapHandle。**非必传**：
+     * - composable 用在 `<Map>` **内部**（子树里）时，不传会自动取当前地图；
+     * - composable 用在 `<Map>` **外层**时，context 取不到，需显式传**已就绪**的 handle（非 null）。
+     * 显式传入始终优先于自动获取。
+     */
+    map?: MapHandle;
+    panel?: string | HTMLElement;
+    selectFirstResult?: boolean;
+    autoViewport?: boolean;
+    viewportOptions?: {
+        noAnimation?: boolean;
+        margins?: number[];
+        zoomFactor?: number;
+    };
+    /** 拖拽起终点重新规划（仅驾车/公交/货车生效；步行、骑行 SDK 内部强制关闭）。 */
+    enableDragging?: boolean;
+}
+export interface DrivingRouteOptions {
+    /**
+     * 检索上下文（城市/坐标/地图）。**非必传**：缺省时自动回退到当前 `<Map>`（或 `renderOptions.map`）。
+     * 只在需要指定特定城市时才显式传。
+     */
+    location?: string | MapHandle;
+    policy?: number;
+    /** 是否同时返回多条备选路线（对应 SDK DrivingRoute 构造项 alternatives）。仅驾车支持。 */
+    alternatives?: boolean;
+    /**
+     * 是否自动在地图上渲染路线（默认 true）。传 `false`＝**仅取数据**：不注入 renderOptions.map，
+     * 缺省 location 时用地图中心点（而非 Map 实例）作检索上下文。
+     */
+    autoRender?: boolean;
+    renderOptions?: DrivingRouteRenderOptions;
+    onSearchComplete?: (results: DrivingRouteResult) => void;
+    onMarkersSet?: (pois: unknown[]) => void;
+    onInfoHtmlSet?: (poi: unknown, html: HTMLElement) => void;
+    onPolylinesSet?: (polylines: unknown[]) => void;
+    onResultsHtmlSet?: (container: HTMLElement) => void;
+}
+export interface DrivingRouteHookResult {
+    data: Ref<DrivingRouteResult | undefined>;
+    loading: Ref<boolean>;
+    error: Ref<Error | null>;
+    supported: Ref<boolean>;
+    /** 搜索（start/end 必须是 Point，不支持字符串地址） */
+    search: (start: Point, end: Point, options?: {
+        waypoints?: Point[];
+    }) => void;
+    clearResults: () => void;
+    enableAutoViewport: () => void;
+    disableAutoViewport: () => void;
+    setPolicy: (policy: number) => void;
+    setLocation: (location: string | MapHandle) => void;
+    /** 运行时设置路线折线样式（strokeColor / strokeWeight / strokeOpacity 等） */
+    setPolylineStyle: (style: Record<string, unknown>) => void;
+    getStatus: () => number | undefined;
+    cancel: () => void;
+}
+export declare function useDrivingRoute(opts?: DrivingRouteOptions): DrivingRouteHookResult;

package/dist/composables/useGeolocation.d.ts

@@ -0,0 +1,16 @@
+import { Ref } from 'vue';
+
+export interface GeolocationHookResult {
+    data: Ref<unknown>;
+    loading: Ref<boolean>;
+    error: Ref<Error | null>;
+    supported: Ref<boolean>;
+    getCurrentPosition: (options?: unknown) => void;
+    getStatus: () => number | undefined;
+    enableSDKLocation: () => void;
+    disableSDKLocation: () => void;
+    cancel: () => void;
+}
+export declare function useGeolocation(opts?: {
+    enableSDKLocation?: boolean;
+}): GeolocationHookResult;

package/dist/composables/useLocalCity.d.ts

@@ -0,0 +1,12 @@
+import { Ref } from 'vue';
+import { LocalCityResult } from '../types/results';
+
+export interface LocalCityHookResult {
+    data: Ref<LocalCityResult | undefined>;
+    loading: Ref<boolean>;
+    error: Ref<Error | null>;
+    supported: Ref<boolean>;
+    get: () => void;
+    cancel: () => void;
+}
+export declare function useLocalCity(): LocalCityHookResult;