@tianditu/core 0.1.0

package/types/overlay/overlay.d.ts

@@ -0,0 +1,109 @@
+export {};
+
+declare global {
+  namespace T {
+    /**
+     * 覆盖物选项
+     */
+    interface OverlayOptions {
+      /** 叠加层类型：Label 为 1、Marker 为 2、InfoWindow 为 3、Polyline 为 4、Polygon 为 5、Circle 为 6、Rectangle 为 7 */
+      type?: number;
+    }
+    /**
+     * 自定义覆盖物的构造类
+     */
+    class Overlay {
+      constructor(opts: any);
+      extend(opts: OverlayExtendOptions): Overlay;
+    }
+    /**
+     * 自定义覆盖物构造类参数
+     */
+    interface OverlayExtendOptions {
+      /** 构造函数时传递参数，对OverlayOptions属性值进行赋值 */
+      initialize(...arg: any): void;
+      /** 向地图上添加叠加物。当调用map.addOverLay时，API将调用此方法。自定义叠加物时需要实现此方法。自定义叠加物时需要将覆盖物对应的HTML元素返回 */
+      onAdd(map: Map): void;
+      /** 移除叠加物，释放覆盖物对象所占用的内存。自定义叠加物时需要实现此方法 */
+      onRemove(): void;
+      /** 当地图状态发生变化时，由系统调用对覆盖物进行绘制。自定义覆盖物需要实现此方法 */
+      update(): void;
+      /** 在地图上显示叠加层 */
+      show(): void;
+      /** 在地图上隐藏叠加层 */
+      hide(): void;
+      /** 判断叠加层是否隐藏，返回 true 表示当前叠加层是隐藏的，否则是处于显示状态 */
+      isHidden(): boolean;
+      /** 对OverlayOptions属性值赋值 */
+      setOptions(opt: JSON): void;
+      /** 返回叠加物所在的容器的标签 */
+      getElement(): HTMLElement;
+    }
+
+    /**
+     * 覆盖物公共类
+     */
+    class OverlayBase<E> {
+      /** 返回叠加层类型 */
+      getType(): number;
+      /** 返回叠加层所在的map对象 */
+      getMap(): Map;
+      /** 设置叠加层的偏移值 */
+      setOffset(offset: Point): void;
+      /** 返回叠加层的偏移值 */
+      getOffset(): Point;
+      /** 设置z-index */
+      setZIndex(zIndex: number): void;
+      /** 设置叠加层的显示透明度 */
+      setOpacity(opacity: number): void;
+      /** 返回加层的显示透明度 */
+      getOpacity(): number;
+      /** 添加事件监听函数 */
+      addEventListener<EE extends keyof E>(event: EE, handler: E[EE]): void;
+      /** 移除事件监听函数 */
+      removeEventListener<EE extends keyof E>(event: EE, handler: E[EE]): void;
+      /** 打开信息窗口 */
+      openInfoWindow(infowin: InfoWindow): void;
+      /** 关闭信息窗口 */
+      closeInfoWindow(): void;
+      /** 显示 */
+      show(): void;
+      /** 隐藏 */
+      hide(): void;
+    }
+    /**
+     * 覆盖物共有事件
+     */
+    interface OverlayEvents<T, LL, L = undefined> {
+      /** 点击叠加层后会触发此事件 */
+      click(e: OverlayEvent<T, LL, L>): void;
+      /** 双击叠加层后会触发此事件 */
+      dblclick(e: OverlayEvent<T, LL, L>): void;
+      /** 鼠标在叠加层上按下触发此事件 */
+      mousedown(e: OverlayEvent<T, LL, L>): void;
+      /** 鼠标在叠加层释放触发此事件 */
+      mouseup(e: OverlayEvent<T, LL, L>): void;
+      /** 鼠标离开叠加层时触发此事件 */
+      mouseout(e: OverlayEvent<T, LL, L>): void;
+      /** 当鼠标进入叠加层区域时会触发此事件 */
+      mouseover(e: OverlayEvent<T, LL, L>): void;
+      /** 移除叠加层时触发 */
+      remove(e: OverlayEvent<T, LL, L>): void;
+    }
+    /**
+     * 覆盖物共有事件参数
+     */
+    interface OverlayEvent<T, LL, L = undefined> {
+      /** 事件类型 */
+      type: string;
+      /** 叠加层对象 */
+      target: T;
+      /** 叠加层经纬度坐标 */
+      lnglat: LL;
+      /** 点聚合组件的点标注对象 */
+      layer: L;
+      /** 叠加层像素坐标 */
+      containerPoint: Point;
+    }
+  }
+}

