tg-map-vue3 3.1.9 → 3.2.0

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

@@ -17,6 +17,7 @@ export * from '../map/map/controls/zoom.control';
 export * from '../map/map/extra/autocomplete';
 export * from '../map/map/extra/marker-clusterer';
 export * from '../map/map/extra/places-service';
+export * from '../map/map/extra/search-box';
 export * from '../map/map/map';
 export * from '../map/map/overlay/circle';
 export * from '../map/map/overlay/icon';

package/dist/src/map/event-target.d.ts

@@ -1,3 +1,4 @@
+import type { AbstractMap, AbstractMapEventMap } from '../components';
 import { type Tg } from './event';
 import { type CoordTypeSupplier } from './lat-lng';
 import type { UnionBaiduEventTarget, UnionGoogleEventTarget } from './unions';
@@ -14,6 +15,7 @@ export interface RemoveEventListenerFunction {
 export declare function addGoogleEventListener(target: UnionGoogleEventTarget, type: string, listener: (...args: any[]) => void): RemoveEventListenerFunction;
 export declare function addBaiduEventListener(target: UnionBaiduEventTarget, type: string, listener: (...args: any[]) => void): RemoveEventListenerFunction;
 export declare function addHtmlEventListener<K extends keyof EventMap, EventMap = HTMLElementEventMap, T extends EventTarget = HTMLElement>(target: T, type: K, listener: (this: T, ev: EventMap[K]) => any, options?: AddEventListenerOptions | boolean): RemoveEventListenerFunction;
+export declare function addTgEventListener<K extends keyof EventMap, EventMap = AbstractMapEventMap, T extends Tg.EventTarget = AbstractMap>(target: T, type: K, listener: (this: T, ev: EventMap[K]) => any): RemoveEventListenerFunction;
 /**
  * ## Delegate(代理) VS Mixin(混合)
  * Delegate相对于Mixin的优点是调用路径更明确, 缺点是js/ts原生不支持, 需要写样板代码

package/dist/src/map/map/baidu-map.d.ts

@@ -7,6 +7,7 @@ import { BaiduZoomControl } from './controls/zoom.control';
 import { type Autocomplete, type AutocompleteOptions } from './extra/autocomplete';
 import { BaiduMarkerClusterer, type MarkerClustererOptions } from './extra/marker-clusterer';
 import { type PlaceServiceOptions, type PlacesService } from './extra/places-service';
+import { type SearchBox, type SearchBoxOptions } from './extra/search-box';
 import { AbstractMap, type AbstractMapEventMap } from './map';
 import { GestureHandlingOptions, MapOptions, type MapStyle } from './map-options';
 import { BuildInMapTypeId, MapType, type Layer } from './map-type';
@@ -68,5 +69,6 @@ export declare class BaiduMap extends AbstractMap {
     createScaleControl: typeof BaiduScaleControl.create;
     createMarkerClusterer(options: MarkerClustererOptions): BaiduMarkerClusterer;
     createAutocomplete(options: AutocompleteOptions): Autocomplete;
+    createSearchBox(options: SearchBoxOptions): SearchBox;
     createPlaceService(options: PlaceServiceOptions): PlacesService;
 }

package/dist/src/map/map/extra/autocomplete.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="google.maps" />
-import { type EventCallback } from '../../../components';
+import type { EventCallback, LatLngBounds } from '../../../components';
 import { type AddressFields } from '../../../utils/google-utils';
 import { type RemoveEventListenerFunction } from '../../event-target';
 import type { UnionAutocomplete } from '../../unions';
@@ -12,25 +12,31 @@ export interface AutocompleteResult extends AddressFields {
 }
 export interface AutocompleteOptions {
     input: HTMLInputElement;
+    /** 将{@link Autocomplete.setBounds}自动设为地图的当前范围 */
     bindToMap?: boolean;
 }
 /**
  * 该类没有太多事件, 故没有去实现{@link Tg.EventTarget}接口
  */
 export declare abstract class Autocomplete {
-    map: AbstractMap;
     abstract inner: UnionAutocomplete;
-    constructor(map: AbstractMap);
+    abstract map: AbstractMap;
     abstract addResultListener(listener: EventCallback<AutocompleteResult>): RemoveEventListenerFunction;
+    abstract setBounds(bounds: LatLngBounds): void;
 }
 export declare class GoogleAutocomplete extends Autocomplete {
+    map: GoogleMap;
     inner: google.maps.places.Autocomplete;
     constructor(map: GoogleMap, options: AutocompleteOptions);
+    setBounds(bounds: LatLngBounds): void;
     addResultListener(listener: EventCallback<AutocompleteResult>): RemoveEventListenerFunction;
 }
 export declare class BaiduAutocomplete extends Autocomplete {
+    map: BaiduMap;
     inner: BMap.Autocomplete;
     private input;
+    private removeableArray;
     constructor(map: BaiduMap, options: AutocompleteOptions);
+    setBounds(bounds: LatLngBounds): void;
     addResultListener(listener: EventCallback<AutocompleteResult>): RemoveEventListenerFunction;
 }

