tg-map-vue3 3.6.10 → 3.7.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # 更新日志
 
+## 3.7.x
+
+- feat: 添加[IconSequence]到[TgPolyline]中
+
 ## 3.6.x
 
 - feat: 添加[MapUrls], 支持打开地图网页(导航和搜索)
@@ -53,7 +57,8 @@
 [TgInfoBox]: src/components/overlays/TgInfoBox.vue
 [TgInfoWindow]: src/components/overlays/TgInfoWindow.vue
 [Icon]: src/map/map/overlay/icon.ts#L18 "图标"
-[SymbolIcon]: src/map/map/overlay/icon.ts#L55 "Svg图标"
+[SymbolIcon]: src/map/map/overlay/icon.ts#L139 "Svg图标"
+[IconSequence]: src/map/map/overlay/icon.ts#L55 "Svg图标序列"
 [PlacesService]: src/map/map/extra/places-service.ts "位置服务"
 [Autocomplete]: src/map/map/extra/autocomplete.ts "自动完成"
 [MapUrls]: src/map/map/extra/map-urls.ts "地图网页"

package/README.md

@@ -91,3 +91,16 @@ pnpm run lint
 ### Customize configuration
 
 See [Vite Configuration Reference](https://vitejs.dev/config/).
+
+## 参考文档
+
+- [百度Javascript API v3.0][]: 老版, [类参考][baidu_ref3]
+- [百度Javascript API GL][]: 新的基于WebGL的实现, [类参考][baidu_ref]
+- [Google Maps Javascript API][]: Google地图, [类参考][google_ref]
+
+[Google Maps Javascript API]: https://developers.google.com/maps/documentation/javascript
+[百度Javascript API v3.0]: https://lbsyun.baidu.com/index.php?title=jspopular3.0
+[baidu_ref3]: https://mapopen-pub-jsapi.bj.bcebos.com/jsapi/reference/jsapi_reference_3_0.html
+[百度Javascript API GL]: https://lbsyun.baidu.com/index.php?title=jspopularGL
+[baidu_ref]: https://mapopen-pub-jsapi.bj.bcebos.com/jsapi/reference/jsapi_webgl_1_0.html
+[google_ref]: https://developers.google.com/maps/documentation/javascript/reference

package/dist/src/components/overlays/TgPolyline.vue.d.ts

@@ -1,5 +1,6 @@
 import { type PropType } from 'vue';
 import { LatLng } from '../../map/lat-lng';
+import type { IconSequence } from '../../map/map/overlay/icon';
 import type { PolylineEventMap, PolylineOverlay } from '../../map/map/overlay/polyline';
 import { type EventEmits } from '../../utils/vue-utils';
 type TgPolylineEmits = {
@@ -10,6 +11,9 @@ declare const _default: import("vue").DefineComponent<{
         type: PropType<LatLng[]>;
         required: true;
     };
+    icons: {
+        type: PropType<IconSequence[]>;
+    };
     clickable: {
         type: PropType<boolean>;
     };
@@ -44,6 +48,9 @@ declare const _default: import("vue").DefineComponent<{
         type: PropType<LatLng[]>;
         required: true;
     };
+    icons: {
+        type: PropType<IconSequence[]>;
+    };
     clickable: {
         type: PropType<boolean>;
     };

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

@@ -95,3 +95,24 @@ export declare const SymbolPath: {
         readonly google: () => google.maps.SymbolPath.FORWARD_OPEN_ARROW;
     };
 };
+/** 矢量Icon序列 */
+export interface IconSequence {
+    /** 矢量Icon */
+    icon: SymbolIcon;
+    /** @default false */
+    fixedRotation?: boolean;
+    /**
+     * 相对起点的位置, 取值可以是像素或百分比
+     * @default 100%
+     */
+    offset?: string;
+    /**
+     * 重复显示是的间距, 取值可以是像素或百分比;
+     * 若和{@link offset}同时设置, 只有{@link repeat}会生效
+     */
+    repeat?: string;
+}
+export declare namespace IconSequence {
+    function toGoogle(value: IconSequence): google.maps.IconSequence;
+    function toBaidu(value: IconSequence): BMap.IconSequence;
+}

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

@@ -6,6 +6,7 @@ import { EventHubEventTargetDelegate } from '../../event-target';
 import { LatLng } from '../../lat-lng';
 import type { BaiduMap } from '../baidu-map';
 import type { GoogleMap } from '../google-map';
+import { IconSequence } from './icon';
 import type { Overlay } from './overlay';
 import { BaiduShape, GoogleShape, type NotFillableShape, type NotFillableShapeOptions } from './shape';
 export type PolylineEventMap = {
@@ -28,6 +29,7 @@ export type PolylineEventMap = {
 };
 export interface PolylineOptions extends NotFillableShapeOptions {
     path: LatLng[];
+    icons?: IconSequence[];
 }
 export interface Polyline extends Tg.EventTargetTyped<Polyline, PolylineEventMap>, NotFillableShape {
     getPath(): LatLng[];
@@ -51,6 +53,9 @@ export declare class BaiduPolyline extends BaiduPolyShape<BMap.Polyline> impleme
     getPath(): LatLng[];
     setPath(path: LatLng[]): void;
 }
+/**
+ * Google地图的网页版不支持Advanced Polyline(纹理/渐变等效果), 详见: https://issuetracker.google.com/issues/267845944
+ */
 export declare class GooglePolyline extends GoogleShape<google.maps.Polyline> implements Polyline {
     static create(this: GoogleMap, options: PolylineOptions): GooglePolyline;
     private pathChangedListeners;