package/types/overlay/polygon.d.ts

@@ -0,0 +1,59 @@
+export {};
+
+declare global {
+  namespace T {
+    class Polygon extends OverlayBase<PolygonEvents> {
+      /** 创建多边形覆盖物对象 */
+      constructor(points: LngLat[], opts?: PolygonOptions);
+      /** 设置多边形的点数组 */
+      setLngLats(lnglat: LngLat[]): void;
+      /** 返回多边形的点数组 */
+      getLngLats(): LngLat[];
+      /** 设置多边形边线的颜色 */
+      setColor(color: string): void;
+      /** 返回多边形边线的颜色 */
+      getColor(): string;
+      /** 设置多边形边线的宽度 */
+      setWeight(weight: number): void;
+      /** 返回多边形边线的宽度。 */
+      getWeight(): number;
+      /** 设置多边形边线是为实线或虚线 */
+      setLineStyle(style: PolylineOptions["lineStyle"]): void;
+      /** 返回当前多边形边线样式状态，实线或者虚线 */
+      getLineStyle(): string;
+      /** 设置多边形的填充颜色，参数为合法的CSS颜色值。当参数为空字符串时，多边形覆盖物填充颜色与边线颜色相同 */
+      setFillColor(color: string): void;
+      /** 返回多边形的填充颜色 */
+      getFillColor(): string;
+      /** 设置多边形的填充透明度。当参数为0时，多边形覆盖物将没有填充效果 */
+      setFillOpacity(opacity: number): void;
+      /** 返回多边形的填充透明度 */
+      getFillOpacity(): number;
+      /** 返回多边形的地理区域范围 */
+      getBounds(): LngLatBounds;
+      /** 启用多边形编辑功能 */
+      enableEdit(): void;
+      /** 禁用多边形编辑功能 */
+      disableEdit(): void;
+      /** 是否启用多边形编辑功能，true表示启用，false表示禁止 */
+      isEditable(): boolean;
+    }
+
+    interface PolygonOptions {
+      /** 多边形边线颜色。default:"#0000FF" */
+      color?: string;
+      /** 多边形边线的宽度，以像素为单位。default:3 */
+      weight?: number;
+      /** 多边形边线的透明度（范围0-1 之间）。default:0.5 */
+      opacity?: number;
+      /** 多边形填充颜色。当参数为空时，多边形覆盖物将没有填充效果。default:"#0000FF" */
+      fillColor?: string;
+      /** 多边形填充的透明度（范围0-1 之间）。default:0.2 */
+      fillOpacity?: number;
+      /** 多边形边线的样式（solid或dashed）。default:"solid" */
+      lineStyle?: "solid" | "dashed";
+    }
+
+    type PolygonEvents = OverlayEvents<Polygon, LngLat[]>;
+  }
+}

package/types/overlay/polyline.d.ts