package/dist/src/map/map/extra/places-service.d.ts

@@ -16,27 +16,32 @@ export interface Place {
 export interface PlaceServiceOptions {
 }
 export declare abstract class PlacesService {
-    map: AbstractMap;
     abstract inner: UnionPlacesService;
-    constructor(map: AbstractMap);
-    abstract search(query: string): Promise<Place[]>;
+    abstract map: AbstractMap;
+    constructor();
+    /** 指定{@link location}搜索, 若不指定, 则默认使用地图的中心点 */
+    abstract search(query: string, location?: string | LatLng): Promise<Place[]>;
+    /** 在指定的bounds范围内搜索 */
     abstract searchInBounds(query: string, bounds: LatLngBounds): Promise<Place[]>;
+    /** 在指定的center+radius范围内搜索 */
     abstract searchNearBy(query: string, center: LatLng, radius: number): Promise<Place[]>;
 }
 export declare class GooglePlacesService extends PlacesService {
+    map: GoogleMap;
     inner: google.maps.places.PlacesService;
     constructor(map: GoogleMap, options: PlaceServiceOptions);
-    search(query: string): Promise<Place[]>;
+    search(query: string, location?: string | LatLng): Promise<Place[]>;
     searchInBounds(query: string, bounds: LatLngBounds): Promise<Place[]>;
     searchNearBy(query: string, center: LatLng, radius: number): Promise<Place[]>;
     private searchImpl;
 }
 export declare class BaiduPlacesService extends PlacesService {
+    map: BaiduMap;
     private searchRequestMap;
     get inner(): BMap.LocalSearch;
     currentSearch: BMap.LocalSearch | undefined;
     constructor(map: BaiduMap, options: PlaceServiceOptions);
-    search(query: string): Promise<Place[]>;
+    search(query: string, location?: string | LatLng): Promise<Place[]>;
     searchInBounds(query: string, bounds: LatLngBounds): Promise<Place[]>;
     searchNearBy(query: string, center: LatLng, radius: number): Promise<Place[]>;
     private newSearch;

package/dist/src/map/map/extra/search-box.d.ts

@@ -0,0 +1,38 @@
+import type { EventCallback } from '../../../utils/vue-utils';
+import { type RemoveEventListenerFunction } from '../../event-target';
+import type { BaiduMap } from '../baidu-map';
+import type { GoogleMap } from '../google-map';
+import type { AbstractMap } from '../map';
+import type { Place } from './places-service';
+export interface SearchBoxOptions {
+    input: HTMLInputElement;
+}
+export declare abstract class SearchBox {
+    map: AbstractMap;
+    protected input: HTMLInputElement;
+    protected onData: EventCallback<Place[]> | undefined;
+    protected onError: ((e: any) => void) | undefined;
+    constructor(map: AbstractMap, input: HTMLInputElement);
+    /**
+     * 设置搜索结果监听
+     *
+     * @mustCallSuper 子类必须调用一次`super.setSearchListener`, 用来保存{@link onData}和{@link onError}
+     * */
+    setSearchListener(onData: EventCallback<Place[]>, onError?: (e: any) => void): RemoveEventListenerFunction;
+    /** 用输入框的内容执行一次搜索 */
+    abstract search(): void;
+}
+export declare class GoogleSearchBox extends SearchBox {
+    private searchBox;
+    constructor(map: GoogleMap, options: SearchBoxOptions);
+    setSearchListener(onData: EventCallback<Place[]>, onError?: (e: any) => void): RemoveEventListenerFunction;
+    search(): void;
+}
+export declare class BaiduSearchBox extends SearchBox {
+    private autocomplete;
+    private placeService;
+    constructor(map: BaiduMap, options: SearchBoxOptions);
+    setSearchListener(onData: EventCallback<Place[]>, onError?: (e: any) => void): RemoveEventListenerFunction;
+    search(): void;
+    private searchImpl;
+}

package/dist/src/map/map/google-map.d.ts

@@ -8,6 +8,7 @@ import { GoogleZoomControl } from './controls/zoom.control';
 import { Autocomplete, type AutocompleteOptions } from './extra/autocomplete';
 import { GoogleMarkerClusterer, type MarkerClustererOptions } from './extra/marker-clusterer';
 import { type PlaceServiceOptions, type PlacesService } from './extra/places-service';
+import { SearchBox, type SearchBoxOptions } from './extra/search-box';
 import { AbstractMap } from './map';
 import type { GestureHandlingOptions, MapOptions, MapStyle } from './map-options';
 import { BuildInMapTypeId, MapType, type Layer, type OverlayMapType } from './map-type';
@@ -68,5 +69,6 @@ export declare class GoogleMap extends AbstractMap {
     createScaleControl: typeof GoogleScaleControl.create;
     createMarkerClusterer(options: MarkerClustererOptions): GoogleMarkerClusterer;
     createAutocomplete(options: AutocompleteOptions): Autocomplete;
+    createSearchBox(options: SearchBoxOptions): SearchBox;
     createPlaceService(options: PlaceServiceOptions): PlacesService;
 }

package/dist/src/map/map/here-map.d.ts

@@ -2,6 +2,7 @@
 import { CoordType, LatLng } from '../lat-lng';
 import type { Autocomplete, AutocompleteOptions } from './extra/autocomplete';
 import type { PlaceServiceOptions, PlacesService } from './extra/places-service';
+import type { SearchBox, SearchBoxOptions } from './extra/search-box';
 import { AbstractMap } from './map';
 import type { MapOptions } from './map-options';
 export declare class HereMap extends AbstractMap {
@@ -49,5 +50,6 @@ export declare class HereMap extends AbstractMap {
     createZoomControl(options: import('./controls/zoom.control').ZoomControlOptions): import('./controls/zoom.control').ZoomControl;
     createScaleControl(options: import('./controls/scale.control').ScaleControlOptions): import('./controls/zoom.control').ZoomControl;
     createAutocomplete(options: AutocompleteOptions): Autocomplete;
+    createSearchBox(options: SearchBoxOptions): SearchBox;
     createPlaceService(options: PlaceServiceOptions): PlacesService;
 }

package/dist/src/map/map/map.d.ts

@@ -10,6 +10,7 @@ import type { ZoomControl, ZoomControlOptions } from './controls/zoom.control';
 import type { Autocomplete, AutocompleteOptions } from './extra/autocomplete';
 import type { MarkerClusterer, MarkerClustererOptions } from './extra/marker-clusterer';
 import type { PlaceServiceOptions, PlacesService } from './extra/places-service';
+import type { SearchBox, SearchBoxOptions } from './extra/search-box';
 import type { GestureHandlingOptions, MapStyle } from './map-options';
 import type { BuildInMapTypeId, Layer, MapType, OverlayMapType } from './map-type';
 import type { CircleOptions, CircleOverlay } from './overlay/circle';
@@ -122,6 +123,7 @@ export declare abstract class AbstractMap implements CoordTypeSupplier, Tg.Event
     abstract createMarker(options: MarkerOptions): MarkerOverlay;
     abstract createMarkerClusterer(options: MarkerClustererOptions): MarkerClusterer;
     abstract createAutocomplete(options: AutocompleteOptions): Autocomplete;
+    abstract createSearchBox(options: SearchBoxOptions): SearchBox;
     abstract createPlaceService(options: PlaceServiceOptions): PlacesService;
     abstract createInfoWindow(options: InfoWindowOptions): InfoWindowOverlay;
     abstract createInfoBox(options: InfoBoxOptions): InfoBoxOverlay;

package/dist/src/map/unions.d.ts

@@ -10,7 +10,7 @@ import type { GoogleLabel } from './map/overlay/google-label';
 export type UnionMap = google.maps.Map | BMap.Map | H.Map;
 export type UnionIcon = google.maps.Icon | google.maps.Symbol | google.maps.UrlIcon | BMap.Icon;
 export type UnionInfoWindow = google.maps.InfoWindow | BMap.InfoWindow;
-export type UnionAutocomplete = google.maps.places.Autocomplete | google.maps.places.SearchBox | BMap.Autocomplete;
+export type UnionAutocomplete = google.maps.places.Autocomplete | BMap.Autocomplete;
 export type UnionPlacesService = google.maps.places.PlacesService | BMap.LocalSearch;
 export type UnionGoogleOverlay = google.maps.Marker | google.maps.Polyline | google.maps.Polygon | google.maps.Circle | google.maps.Rectangle | GoogleLabel;
 export type UnionBaiduOverlay = BMap.Marker | BMap.Polyline | BMap.Polygon | BMap.Circle | BMap.Label | BaiduInfoBox;

package/dist/src/utils/google-utils.d.ts

@@ -1,4 +1,6 @@
 /// <reference types="google.maps" />
+import { type CoordTypeSupplier } from '../map/lat-lng';
+import type { Place } from '../map/map/extra/places-service';
 /**
  * Google地图官方提供的载入方式, 使用{@link google.map.importLibrary}动态载入依赖
  *
@@ -29,3 +31,4 @@ export interface AddressFields {
     streetNumber: string;
 }
 export declare function parseGoogleAddressComponents(addressComponents: google.maps.GeocoderAddressComponent[], outResult?: AddressFields): AddressFields;
+export declare function parseGooglePlace(place: google.maps.places.PlaceResult, coordTypeSupplier: CoordTypeSupplier): Place;