tg-map-vue3 3.6.4 → 3.6.7

package/CHANGELOG.md

@@ -2,7 +2,8 @@
 
 ## 3.6.x
 
-- feat: 添加[MapUrls], 支持打开地图网页
+- feat: 添加[MapUrls], 支持打开地图网页(导航和搜索)
+- feat: [LatLng]和[TgMarker]添加`normalize`相关方法/参数, 处理经纬度不合法的问题
 - fix: 百度地图的覆盖物([BaiduShape])不能隐藏填充/线条颜色的问题
 - perf: [TgLabel]/[TgInfoBox]/[TgInfoWindow]和[TgMarker]不必紧密相邻, 可以放其他组件
 - ***BREAKING CHANGE***: `placeService` -> `placesService`
@@ -59,4 +60,5 @@
 [SearchBox]: src/map/map/extra/search-box.ts "搜索框"
 [useTgMapInner]: src/components/map-hooks.ts
 [LatLngBounds]: src/map/lat-lng.ts#L157
+[LatLng]: src/map/lat-lng.ts#L26
 [BaiduShape]: src/map/map/overlay/shape.ts#L32

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

@@ -39,6 +39,9 @@ declare const TgMarker: import("vue").DefineComponent<{
     visible: {
         type: PropType<boolean>;
     };
+    normalizePositionForBaidu: {
+        type: PropType<boolean>;
+    };
     'onUpdate:position': import("vue").Prop<import("../../utils/vue-utils").EventCallback<LatLng>>;
 }, {
     attrs: import("vue").ComputedRef<{
@@ -233,6 +236,9 @@ declare const TgMarker: import("vue").DefineComponent<{
     visible: {
         type: PropType<boolean>;
     };
+    normalizePositionForBaidu: {
+        type: PropType<boolean>;
+    };
     'onUpdate:position': import("vue").Prop<import("../../utils/vue-utils").EventCallback<LatLng>>;
 }>> & {
     onClick?: ((event: import("../../map/event").Tg.MouseEvent) => any) | undefined;

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

@@ -28,6 +28,18 @@ export declare class LatLng {
     /** 坐标系 */
     readonly coord: CoordType;
     static ZERO: LatLng;
+    /**
+     * {@template latlng_normalize}
+     *
+     * 对经纬度进行标准化, 参考google的实现
+     *
+     * ## 行为不一致
+     * - google: google.maps.LatLng的构造器会对经纬度进行标准化, 所有点都能正常显示
+     * - baidu: BMap.Point的构造器不会对经纬度进行标准化, 超出范围的点显示到(0, 0)位置
+     *
+     * {@endtemplate}
+     */
+    static _normalize(lng: number, lat: number): number[];
     /** @param coord Baidu Map的坐标一般都是bd09 */
     static fromBaidu(point: BMap.Point, coord: CoordType): LatLng;
     /** @param coord Google Map的坐标依据地图类型不同是不一样的 */
@@ -49,7 +61,17 @@ export declare class LatLng {
     coord: CoordType);
     /** 转换坐标到指定坐标系 */
     to(coordType: StringEnumValue<typeof CoordType>): LatLng;
-    toBaidu(coord: CoordType): BMap.Point;
+    /**
+     * TODO: normalize要不要默认设为true, 和google的行为保持一致?
+     * 转换成baidu的经纬度
+     * @param normalize 转换时是否进行标准化, 默认false
+     * @see _normalize {@macro latlng_normalize}
+     */
+    toBaidu(coord: CoordType, normalize?: boolean): BMap.Point;
+    /**
+     * 转换成google的经纬度, 内部会自动进行标准化
+     * @see _normalize {@macro latlng_normalize}
+     */
     toGoogle(coord: CoordType): google.maps.LatLng;
     toHere(coord: CoordType): H.geo.Point;
     /**
@@ -61,6 +83,11 @@ export declare class LatLng {
      * @throws 若当前coord和targetCoord相同, 会抛异常, 故请在外部判断
      */
     _convert(targetCoord: CoordType): LngLatTuple;
+    /**
+     * 标准化, 返回合法的坐标点
+     * @see _normalize {@macro latlng_normalize}
+     */
+    normalize(): LatLng;
     equals(other: LatLng): boolean;
     toString(): string;
 }

package/dist/src/map/map/extra/map-urls.d.ts

@@ -15,6 +15,10 @@ export declare abstract class MapUrls {
      * - baidu: 用{@link destination}当作起点
      */
     abstract directions(origin: Location | undefined, destination: Location, mode?: DirectionMode): URL;
+    /**
+     * 搜索
+     */
+    abstract search(location: Location): URL;
 }
 /**
  * @see https://developers.google.com/maps/documentation/urls/get-started
@@ -23,6 +27,8 @@ export declare class GoogleMapUrls extends MapUrls {
     static BASE_URL: string;
     /** @see https://developers.google.com/maps/documentation/urls/get-started#directions-action */
     directions(origin: Location | undefined, destination: Location, mode?: GoogleDirectionMode): URL;
+    /** @see https://developers.google.com/maps/documentation/urls/get-started#search-action */
+    search(location: Location): URL;
 }
 /**
  * @see https://lbsyun.baidu.com/faq/api?title=webapi/uri
@@ -31,5 +37,7 @@ export declare class BaiduMapUrls extends MapUrls {
     static BASE_URL: string;
     /** @see https://lbsyun.baidu.com/faq/api?title=webapi/uri/web#:~:text=%E6%9C%8D%E5%8A%A1%E5%9C%B0%E5%9D%80-,http%3A//api.map.baidu.com/direction,-//PC%26Webapp%E6%9C%8D%E5%8A%A1 */
     directions(origin: Location | undefined, destination: Location, mode?: DirectionMode): URL;
+    /** @see https://lbsyun.baidu.com/faq/api?title=webapi/uri/web#%E5%9B%BE%E5%8C%BA%E5%8A%9F%E8%83%BD:~:text=%E4%B8%8D%E4%BF%9D%E8%AF%81%E6%9C%8D%E5%8A%A1%E3%80%82-,2.1.2%20%E5%9C%B0%E5%9D%80%E8%A7%A3%E6%9E%90,-%E8%B0%83%E7%94%A8%E8%AF%A5 */
+    search(location: Location): URL;
 }
 export {};

package/dist/src/map/map/extra/marker-clusterer.d.ts

@@ -1,3 +1,5 @@
+import GMarkerClusterer from '@google/markerclusterer';
+import BMarkerClusterer from 'bmaplib.markerclusterer';
 import type { Point, Size } from '../../types';
 import type { BaiduMap } from '../baidu-map';
 import type { GoogleMap } from '../google-map';
@@ -45,7 +47,7 @@ export interface ClusterIconStyle {
  */
 export declare abstract class MarkerClusterer {
     map: AbstractMap;
-    inner: any;
+    abstract inner: any;
     constructor(map: AbstractMap);
     /** baidu/google 拥有相同的函数名 */
     clearMarkers(): void;
@@ -60,10 +62,12 @@ export declare abstract class MarkerClusterer {
     abstract recreate(): void;
 }
 export declare class BaiduMarkerClusterer extends MarkerClusterer {
+    inner: BMarkerClusterer;
     constructor(map: BaiduMap, options: MarkerClustererOptions);
     recreate(): void;
 }
 export declare class GoogleMarkerClusterer extends MarkerClusterer {
+    inner: GMarkerClusterer;
     constructor(map: GoogleMap, options: MarkerClustererOptions);
     recreate(): void;
 }

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

@@ -12,6 +12,15 @@ import type { BaiduLabelOverlay, GoogleLabelOverlay, LabelOverlay } from './labe
 import { BaiduOverlay, GoogleOverlay, Overlay, type OverlayOptions } from './overlay';
 export interface MarkerOptions extends OverlayOptions {
     position: LatLng;
+    /**
+     * 执行{@link LatLng.toBaidu}时是否对经纬度进行标准化
+     *
+     * 因为{@link LatLng.toGoogle}内部是会自动标准化的, 并且LatLng绝大部分情况下是合法的,
+     * 所以添加这个参数, 只在使用者认为必要的时候, 执行标准化
+     *
+     * {@macro latlng_normalize}
+     */
+    normalizePositionForBaidu?: boolean;
     title?: string;
     icon?: UnionIcon;
     /** @default true */
@@ -88,6 +97,7 @@ export declare class BaiduMarker extends BaiduOverlay<BMarker> implements Marker
         clickable: boolean;
         draggable: boolean;
         zIndex: number | undefined;
+        normalize?: boolean;
     });
     getPosition(): LatLng;
     setPosition(position: LatLng): void;