@@ -0,0 +1,47 @@
+export {};
+
+declare global {
+  namespace T {
+    class Polyline extends OverlayBase<PolylineEvents> {
+      /** 创建折线覆盖物对象 */
+      constructor(points: LngLat[], opts?: PolylineOptions);
+      /** 设置折线的点数组 */
+      setLngLats(lnglat: LngLat[]): void;
+      /** 返回折线的点数组 */
+      getLngLats(): LngLat[];
+      /** 设置折线的颜色 */
+      setColor(color: string): void;
+      /** 返回折线的颜色 */
+      getColor(): string;
+      /** 设置折线的宽度 */
+      setWeight(weight: number): void;
+      /** 返回线的宽度 */
+      getWeight(): number;
+      /** 设置折线是为实线或虚线 */
+      setLineStyle(style: PolylineOptions["lineStyle"]): void;
+      /** 返回当前折线样式状态，实线或者虚线 */
+      getLineStyle(): string;
+      /** 返回折线的地理区域范围 */
+      getBounds(): LngLatBounds;
+      /** 启用线编辑功能 */
+      enableEdit(): void;
+      /** 禁用线编辑功能 */
+      disableEdit(): void;
+      /** 是否启用线编辑功能，true表示启用，false表示禁止 */
+      isEditable(): boolean;
+    }
+
+    interface PolylineOptions {
+      /** 折线颜色。default:"#0000FF" */
+      color?: string;
+      /** 折线的宽度，以像素为单位。default:3 */
+      weight?: number;
+      /** 折线的透明度（范围0-1 之间）。default:0.5 */
+      opacity?: number;
+      /** 折线的样式（solid或dashed）。default:"solid" */
+      lineStyle?: "solid" | "dashed";
+    }
+
+    type PolylineEvents = OverlayEvents<Polyline, LngLat[]>;
+  }
+}

package/types/overlay/rectangle.d.ts

@@ -0,0 +1,57 @@
+export {};
+
+declare global {
+  namespace T {
+    class Rectangle extends OverlayBase<RectangleEvents> {
+      /** 创建矩形覆盖物对象 */
+      constructor(bounds: LngLatBounds, opts?: RectangleOptions);
+      /** 设置矩形的显示范围 */
+      setBounds(bounds: LngLatBounds): void;
+      /** 返回矩形的地理区域范围 */
+      getBounds(): LngLatBounds;
+      /** 设置矩形边线的颜色 */
+      setColor(color: string): void;
+      /** 返回矩形边线的颜色 */
+      getColor(): string;
+      /** 设置矩形边线的宽度 */
+      setWeight(weight: number): void;
+      /** 返回矩形边线的宽度 */
+      getWeight(): number;
+      /** 设置矩形边线是为实线或虚线 */
+      setLineStyle(style: PolylineOptions["lineStyle"]): void;
+      /** 返回当前矩形边线样式状态，实线或者虚线 */
+      getLineStyle(): string;
+      /** 设置矩形的填充颜色，参数为合法的CSS颜色值。当参数为空字符串时，矩形覆盖物填充颜色与边线颜色相同 */
+      setFillColor(color: string): void;
+      /** 返回矩形的填充颜色 */
+      getFillColor(): string;
+      /** 设置矩形的填充透明度。当参数为0时，矩形覆盖物将没有填充效果 */
+      setFillOpacity(opacity: number): void;
+      /** 返回矩形的填充透明度 */
+      getFillOpacity(): number;
+      /** 启用矩形编辑功能 */
+      enableEdit(): void;
+      /** 禁用矩形编辑功能 */
+      disableEdit(): void;
+      /** 是否启用矩形编辑功能，true表示启用，false表示禁止 */
+      isEditable(): boolean;
+    }
+
+    interface RectangleOptions {
+      /** 矩形边线颜色。default:"#0000FF" */
+      color?: string;
+      /** 矩形边线的宽度，以像素为单位。default:3 */
+      weight?: number;
+      /** 矩形边线的透明度（范围0-1 之间）。default:0.5 */
+      opacity?: number;
+      /** 矩形填充颜色。当参数为空时，矩形覆盖物将没有填充效果。default:"#0000FF" */
+      fillColor?: string;
+      /** 矩形填充的透明度（范围0-1 之间）。default:0.2 */
+      fillOpacity?: number;
+      /** 矩形边线的样式（solid或dashed）。default:"solid" */
+      lineStyle?: "solid" | "dashed";
+    }
+
+    type RectangleEvents = OverlayEvents<Rectangle, LngLatBounds>;
+  }
+}

