tg-map-vue3 3.7.9 → 3.7.11

package/CHANGELOG.md

@@ -5,6 +5,7 @@
 - feat: 添加[IconSequence]到[TgPolyline]中
 - fix: 多个地图同时载入时报错的问题
 - feat: [TgMarker]添加`autoAddToClusterer`属性, 可以不被点聚合管理
+- feat: 添加[热力图][TgHeatmap]功能
 - ***BREAKING CHANGE***: [MapStyle]简化成纯对象, 方便使用
 - ***BREAKING CHANGE***: 增加[TgStreetViewControl], 默认关闭google的街景控制按钮
 
@@ -60,6 +61,7 @@
 [TgMarker]: src/components/overlays/TgMarker.vue
 [TgInfoBox]: src/components/overlays/TgInfoBox.vue
 [TgInfoWindow]: src/components/overlays/TgInfoWindow.vue
+[TgHeatmap]: src/components/extra/TgHeatmap.vue "热力图"
 [TgStreetViewControl]: src/components/controls/TgStreetViewControl.vue
 [Icon]: src/map/map/overlay/icon.ts#L18 "图标"
 [SymbolIcon]: src/map/map/overlay/icon.ts#L139 "Svg图标"

package/dist/src/components/TgMap.vue.d.ts

@@ -69,10 +69,7 @@ declare const _default: import("vue").DefineComponent<{
         type: PropType<"single" | "multi">;
     };
     gestureHandling: {
-        type: PropType<StringEnumValue<typeof GestureHandlingOptions>>; /**
-         * 仅用来获取center的值, 需要设置center的值请使用`center`属性
-         * @see center
-         * */
+        type: PropType<StringEnumValue<typeof GestureHandlingOptions>>;
     };
     minZoom: {
         type: PropType<number>;
@@ -84,10 +81,7 @@ declare const _default: import("vue").DefineComponent<{
         type: PropType<MapStyle>;
     };
     mapTypeId: {
-        type: PropType<StringEnumValue<typeof BuildInMapTypeId>>; /**
-         * 仅用来获取center的值, 需要设置center的值请使用`center`属性
-         * @see center
-         * */
+        type: PropType<StringEnumValue<typeof BuildInMapTypeId>>;
     };
     /** 地图类型对象, 优先级比mapTypeId高 */
     mapType: {
@@ -169,10 +163,7 @@ declare const _default: import("vue").DefineComponent<{
         type: PropType<"single" | "multi">;
     };
     gestureHandling: {
-        type: PropType<StringEnumValue<typeof GestureHandlingOptions>>; /**
-         * 仅用来获取center的值, 需要设置center的值请使用`center`属性
-         * @see center
-         * */
+        type: PropType<StringEnumValue<typeof GestureHandlingOptions>>;
     };
     minZoom: {
         type: PropType<number>;
@@ -184,10 +175,7 @@ declare const _default: import("vue").DefineComponent<{
         type: PropType<MapStyle>;
     };
     mapTypeId: {
-        type: PropType<StringEnumValue<typeof BuildInMapTypeId>>; /**
-         * 仅用来获取center的值, 需要设置center的值请使用`center`属性
-         * @see center
-         * */
+        type: PropType<StringEnumValue<typeof BuildInMapTypeId>>;
     };
     /** 地图类型对象, 优先级比mapTypeId高 */
     mapType: {

package/dist/src/components/extra/TgHeatmap.vue.d.ts

@@ -0,0 +1,37 @@
+import { createEmptyVNode } from '../../utils/vue-utils';
+declare const _default: import("vue").DefineComponent<{
+    maxIntensity: {
+        type: import("vue").PropType<number>;
+    };
+    gradient: {
+        type: import("vue").PropType<any>;
+    };
+    opacity: {
+        type: import("vue").PropType<number>;
+    };
+    radius: {
+        type: import("vue").PropType<number>;
+    };
+    data: {
+        type: import("vue").PropType<import("../../map/map/extra/heatmap").HeatmapData>;
+        required: true;
+    };
+}, typeof createEmptyVNode, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    maxIntensity: {
+        type: import("vue").PropType<number>;
+    };
+    gradient: {
+        type: import("vue").PropType<any>;
+    };
+    opacity: {
+        type: import("vue").PropType<number>;
+    };
+    radius: {
+        type: import("vue").PropType<number>;
+    };
+    data: {
+        type: import("vue").PropType<import("../../map/map/extra/heatmap").HeatmapData>;
+        required: true;
+    };
+}>>, {}, {}>;
+export default _default;

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

@@ -10,12 +10,14 @@ export default TgMapPlugin;
 export { type Tg } from '../map/event';
 export * from '../map/lat-lng';
 export * from '../map/map-factory';
+export { loadCachedMap } from '../map/map-loader';
 export * from '../map/map/controls/control';
 export * from '../map/map/controls/map-type.control';
 export * from '../map/map/controls/scale.control';
 export * from '../map/map/controls/street-view.control';
 export * from '../map/map/controls/zoom.control';
 export * from '../map/map/extra/autocomplete';
+export * from '../map/map/extra/heatmap';
 export * from '../map/map/extra/map-urls';
 export * from '../map/map/extra/marker-clusterer';
 export * from '../map/map/extra/places-service';
@@ -50,6 +52,7 @@ export { default as TgMapTypeControl } from './controls/TgMapTypeControl.vue';
 export { default as TgScaleControl } from './controls/TgScaleControl.vue';
 export { default as TgStreetViewControl } from './controls/TgStreetViewControl.vue';
 export { default as TgZoomControl } from './controls/TgZoomControl.vue';
+export { default as TgHeatmap } from './extra/TgHeatmap.vue';
 export { default as TgMarkerClusterer } from './extra/TgMarkerClusterer.vue';
 export { default as TgTrafficLayer } from './layers/TgTrafficLayer.vue';
 export * from './map-hooks';

package/dist/src/map/lat-lng.d.ts

@@ -16,6 +16,10 @@ export interface LatLngLiteral {
     readonly lng: number;
     readonly coord?: CoordType;
 }
+export interface WeightedLatLng {
+    position: LatLng;
+    weight: number;
+}
 export declare class LatLng {
     /**
      * 纬度, 分南北, [-90, 90], 0点为赤道

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

@@ -6,6 +6,7 @@ import { BaiduScaleControl } from './controls/scale.control';
 import { BaiduStreetViewControl } from './controls/street-view.control';
 import { BaiduZoomControl } from './controls/zoom.control';
 import { type Autocomplete, type AutocompleteOptions } from './extra/autocomplete';
+import { type Heatmap, type HeatmapOptions } from './extra/heatmap';
 import { type MapUrls, type MapUrlsOptions } from './extra/map-urls';
 import { BaiduMarkerClusterer, type MarkerClustererOptions } from './extra/marker-clusterer';
 import { type PlacesService, type PlacesServiceOptions } from './extra/places-service';
@@ -73,6 +74,7 @@ export declare class BaiduMap extends AbstractMap {
     createStreetViewControl: typeof BaiduStreetViewControl.create;
     createScaleControl: typeof BaiduScaleControl.create;
     createMarkerClusterer(options: MarkerClustererOptions): BaiduMarkerClusterer;
+    createHeatmap(options: HeatmapOptions): Heatmap;
     createAutocomplete(options: AutocompleteOptions): Autocomplete;
     createSearchBox(options: SearchBoxOptions): SearchBox;
     createPlacesService(options: PlacesServiceOptions): PlacesService;

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

@@ -0,0 +1,72 @@
+/// <reference types="google.maps" />
+import BHeatMapOverlay from 'bmaplib.heatmap';
+import type { LatLng, WeightedLatLng } from '../../lat-lng';
+import type { BaiduMap } from '../baidu-map';
+import type { GoogleMap } from '../google-map';
+import type { AbstractMap } from '../map';
+type BHeatMapOverlay = InstanceType<typeof BHeatMapOverlay>;
+export interface HeatmapOptions {
+    data: HeatmapData;
+    /**
+     * 透明度
+     *
+     * ## 不同效果
+     * - google: 正常
+     * - baidu: 设置透明度后模糊效果有问题, 感觉是bug
+     */
+    opacity?: number;
+    /**
+     * 半径
+     *
+     * ## 默认半径的区别
+     * - google: 默认半径是10
+     * - baidu: 默认半径是40
+     *
+     * 这里统一成默认半径{@link RADIUS_DEFAULT}
+     */
+    radius?: number;
+    /**
+     * ## 不同实现
+     * - google: 接收颜色数组, 不能设置插值的位置
+     * - baidu: 接收`{.1: 'red', .9: 'green'}`形式的颜色对象, 可以指定插值的位置
+     */
+    gradient?: Record<number, string>;
+    maxIntensity?: number;
+}
+export type HeatmapData = (LatLng | WeightedLatLng)[];
+export declare abstract class Heatmap {
+    abstract inner: google.maps.visualization.HeatmapLayer | BHeatMapOverlay;
+    abstract map: AbstractMap;
+    /** 只更新data */
+    abstract setData(data: HeatmapData): void;
+    /** 一次性更新所有options */
+    abstract setOptions(options: HeatmapOptions): void;
+    /**
+     * 从地图上移除
+     * 创建之后会被立即添加到地图上, 故只有remove方法
+     * */
+    abstract remove(): void;
+}
+export declare class GoogleHeatmap extends Heatmap {
+    map: GoogleMap;
+    inner: google.maps.visualization.HeatmapLayer;
+    constructor(map: GoogleMap, options: HeatmapOptions);
+    setData(data: HeatmapData): void;
+    setOptions(options: HeatmapOptions): void;
+    remove(): void;
+}
+export declare class BaiduHeatmap extends Heatmap {
+    map: BaiduMap;
+    inner: BHeatMapOverlay;
+    /**
+     * 当前的最大值
+     * 直接读取/修改`inner.data.max`, 实现类似google那种, 可以直接设置最大值的效果
+     * */
+    private get innerDataMax();
+    private set innerDataMax(value);
+    constructor(map: BaiduMap, options: HeatmapOptions);
+    setData(data: HeatmapData): void;
+    setOptions(options: HeatmapOptions): void;
+    remove(): void;
+}
+export {};

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

@@ -7,6 +7,7 @@ import { GoogleScaleControl } from './controls/scale.control';
 import { GoogleStreetViewControl } from './controls/street-view.control';
 import { GoogleZoomControl } from './controls/zoom.control';
 import { Autocomplete, type AutocompleteOptions } from './extra/autocomplete';
+import { type Heatmap, type HeatmapOptions } from './extra/heatmap';
 import { type MapUrls, type MapUrlsOptions } from './extra/map-urls';
 import { GoogleMarkerClusterer, type MarkerClustererOptions } from './extra/marker-clusterer';
 import { type PlacesService, type PlacesServiceOptions } from './extra/places-service';
@@ -73,6 +74,7 @@ export declare class GoogleMap extends AbstractMap {
     createStreetViewControl: typeof GoogleStreetViewControl.create;
     createScaleControl: typeof GoogleScaleControl.create;
     createMarkerClusterer(options: MarkerClustererOptions): GoogleMarkerClusterer;
+    createHeatmap(options: HeatmapOptions): Heatmap;
     createAutocomplete(options: AutocompleteOptions): Autocomplete;
     createSearchBox(options: SearchBoxOptions): SearchBox;
     createPlacesService(options: PlacesServiceOptions): PlacesService;

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

@@ -7,6 +7,7 @@ import type { ScaleControlOptions } from './controls/scale.control';
 import type { StreetViewControl, StreetViewControlOptions } from './controls/street-view.control';
 import type { ZoomControl, ZoomControlOptions } from './controls/zoom.control';
 import type { Autocomplete, AutocompleteOptions } from './extra/autocomplete';
+import type { Heatmap, HeatmapOptions } from './extra/heatmap';
 import type { MapUrls, MapUrlsOptions } from './extra/map-urls';
 import type { MarkerClusterer, MarkerClustererOptions } from './extra/marker-clusterer';
 import type { PlacesService, PlacesServiceOptions } from './extra/places-service';
@@ -57,6 +58,7 @@ export declare class HereMap extends AbstractMap {
     removeOverlay(overlay: Overlay<unknown>): void;
     createMarker(options: MarkerOptions): MarkerOverlay;
     createMarkerClusterer(options: MarkerClustererOptions): MarkerClusterer;
+    createHeatmap(options: HeatmapOptions): Heatmap;
     createAutocomplete(options: AutocompleteOptions): Autocomplete;
     createSearchBox(options: SearchBoxOptions): SearchBox;
     createPlacesService(options: PlacesServiceOptions): PlacesService;

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

@@ -10,6 +10,7 @@ import type { ScaleControlOptions } from './controls/scale.control';
 import type { StreetViewControl, StreetViewControlOptions } from './controls/street-view.control';
 import type { ZoomControl, ZoomControlOptions } from './controls/zoom.control';
 import type { Autocomplete, AutocompleteOptions } from './extra/autocomplete';
+import type { Heatmap, HeatmapOptions } from './extra/heatmap';
 import type { MapUrls, MapUrlsOptions } from './extra/map-urls';
 import type { MarkerClusterer, MarkerClustererOptions } from './extra/marker-clusterer';
 import type { PlacesService, PlacesServiceOptions } from './extra/places-service';
@@ -136,6 +137,7 @@ export declare abstract class AbstractMap implements CoordTypeSupplier, Tg.Event
     abstract removeOverlay(overlay: Overlay): void;
     abstract createMarker(options: MarkerOptions): MarkerOverlay;
     abstract createMarkerClusterer(options: MarkerClustererOptions): MarkerClusterer;
+    abstract createHeatmap(options: HeatmapOptions): Heatmap;
     abstract createAutocomplete(options: AutocompleteOptions): Autocomplete;
     abstract createSearchBox(options: SearchBoxOptions): SearchBox;
     abstract createPlacesService(options: PlacesServiceOptions): PlacesService;

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

@@ -1,4 +1,4 @@
-import { type Component, type ComponentOptions, type ComponentPublicInstance, type Prop, type PropType, type RendererElement, type RendererNode, type Slots, type VNode, type WritableComputedOptions } from 'vue';
+import { type Component, type ComponentOptions, type ComponentPublicInstance, type ComputedRef, type Prop, type PropType, type Ref, type RendererElement, type RendererNode, type Slots, type VNode, type WritableComputedOptions } from 'vue';
 import type { AbstractConstructor, KeysMatching, StringEnumLike, StringEnumValue, Thing } from './mapped-types';
 /** 组件选项中的hook名 */
 export type VueHookName = ExcludeSubtype<KeysMatching<OmitStartsWith<RemoveIndex<ComponentOptions>, '_'>, {
@@ -149,7 +149,7 @@ export declare function splitAttrs(attrs: Record<string, unknown>, props?: Recor
     listenerProps: Record<string, unknown>;
 };
 /** 响应式的{@link splitAttrs} */
-export declare function useSplittedAttrs(attrs: Record<string, unknown>, props?: Record<string, unknown>): import("vue").ComputedRef<{
+export declare function useSplittedAttrs(attrs: Record<string, unknown>, props?: Record<string, unknown>): ComputedRef<{
     /** class/style/未声明的属性 等 */
     binds: Record<string, unknown>;
     /** 未声明的事件 */
@@ -180,4 +180,11 @@ export declare const useEventLogMethods: () => {
     eventLog: (event: Thing | null | undefined) => void;
     eventLogLess: (this: any, event: Thing | null | undefined) => void;
 };
+/**
+ * 值可能是Ref的对象
+ * 可以用来给{@link reactive}的参数做类型约束
+ * */
+export type MaybeWrapRefs<T> = {
+    [P in keyof T]: Ref<T[P]> | T[P] | ComputedRef<T[P]>;
+};
 export {};