package/types/overlay/svg.d.ts

@@ -0,0 +1,19 @@
+export {};
+
+declare global {
+  namespace T {
+    class SVG {
+      /** 根据传入padding参数创建用于绘制SVG标签的容器。 */
+      constructor(opts?: SVGOptions);
+      /** 根据传入的字符串，只创建标准的SVG标签元素。 */
+      create(name: string): SVGElement;
+      /** 根据屏幕坐标的数组拼接类似的"M..L..L.."字符串，用于生成标签的路径数据。 */
+      pointsToPath(points: Point[], closed: boolean): string;
+    }
+
+    interface SVGOptions {
+      /** SVG容器的范围相对地图视图容器的大小扩展缩小区域，例如：0.1表示地图视图每个方向扩大0.1倍的范围。default:0.1 */
+      padding?: number;
+    }
+  }
+}

package/types/service/administrativeDivision.d.ts

@@ -0,0 +1,48 @@
+export {};
+
+declare global {
+  namespace T {
+    /** 此类用于获取行政区划信息 */
+    class AdministrativeDivision {
+      /** 创建一个获取行政区划的实例 */
+      constructor();
+
+      /** 根据检索词发起检索（官方回调参数标注为 Function） */
+      search(
+        config: AdministrativeDivisionOptions,
+        callback: (result: AdministrativeDivisionResult) => void,
+      ): void;
+    }
+
+    interface AdministrativeDivisionOptions {
+      /** 查询行政区划的名称 */
+      searchWord: string;
+      /** 查询类型：0 根据 code 查询、1 根据名称查询 */
+      searchType: number;
+      /** 是否需要下一级信息 */
+      needSubInfo?: boolean;
+      /** 是否需要所有子节点 */
+      needAll?: boolean;
+      /** 是否需要行政区划范围 */
+      needPolygon?: boolean;
+      /** 是否需要上一级所有信息 */
+      needPre?: boolean;
+    }
+
+    /** AdministrativeDivision 的检索结果，没有构造函数 */
+    interface AdministrativeDivisionResult {
+      /** 返回状态码：100 正常、101 没有查到结果（官方类型标注笔误为 numer） */
+      getStatus(): number;
+      /** 返回响应信息 */
+      getMsg(): string;
+      /** 数据版本（官方返回值标注为 LngLat，疑为笔误，实际为日期字符串） */
+      getDataVersion(): string;
+      /**
+       * 返回行政区划数据信息 JSON 文本，结构：
+       * {returncode, data: [{parents, country, level, nameabbrevation, name,
+       * adminType, cityCode, lnt, lat, englishabbrevation, english, bound, points}], dataversion, msg}
+       */
+      getData(): string;
+    }
+  }
+}

package/types/service/busLineSearch.d.ts

@@ -0,0 +1,89 @@
+export {};
+
+declare global {
+  namespace T {
+    class BusLineSearch {
+      /** 创建一个公交导航实例，用于获取公交路线规划方案*/
+      constructor(map: Map, opts: BusLineSearchOptions);
+
+      /** 检索公交信息 */
+      getBusList(keyword: string): void;
+      /** 检索公交路线 */
+      getBusLine(busListItem: BusListItem): void;
+      /** 设置公交列表查询后的回调函数 */
+      setGetBusListCompleteCallback(callback: Function): void;
+      /** 设置公交线路查询后的回调函数 */
+      setGetBusLineCompleteCallback(callback: Function): void;
+    }
+
+    interface BusLineSearchOptions {
+      /** 设置公交列表查询后的回调函数 */
+      onGetBusListComplete?: (result: BusListResult) => void;
+      /** 设置公交线路查询后的回调函数 */
+      onGetBusLineComplete?: (result: BusLine) => void;
+    }
+
+    interface BusListResult {
+      /** 公交列表个数 */
+      getNumBusList(): number;
+      /** 获取某一个具体的公交列表中的对象 */
+      getBusListItem(i: number): BusListItem;
+    }
+
+    interface BusListItem {
+      /** 站数 */
+      stationNum: string;
+      /** 线路名称 */
+      name: string;
+      /** 线路的id */
+      uuid: string;
+    }
+
+    interface BusLine {
+      /**	线路名称，如：68路 */
+      lineName: string;
+      /**	线路类型，1表示公交；2表示地铁；3表示磁悬浮 */
+      lineType: number;
+      /**	线路的长度，单位米 */
+      length: number;
+      /**	线路的详细点信息，格式：x,y;x,y; */
+      linePoint: string;
+      /**	始发车时间格式为：hh:mm 24小时制 */
+      startTime: string;
+      /**	末班车时间格式为：hh:mm 24小时制 */
+      endTime: string;
+      /**	公交线路的全程运营总时间，单位分钟 */
+      totalTime: number;
+      /**	该线路所具有的站点总数量 */
+      stationCount: number;
+      /**	发车间隔，单位秒 */
+      interval: number;
+      /**	计费模式，0表示单一；1表示按距离；2表示按站 */
+      ticketcal: number;
+      /**	全程票价，单位分 */
+      totalPrice: number;
+      /**	起步票价，单位分 */
+      startPrice: number;
+      /**	递增距离票价，单位千米 */
+      increasedPrice: number;
+      /**	车站递增票价，按站 */
+      increasedStep: number;
+      /**	是否支持月票，0表示不支持；1表示支持 */
+      ismonTicket: number;
+      /**	是否双向行驶，0表示单项；1表示双向 */
+      isBidirectional: number;
+      /**	是否人工售票，0表示有人；1表示无人 */
+      isManual: number;
+      /**	状态，0表示使用中；1表示非使用中 */
+      status: number;
+      /**	所属公交公司，公交线路所属公司 */
+      company: string;
+      /** 返回公交站点个数 */
+      getNumBusStations(): number;
+      /** 返回某一个具体的公交站信息 */
+      getBusStation(i: number): Station;
+      /** 返回公交线地理坐标点数组 */
+      getPath(): [];
+    }
+  }
+}

package/types/service/dataSources.d.ts

@@ -0,0 +1,30 @@
+export {};
+
+declare global {
+  namespace T {
+    /** 此类用于获取地图数据来源信息 */
+    class DataSources {
+      /** 创建一个获取数据来源的实例 */
+      constructor();
+
+      /** 查询当前地图数据的来源，回调参数为 {ds: "数据来源"} */
+      search(config: DataSourcesOptions, callback: (result: DataSourcesResult) => void): void;
+    }
+
+    interface DataSourcesOptions {
+      /** 地图级别 */
+      level?: number;
+      /** 地图范围 */
+      bound?: string;
+      /** 地图图层 */
+      layers?: string;
+      /** 地图投影 */
+      projection?: string;
+    }
+
+    interface DataSourcesResult {
+      /** 数据来源 */
+      ds: string;
+    }
+  }
+}

package/types/service/drivingRoute.d.ts

@@ -0,0 +1,135 @@
+export {};
+
+declare global {
+  namespace T {
+    class DrivingRoute {
+      /** 创建一个驾车导航实例，用于获取驾车路线规划方案 */
+      constructor(map: Map, opts: DrivingRouteOptions);
+
+      /** 发起检索 */
+      search(start: LngLat, end: LngLat): void;
+      /** 返回最近一次检索的结果 */
+      getResults(): DrivingRouteResult;
+      /** 清除最近一次检索的结果 */
+      clearResults(): void;
+      /** 设置路线规划策略，参数为策略常量 */
+      setPolicy(policy: number): void;
+      /** 设置检索结束后的回调函数 */
+      setSearchCompleteCallback(fun: Function): void;
+    }
+
+    interface DrivingRouteOptions {
+      /**
+       * 驾车策略参数
+       * TMAP_DRIVING_POLICY_LEAST_TIME = 0 最少时间
+       * TMAP_DRIVING_POLICY_LEAST_DISTANCE = 1 最短距离
+       * TMAP_DRIVING_POLICY_AVOID_HIGHWAYS = 2 避开高速
+       * TMAP_DRIVING_POLICY_WALK = 3 步行
+       */
+      policy: number;
+      /** 检索结束后的回调函数 */
+      onSearchComplete?: (result: DrivingRouteResult) => void;
+    }
+
+    interface DrivingRouteResult {
+      /** 起点"lng,lat" */
+      start: string;
+      /** 终点"lng,lat" */
+      end: string;
+      results: {
+        mid: string;
+        /** 起点"lng,lat" */
+        orig: string;
+        /** 终点"lng,lat" */
+        dest: string;
+        /** 完整路径 */
+        routes: {
+          /** 路径条数 */
+          count: string;
+          time: string;
+          item: {
+            /** 路径id */
+            id: string;
+            /** 路径导航文本描述 */
+            strguide: string;
+            signage: null;
+            /** 当前道路名称 */
+            streetName: string;
+            /** 下个道路名称 */
+            nextStreetName: string;
+            tollStatus: number;
+            /** 节点经纬度"lng,lat" */
+            turnlatlon: string;
+          }[];
+        };
+        /** 简略路径 */
+        simple: {
+          item: {
+            id: "0";
+            strguide: "从清华东路出发，行驶到学院路,进入新街口南大街。";
+            streetNames: "清华东路";
+            lastStreetName: "学院路";
+            linkStreetName: "新街口南大街";
+            signage: null;
+            tollStatus: 0;
+            turnlatlon: "116.33297,39.99922";
+            streetLatLon: "116.33297,39.99922;116.33303,39.99922;116.33303,39.99922;116.33339,39.99922;116.33339,39.99922;116.33372,39.99922;116.33372,39.99922;116.33484,39.99926;116.33484,39.99926;116.3353,39.99929;116.3353,39.99929;116.33705,39.99935;116.33705,39.99935;116.33805,39.99937;116.33805,39.99937;116.33912,39.99939;116.33912,39.99939;116.34087,39.99946;116.34087,39.99946;116.34142,39.99949;116.34142,39.99949;116.34158,39.99949;116.34158,39.99949;116.34206,39.99949;116.34206,39.99949;116.34222,39.99949;116.34222,39.99949;116.34256,39.99951;116.34256,39.99951;116.34283,39.99951;116.34283,39.99951;116.34302,39.99951;116.34302,39.99951;116.34351,39.99951;116.34351,39.99951;116.34384,39.99951;116.34384,39.99951;116.34432,39.99951;116.34432,39.99951;116.34486,39.99953;116.34486,39.99953;116.34528,39.99955;116.34528,39.99955;116.34568,39.99956;116.34568,39.99956;116.34602,39.99957;116.34602,39.99957;116.34628,39.99957;";
+            streetDistance: 1134;
+            segmentNumber: 0;
+          }[];
+        };
+        /**  */
+        distance: 17.5;
+        duration: 1259;
+        /** "lng,lat;lng,lat;..." */
+        routelatlon: string;
+      };
+      /** 返回起点 */
+      getStart(): LngLat;
+      /** 返回终点 */
+      getEnd(): LngLat;
+      /** 返回方案个数 */
+      getNumPlans(): number;
+      /** 返回索引指定的方案。索引0表示第一条方案 */
+      getPlan(i: number): RoutePlan;
+    }
+
+    /** 官方文档页名为 RoutePlan（通过 DrivingRouteResult.getPlan() 获得） */
+    interface RoutePlan {
+      /** 返回该方案包含的线路的个数 */
+      getNumRoutes(): number;
+      /** 返回方案中索引指定的线路信息。索引0表示第一条线路 */
+      getRoute(i: number): Route;
+      /** 返回方案总距离，单位为公里 */
+      getDistance(): number;
+      /** 返回方案总时间，单位为秒 */
+      getDuration(): number;
+      /** 返回途径点 */
+      getWayPois(): LngLat[];
+      /** 返回路线的经纬度 */
+      getPath(): LngLat[];
+    }
+
+    interface Route {
+      /** 返回该段路线包含的关键点个数 */
+      getNumSteps(): number;
+      /** 返回索引指定的关键点。索引0表示第一个关键点 */
+      getStep(i: number): Step;
+      /** 返回该段路线距离 */
+      getDistance(): number;
+      /** 返回该段路线在方案中的索引位置 */
+      getIndex(): number;
+      /** 返回该段路线的坐标 */
+      getPath(): LngLat[];
+    }
+
+    interface Step {
+      /** 返回关键点地理坐标 */
+      getPosition(): LngLat;
+      /** 返回本关键点在路线中的位置索引 */
+      getIndex(): number;
+      /** 返回关键点描述文本 */
+      getDescription(): string;
+    }
+  }
+}

package/types/service/geocoder.d.ts

@@ -0,0 +1,47 @@
+export {};
+
+declare global {
+  namespace T {
+    /**
+     * 地址解析器。对照官方文档仅列反地址解析能力
+     */
+    class Geocoder {
+      /** 创建一个地址解析器的实例 */
+      constructor();
+      /**
+       * 对指定的坐标点进行反地址解析
+       * @param point 坐标点
+       * @param callback 解析成功时参数为 GeocoderResult，失败时为 null
+       */
+      getLocation(point: LngLat, callback: (result: GeocoderResult | null) => void): void;
+    }
+
+    /**
+     * 反地址解析结果
+     */
+    interface GeocoderResult {
+      /** 解析状态（官方文档返回值拼写即为 numer） */
+      getStatus(): number;
+      /** 返回响应信息 */
+      getMsg(): string;
+      /** 获取此点坐标 */
+      getLocationPoint(): LngLat;
+      /** 获取详细地址 */
+      getAddress(): string;
+      /** 获取此点的详细信息 */
+      getAddressComponent(): AddressComponent;
+    }
+
+    /**
+     * 地址成分描述
+     */
+    interface AddressComponent {
+      /** 详细地址 */
+      address: string;
+      /** 热点名称 */
+      poi: string;
+      /** 距离 */
+      distance: number;
+    }
+  }
+}

package/types/service/geolocation.d.ts

@@ -0,0 +1,39 @@
+export {};
+
+declare global {
+  namespace T {
+    /**
+     * 浏览器定位
+     */
+    class Geolocation {
+      /** 创建一个浏览器定位实例 */
+      constructor();
+      /**
+       * 发起一次当前定位
+       * @param callback 定位完成回调；定位失败时参数为 null
+       * @param options 定位配置项
+       */
+      getCurrentPosition(
+        callback: (result: GeolocationResult | null) => void,
+        options?: GeolocationOptions,
+      ): void;
+    }
+
+    interface GeolocationOptions {
+      /** 是否使用高精度 */
+      enableHighAccuracy?: boolean;
+      /** 浏览器缓存定位的最大时长，单位毫秒 */
+      maximumAge?: number;
+      /** 超时时间，单位毫秒 */
+      timeout?: number;
+    }
+
+    /**
+     * 定位结果
+     */
+    interface GeolocationResult {
+      /** 定位坐标 */
+      lnglat: LngLat;
+    }
+  }
+}