@ray-js/api 1.7.70 → 1.7.72

package/@types/MapKit.d.ts

@@ -1,48 +1,253 @@
 /**
  * MapKit
  *
- * @version 3.4.13
+ * @version 7.8.2
  */
 declare namespace ty.map {
   /**
-   * 更新地理围栏
-   *权限: [scope.location]
+   * 是否开启地理围栏功能，与 NG 配置是否开启有关
+   * @public
+   * @since MapKit 3.9.1
+   * @platform iOS Android
    */
-  export function updateGeofence(params: {
-    /** 注册的地理围栏 */
-    registerGeoFence: GeofenceInfo[]
-    /** 取消的地理围栏 */
-    unregisterGeoFence: GeofenceInfo[]
+  export function isSupport(params?: {
+    /**
+     * 区分不同的地理围栏业务。空数据时默认为场景类型地理围栏 GeofenceBusinessType.Scene。
+     * @since MapKit 3.9.1
+     */
+    businessType?: string
+    /**
+     * 该业务类型的附加数据
+     * @since MapKit 3.9.1
+     */
+    businessData?: Record<string, any>
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 更新成功 */
-      success?: boolean
+      /**
+       * 是否支持地理围栏
+       * @since MapKit 3.9.1
+       * @defaultValue false
+       */
+      isSupport?: boolean
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
   /**
-   * 地理围栏是否达到上限
-   *权限: [scope.location]
+   * 地理围栏是否达到上限，不同手机系统限制数量不一样
+   * @public
+   * @since MapKit 3.9.1
+   * @platform iOS Android
    */
-  export function isGeofenceReachLimit(params?: {
+  export function isReachLimit(params?: {
+    /**
+     * 区分不同的地理围栏业务。空数据时默认为场景类型地理围栏 GeofenceBusinessType.Scene。
+     * @since MapKit 3.9.1
+     */
+    businessType?: string
+    /**
+     * 该业务类型的附加数据
+     * @since MapKit 3.9.1
+     */
+    businessData?: Record<string, any>
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 地理围栏是否达到上限 */
+      /**
+       * 地理围栏是否达到上限
+       * @since MapKit 3.9.1
+       * @defaultValue false
+       */
       reachLimit?: boolean
     }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 打开地理围栏地图页面,获取地理围栏信息(新建或者编辑地理围栏)
+   * 权限: [scope.userLocationBackground] 没有权限时本方法会引导申请权限
+   * @public
+   * @since MapKit 3.9.1
+   * @platform iOS Android
+   */
+  export function openMap(params: {
+    /**
+     * 区分不同的地理围栏业务。空数据时默认为场景类型地理围栏 GeofenceBusinessType.Scene。
+     * @since MapKit 3.9.1
+     */
+    businessInfo?: GeofenceBusinessInfo
+    /**
+     * 地理围栏信息
+     * @since MapKit 3.9.1
+     */
+    info: GeofenceInfo
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 取消保存地理围栏
+       * @since MapKit 3.9.1
+       * @defaultValue false
+       */
+      isCancel?: boolean
+      /**
+       * 地理围栏信息
+       * @since MapKit 3.9.1
+       */
+      geofenceInfo: GeofenceInfo
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 注册地理围栏。当编辑地理围栏时，需要先 unregister 旧的地理围栏，再 register 新的地理围栏
+   * @public
+   * @since MapKit 3.9.1
+   * @platform iOS Android
+   */
+  export function register(params: {
+    /**
+     * 区分不同的地理围栏业务。空数据时默认为场景类型地理围栏 GeofenceBusinessType.Scene。
+     * @since MapKit 3.9.1
+     */
+    businessInfo?: GeofenceBusinessInfo
+    /**
+     * 地理围栏信息
+     * @since MapKit 3.9.1
+     */
+    info: GeofenceInfo
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 取消地理围栏
+   * @public
+   * @since MapKit 3.9.1
+   * @platform iOS Android
+   */
+  export function unregister(params: {
+    /**
+     * 区分不同的地理围栏业务。空数据时默认为场景类型地理围栏 GeofenceBusinessType.Scene。
+     * @since MapKit 3.9.1
+     */
+    businessInfo?: GeofenceBusinessInfo
+    /**
+     * 地理围栏信息
+     * @since MapKit 3.9.1
+     */
+    info: GeofenceInfo
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 更新地理围栏状态
+   * @public
+   * @since MapKit 3.9.8
+   * @platform iOS Android
+   */
+  export function changeGeofenceStatus(params: {
+    /**
+     * 区分不同的地理围栏业务。空数据时默认为场景类型地理围栏 GeofenceBusinessType.Scene。
+     * @since MapKit 3.9.8
+     */
+    businessInfo?: GeofenceBusinessInfo
+    /**
+     * 地理围栏信息
+     * @since MapKit 3.9.8
+     */
+    info: GeofenceInfo
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
@@ -50,32 +255,146 @@ declare namespace ty.map {
 
   /**
    * 取消地理围栏
-   *权限: [scope.location]
+   * 权限: [scope.location]
+   * @public
+   * @since MapKit 3.0.1
+   * @platform iOS Android
+   * @deprecated unregister
    */
   export function unregisterGeofence(params?: {
-    /** 地理围栏名称 */
+    /**
+     * 地理围栏名称
+     * @since MapKit 3.9.1
+     */
     geoTitle?: string
-    /** 经度 */
+    /**
+     * 经度
+     * @since MapKit 3.9.1
+     * @defaultValue 0.0
+     */
     longitude?: number
-    /** 纬度 */
+    /**
+     * 纬度
+     * @since MapKit 3.9.1
+     * @defaultValue 0.0
+     */
     latitude?: number
-    /** 半径 */
+    /**
+     * 半径
+     * @since MapKit 3.9.1
+     * @defaultValue 0
+     */
     radius?: number
-    /** id */
+    /**
+     * id
+     * @since MapKit 3.9.1
+     */
     geofenceId?: string
     /**
      * 半径
      * 0:进度地理围栏
      * 1：离开地理围栏
+     * @since MapKit 3.9.1
+     * @defaultValue 0
      */
     type?: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 地理围栏是否达到上限
+   * 权限: [scope.location]
+   * @public
+   * @since MapKit 3.0.1
+   * @platform iOS Android
+   * @deprecated isReachLimit
+   */
+  export function isGeofenceReachLimit(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 地理围栏是否达到上限
+       * @since MapKit 3.0.5
+       * @defaultValue false
+       */
+      reachLimit?: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 更新地理围栏
+   * 权限: [scope.location]
+   * @public
+   * @since MapKit 3.0.1
+   * @platform iOS Android
+   * @deprecated register
+   */
+  export function updateGeofence(params: {
+    /**
+     * 注册的地理围栏
+     * @since MapKit 3.0.1
+     */
+    registerGeoFence: GeofenceInfo[]
+    /**
+     * 取消的地理围栏
+     * @since MapKit 3.0.1
+     */
+    unregisterGeoFence: GeofenceInfo[]
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 更新成功
+       * @since MapKit 3.0.5
+       * @defaultValue false
+       */
+      success?: boolean
+    }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
@@ -83,32 +402,64 @@ declare namespace ty.map {
 
   /**
    * 注册地理围栏
-   *权限: [scope.location]
+   * 权限: [scope.location]
+   * @public
+   * @since MapKit 3.0.1
+   * @platform iOS Android
+   * @deprecated register
    */
   export function registerGeofence(params?: {
-    /** 地理围栏名称 */
+    /**
+     * 地理围栏名称
+     * @since MapKit 3.9.1
+     */
     geoTitle?: string
-    /** 经度 */
+    /**
+     * 经度
+     * @since MapKit 3.9.1
+     * @defaultValue 0.0
+     */
     longitude?: number
-    /** 纬度 */
+    /**
+     * 纬度
+     * @since MapKit 3.9.1
+     * @defaultValue 0.0
+     */
     latitude?: number
-    /** 半径 */
+    /**
+     * 半径
+     * @since MapKit 3.9.1
+     * @defaultValue 0
+     */
     radius?: number
-    /** id */
+    /**
+     * id
+     * @since MapKit 3.9.1
+     */
     geofenceId?: string
     /**
      * 半径
      * 0:进度地理围栏
      * 1：离开地理围栏
+     * @since MapKit 3.9.1
+     * @defaultValue 0
      */
     type?: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
@@ -116,299 +467,691 @@ declare namespace ty.map {
 
   /**
    * 打开地理围栏地图页面,获取地理围栏信息(新建或者编辑地理围栏)
-   *权限: [scope.location]
+   * 权限: [scope.location]
+   * @public
+   * @since MapKit 3.0.1
+   * @platform iOS Android
+   * @deprecated openMap
    */
   export function openGeofenceMap(params?: {
-    /** 地理围栏名称 */
+    /**
+     * 地理围栏名称
+     * @since MapKit 3.9.1
+     */
     geoTitle?: string
-    /** 经度 */
+    /**
+     * 经度
+     * @since MapKit 3.9.1
+     * @defaultValue 0.0
+     */
     longitude?: number
-    /** 纬度 */
+    /**
+     * 纬度
+     * @since MapKit 3.9.1
+     * @defaultValue 0.0
+     */
     latitude?: number
-    /** 半径 */
+    /**
+     * 半径
+     * @since MapKit 3.9.1
+     * @defaultValue 0
+     */
     radius?: number
-    /** id */
+    /**
+     * id
+     * @since MapKit 3.9.1
+     */
     geofenceId?: string
     /**
      * 半径
      * 0:进度地理围栏
      * 1：离开地理围栏
+     * @since MapKit 3.9.1
+     * @defaultValue 0
      */
     type?: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
   /**
-   * 获取当前的地理位置、速度
+   * 获取当前地理位置和速度
+   * @public
+   * @since MapKit 1.0.6
+   * @platform iOS Android
    */
   export function getLocation(params: {
-    /** wgs84 返回 gps 坐标，gcj02 返回可用于 openLocation 的坐标 */
+    /**
+     * wgs84返回GPS坐标，gcj02返回可用于openLocation的坐标
+     * @since MapKit 1.0.6
+     */
     type: string
-    /** 传入 true 会返回高度信息，由于获取高度需要较高精确度，会减慢接口返回速度 */
+    /**
+     * 传入true会返回高度信息。由于获取高度需要较高精度，会减慢接口响应速度。
+     * @since MapKit 1.0.6
+     */
     altitude: boolean
-    /** 开启高精度定位 */
+    /**
+     * 开启高精度定位
+     * @since MapKit 1.0.6
+     */
     isHighAccuracy: boolean
-    /** 高精度定位超时时间(ms)，指定时间内返回最高精度，该值3000ms以上高精度定位才有效果 */
+    /**
+     * 高精度定位超时时间(ms)。指定时间内返回最高精度，该值3000ms以上高精度定位才有效果。
+     * @since MapKit 1.0.6
+     */
     highAccuracyExpireTime: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 纬度，范围为 -90~90，负数表示南纬 */
+      /**
+       * 纬度，范围 -90~90，负数表示南纬
+       * @since MapKit 3.0.5
+       */
       latitude: number
-      /** 经度，范围为 -180~180，负数表示西经 */
+      /**
+       * 经度，范围 -180~180，负数表示西经
+       * @since MapKit 3.0.5
+       */
       longitude: number
-      /** 速度，单位 m/s */
+      /**
+       * 速度，单位 m/s
+       * @since MapKit 3.0.5
+       */
       speed: number
-      /** 位置的精确度 */
+      /**
+       * 定位精度
+       * @since MapKit 3.0.5
+       */
       accuracy: number
-      /** 高度，单位 m */
+      /**
+       * 海拔，单位 m
+       * @since MapKit 3.0.5
+       */
       altitude: number
-      /** 垂直精度，单位 m（Android 无法获取，返回 0） */
+      /**
+       * 垂直精度，单位 m（Android无法获取，返回0）
+       * @since MapKit 3.0.5
+       */
       verticalAccuracy: number
-      /** 水平精度，单位 m */
+      /**
+       * 水平精度，单位 m
+       * @since MapKit 3.0.5
+       */
       horizontalAccuracy: number
-      /** 城市名称street */
+      /**
+       * 城市名称
+       * @since MapKit 3.0.5
+       */
       cityName: string
-      /** 街道名称 */
+      /**
+       * 街道名称
+       * @since MapKit 3.0.5
+       */
       streetName: string
-      /** 位置名称 */
+      /**
+       * 位置名称，历史上iOS返回Array类型，建议使用formatAddress字段
+       * @since MapKit 3.0.5
+       */
       address: string
-      /** 国家码 */
+      /**
+       * 格式化地址
+       * @since MapKit 3.6.0
+       */
+      formatAddress: string
+      /**
+       * 国家代码
+       * @since MapKit 3.1.0
+       */
       countryCode: string
-      /** 邮编 */
+      /**
+       * 邮政编码
+       * @since MapKit 3.1.0
+       */
       postalCode: string
-      /** 国家名 */
+      /**
+       * 国家名称
+       * @since MapKit 3.1.1
+       */
       countryName: string
-      /** 省名 */
+      /**
+       * 省份名称
+       * @since MapKit 3.1.1
+       */
       province: string
-      /** 区名, 次级区域名 */
+      /**
+       * 区县名称，二级区域名称
+       * @since MapKit 3.1.1
+       */
       district: string
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
   /**
-   * 打开地图选择位置。
+   * 打开地图选择位置
+   * @public
+   * @since MapKit 1.0.6
+   * @platform iOS Android
    */
   export function chooseLocation(params?: {
-    /** 目标地纬度 */
+    /**
+     * 目标纬度
+     * @since MapKit 1.0.6
+     */
     latitude?: number
-    /** 目标地经度 */
+    /**
+     * 目标经度
+     * @since MapKit 1.0.6
+     */
     longitude?: number
+    /**
+     * 标题
+     * @since MapKit 7.4.0
+     */
+    title?: string
+    /**
+     * 详细描述文本
+     * @since MapKit 7.4.0
+     */
+    detailText?: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 位置名称 */
+      /**
+       * 位置名称
+       * @since MapKit 3.0.5
+       */
       name: string
-      /** 详细地址 */
+      /**
+       * 详细地址
+       * @since MapKit 3.0.5
+       */
       address: string
-      /** 纬度，浮点数，范围为-90~90，负数表示南纬。使用 gcj02 国测局坐标系 */
+      /**
+       * 纬度，浮点数，范围 -90~90，负数表示南纬。使用gcj02坐标系。
+       * @since MapKit 3.0.5
+       */
       latitude: number
-      /** 经度，浮点数，范围为-180~180，负数表示西经。使用 gcj02 国测局坐标系 */
+      /**
+       * 经度，浮点数，范围 -180~180，负数表示西经。使用gcj02坐标系。
+       * @since MapKit 3.0.5
+       */
       longitude: number
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
   /**
-   * 获取可跳转第三方地图的地图类型
+   * 获取可打开的第三方地图类型
+   * @public
+   * @since MapKit 2.1.0
+   * @platform iOS Android
    */
   export function getMapList(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 可跳转的地图厂商，目前支持：BMK：百度地图 MA：高德地图 TENCENT：腾讯地图 Google：Google地图 */
+      /**
+       * 支持的地图厂商，目前支持：BMK: 百度地图, MA: 高德地图, TENCENT: 腾讯地图, Google: 谷歌地图
+       * @since MapKit 3.0.5
+       */
       maps: string[]
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
   /**
-   * 使用三方地图查看位置
+   * 使用第三方地图查看位置
+   * @public
+   * @since MapKit 2.1.0
+   * @platform iOS Android
    */
   export function openMapAppLocation(params: {
-    /** 纬度，范围为 -90~90，负数表示南纬 */
+    /**
+     * 纬度，范围 -90~90，负数表示南纬
+     * @since MapKit 2.1.0
+     */
     latitude: number
-    /** 经度，范围为 -180~180，负数表示西经 */
+    /**
+     * 经度，范围 -180~180，负数表示西经
+     * @since MapKit 2.1.0
+     */
     longitude: number
-    /** 位置名 */
+    /**
+     * 位置名称
+     * @since MapKit 2.1.0
+     */
     name: string
-    /** 地址的详细说明 */
+    /**
+     * 地址详细描述
+     * @since MapKit 2.1.0
+     */
     address: string
-    /** 地图类型，目前支持：BMK：百度地图 MA：高德地图 TENCENT：腾讯地图 Google：Google地图 */
+    /**
+     * 地图类型，目前支持：BMK: 百度地图, MA: 高德地图, TENCENT: 腾讯地图, Google: 谷歌地图
+     * @since MapKit 2.1.0
+     */
+    mapType: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 使用第三方地图应用打开地图并导航到指定位置
+   * @public
+   * @since MapKit 7.4.0
+   * @platform iOS Android
+   */
+  export function openMapNavigation(params: {
+    /**
+     * 起始位置
+     * @since MapKit 7.4.0
+     */
+    startLocation: LocationInfo
+    /**
+     * 终点位置
+     * @since MapKit 7.4.0
+     */
+    endLocation: LocationInfo
+    /**
+     * 导航模式
+     * @since MapKit 7.5.8
+     */
+    navigationMode: string
+    /**
+     * 地图类型，目前支持：BMK: 百度地图, MA: 高德地图, TENCENT: 腾讯地图, Google: 谷歌地图
+     * @since MapKit 7.4.0
+     */
     mapType: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: null) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
   /**
-   * 根据经纬度或者地址
+   * 转换经纬度或地址
+   * @public
+   * @since MapKit 3.2.2
+   * @platform iOS Android
    */
   export function transformLocation(params: {
-    /** wgs84 返回 gps 坐标，gcj02 返回可用于 openLocation 的坐标 */
+    /**
+     * wgs84返回GPS坐标，gcj02返回可用于openLocation的坐标
+     * @since MapKit 3.2.2
+     */
     type: string
-    /** 纬度，范围为 -90~90，负数表示南纬 */
+    /**
+     * 纬度，范围 -90~90，负数表示南纬
+     * @since MapKit 3.2.2
+     */
     latitude: number
-    /** 经度，范围为 -180~180，负数表示西经 */
+    /**
+     * 经度，范围 -180~180，负数表示西经
+     * @since MapKit 3.2.2
+     */
     longitude: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 纬度，范围为 -90~90，负数表示南纬 */
+      /**
+       * 纬度，范围 -90~90，负数表示南纬
+       * @since MapKit 3.2.2
+       */
       latitude: number
-      /** 经度，范围为 -180~180，负数表示西经 */
+      /**
+       * 经度，范围 -180~180，负数表示西经
+       * @since MapKit 3.2.2
+       */
       longitude: number
-      /** 城市名称street */
+      /**
+       * 城市名称
+       * @since MapKit 3.2.2
+       */
       cityName: string
-      /** 街道名称 */
+      /**
+       * 街道名称
+       * @since MapKit 3.2.2
+       */
       streetName: string
-      /** 位置名称 */
+      /**
+       * 位置名称，历史上iOS返回Array类型，建议使用formatAddress字段
+       * @since MapKit 3.2.2
+       */
       address: string
-      /** 国家码 */
+      /**
+       * 格式化地址
+       * @since MapKit 3.6.0
+       */
+      formatAddress: string
+      /**
+       * 国家代码
+       * @since MapKit 3.2.2
+       */
       countryCode: string
-      /** 邮编 */
+      /**
+       * 邮政编码
+       * @since MapKit 3.2.2
+       */
       postalCode: string
-      /** 国家名 */
+      /**
+       * 国家名称
+       * @since MapKit 3.2.2
+       */
       countryName: string
-      /** 省名 */
+      /**
+       * 省份名称
+       * @since MapKit 3.2.2
+       */
       province: string
-      /** 区名, 次级区域名 */
+      /**
+       * 区县名称，二级区域名称
+       * @since MapKit 3.2.2
+       */
       district: string
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
   /**
-   * 将经纬度转换为具体的地址
+   * 将经纬度转换为具体地址
+   * @public
+   * @since MapKit 3.4.13
+   * @platform iOS Android
    */
   export function reverseGeocodeLocation(params: {
-    /** 经度 */
+    /**
+     * 经度
+     * @since MapKit 3.4.13
+     */
     longitude: number
-    /** 纬度 */
+    /**
+     * 纬度
+     * @since MapKit 3.4.13
+     */
     latitude: number
-    /** 请求的经纬度类型，wgs84 返回 gps 坐标，gcj02 返回可用于 openLocation 的坐标，默认为 wgs84 */
+    /**
+     * 请求坐标类型，wgs84返回GPS坐标，gcj02返回可用于openLocation的坐标，默认为wgs84
+     * @since MapKit 3.4.13
+     * @defaultValue "wgs84"
+     */
     requestType?: string
-    /** 响应的经纬度类型，wgs84 返回 gps 坐标，gcj02 返回可用于 openLocation 的坐标，默认为 wgs84 */
+    /**
+     * 响应坐标类型，wgs84返回GPS坐标，gcj02返回可用于openLocation的坐标，默认为wgs84
+     * @since MapKit 3.4.13
+     * @defaultValue "wgs84"
+     */
     responseType?: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 纬度，范围为 -90~90，负数表示南纬 */
+      /**
+       * 纬度，范围 -90~90，负数表示南纬
+       * @since MapKit 3.4.13
+       */
       latitude: number
-      /** 经度，范围为 -180~180，负数表示西经 */
+      /**
+       * 经度，范围 -180~180，负数表示西经
+       * @since MapKit 3.4.13
+       */
       longitude: number
-      /** 城市名称street */
+      /**
+       * 城市名称
+       * @since MapKit 3.4.13
+       */
       cityName: string
-      /** 街道名称 */
+      /**
+       * 街道名称
+       * @since MapKit 3.4.13
+       */
       streetName: string
-      /** 位置名称 */
+      /**
+       * 位置名称，历史上iOS返回Array类型，建议使用formatAddress字段
+       * @since MapKit 3.4.13
+       */
       address: string
-      /** 国家码 */
+      /**
+       * 格式化地址
+       * @since MapKit 3.6.0
+       */
+      formatAddress: string
+      /**
+       * 国家代码
+       * @since MapKit 3.4.13
+       */
       countryCode: string
-      /** 邮编 */
+      /**
+       * 邮政编码
+       * @since MapKit 3.4.13
+       */
       postalCode: string
-      /** 国家名 */
+      /**
+       * 国家名称
+       * @since MapKit 3.4.13
+       */
       countryName: string
-      /** 省名 */
+      /**
+       * 省份名称
+       * @since MapKit 3.4.13
+       */
       province: string
-      /** 区名, 次级区域名 */
+      /**
+       * 区县名称，二级区域名称
+       * @since MapKit 3.4.13
+       */
       district: string
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
   /**
-   * 将WGS84坐标系转为GCJ02坐标系
+   * 将WGS84坐标系转换为GCJ02坐标系
+   * @public
+   * @since MapKit 3.4.13
+   * @platform iOS Android
    */
   export function coordinateWGS84ToGCJ02(params: {
-    /** 经度 */
+    /**
+     * 经度
+     * @since MapKit 3.4.13
+     */
     longitude: number
-    /** 纬度 */
+    /**
+     * 纬度
+     * @since MapKit 3.4.13
+     */
     latitude: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 经度 */
+      /**
+       * 经度
+       * @since MapKit 3.4.13
+       */
       longitude: number
-      /** 纬度 */
+      /**
+       * 纬度
+       * @since MapKit 3.4.13
+       */
       latitude: number
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
   /**
-   * 将GCJ02坐标系转为WGS84坐标系
+   * 将GCJ02坐标系转换为WGS84坐标系
+   * @public
+   * @since MapKit 3.4.13
+   * @platform iOS Android
    */
   export function coordinateGCJ02ToWGS84(params: {
-    /** 经度 */
+    /**
+     * 经度
+     * @since MapKit 3.4.13
+     */
     longitude: number
-    /** 纬度 */
+    /**
+     * 纬度
+     * @since MapKit 3.4.13
+     */
     latitude: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 经度 */
+      /**
+       * 经度
+       * @since MapKit 3.4.13
+       */
       longitude: number
-      /** 纬度 */
+      /**
+       * 纬度
+       * @since MapKit 3.4.13
+       */
       latitude: number
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
@@ -416,195 +1159,808 @@ declare namespace ty.map {
 
   /**
    * 获取当前地图类型
-   *huawei: 华为地图
-   *google: 谷歌地图
-   *amap: 高德地图
-   *apple: 苹果地图
+   * huawei: 华为地图
+   * google: 谷歌地图
+   * amap: 高德地图
+   * apple: 苹果地图
+   * @public
+   * @since MapKit 3.4.13
+   * @platform iOS Android
    */
   export function getMapType(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
     complete?: () => void
+    /** 接口调用成功的回调函数 */
     success?: (params: {
-      /** 地图类型 */
+      /**
+       * 地图类型
+       * @since MapKit 3.4.13
+       */
       type: string
     }) => void
+    /** 接口调用失败的回调函数 */
     fail?: (params: {
+      /** 错误信息 */
       errorMsg: string
+      /** 错误码 */
       errorCode: string | number
+      /** 错误扩展 */
       innerError: {
+        /** 错误扩展码 */
         errorCode: string | number
+        /** 错误扩展信息 */
         errorMsg: string
       }
     }) => void
   }): void
 
-  export type GeofenceInfo = {
-    /** 地理围栏名称 */
-    geoTitle?: string
-    /** 经度 */
-    longitude?: number
-    /** 纬度 */
-    latitude?: number
-    /** 半径 */
-    radius?: number
-    /** id */
-    geofenceId?: string
+  /**
+   * 搜索地址(列表)
+   * @public
+   * @since MapKit 3.4.16
+   * @platform iOS Android
+   */
+  export function searchAddressList(params: {
     /**
-     * 半径
-     * 0:进度地理围栏
-     * 1：离开地理围栏
+     * 地图能力(Android only)
+     * 0-高德
+     * 1-Google
+     * 2-mapbox
+     * @since MapKit 3.4.16
+     */
+    type: number
+    /**
+     * 模糊搜索关键词 The search string that you want completions for.
+     * @since MapKit 3.4.16
+     */
+    keyword: string
+    /**
+     * 当前城市名字-仅高德搜索需要
+     * 传入""代表在全国进行检索，否则按照传入的city进行范围检索
+     * @since MapKit 3.4.16
+     * @defaultValue ""
+     */
+    city?: string
+    /**
+     * 限制搜索范围的国家代码-仅Google、MapBox地址搜索需要
+     * ISO 3166-1 Alpha-2 国家/地区代码(不区分大小写)
+     * 例如:中国CN、香港HK、台湾TW
+     * @since MapKit 3.4.16
+     */
+    countryCode: string
+    /**
+     * 搜索中心点经纬度、搜索范围(IOS ONLY)设置
+     * @since MapKit 3.4.16
+     */
+    region: CoordinateRegion
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: AddressInfo[]) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取地址详细信息
+   * @public
+   * @since MapKit 3.4.16
+   * @platform iOS Android
+   */
+  export function getAddressInfo(params: {
+    /**
+     * 地址 POI ID
+     * @since MapKit 3.4.16
+     */
+    poiID: string
+    /**
+     * 地址名称
+     * @since MapKit 3.4.16
+     */
+    name: string
+    /**
+     * 详细的地址信息
+     * @since MapKit 3.4.16
+     */
+    address: string
+    /**
+     * 当前地址经纬度坐标
+     * @since MapKit 3.4.16
+     */
+    coordinate2D: LocationCoordinate2D
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 地址 POI ID
+       * @since MapKit 3.4.16
+       */
+      poiID: string
+      /**
+       * 地址名称
+       * @since MapKit 3.4.16
+       */
+      name: string
+      /**
+       * 详细的地址信息
+       * @since MapKit 3.4.16
+       */
+      address: string
+      /**
+       * 当前地址经纬度坐标
+       * @since MapKit 3.4.16
+       */
+      coordinate2D: LocationCoordinate2D
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /** @since MapKit 2.2.1 */
+  export interface DiffLayerMap {
+    /**
+     * 当前组件类型
+     * @since MapKit 2.2.1
+     * @defaultValue 0
+     */
+    type?: number
+  }
+
+  /** @since MapKit 3.9.1 */
+  export interface GeofenceBusinessInfo {
+    /**
+     * 区分不同的地理围栏业务。空数据时默认为场景类型地理围栏 GeofenceBusinessType.Scene。
+     * @since MapKit 3.9.1
+     */
+    businessType?: string
+    /**
+     * 该业务类型的附加数据
+     * @since MapKit 3.9.1
+     */
+    businessData?: Record<string, any>
+  }
+
+  /** @since MapKit 3.9.1 */
+  export interface IsGeofenceSupportResponse {
+    /**
+     * 是否支持地理围栏
+     * @since MapKit 3.9.1
+     * @defaultValue false
+     */
+    isSupport?: boolean
+  }
+
+  /** @since MapKit 3.0.1 */
+  export interface IsGeofenceReachLimitResponse {
+    /**
+     * 地理围栏是否达到上限
+     * @since MapKit 3.0.1
+     * @defaultValue false
      */
-    type?: number
-  }
-
-  export type UpdateGeofenceParams = {
-    /** 注册的地理围栏 */
-    registerGeoFence: GeofenceInfo[]
-    /** 取消的地理围栏 */
-    unregisterGeoFence: GeofenceInfo[]
-  }
-
-  export type UpdateGeofenceResponse = {
-    /** 更新成功 */
-    success?: boolean
-  }
-
-  export type IsGeofenceReachLimitResponse = {
-    /** 地理围栏是否达到上限 */
     reachLimit?: boolean
   }
 
-  export type LocationBean = {
-    /** wgs84 返回 gps 坐标，gcj02 返回可用于 openLocation 的坐标 */
+  /** @since MapKit 3.0.1 */
+  export interface GeofenceInfo {
+    /**
+     * 地理围栏名称
+     * @since MapKit 3.9.1
+     */
+    geoTitle?: string
+    /**
+     * 经度
+     * @since MapKit 3.9.1
+     * @defaultValue 0.0
+     */
+    longitude?: number
+    /**
+     * 纬度
+     * @since MapKit 3.9.1
+     * @defaultValue 0.0
+     */
+    latitude?: number
+    /**
+     * 半径
+     * @since MapKit 3.9.1
+     * @defaultValue 0
+     */
+    radius?: number
+    /**
+     * id
+     * @since MapKit 3.9.1
+     */
+    geofenceId?: string
+    /**
+     * 半径
+     * 0:进度地理围栏
+     * 1：离开地理围栏
+     * @since MapKit 3.9.1
+     * @defaultValue 0
+     */
+    type?: number
+  }
+
+  /** @since MapKit 3.9.1 */
+  export interface Geofence {
+    /**
+     * 区分不同的地理围栏业务。空数据时默认为场景类型地理围栏 GeofenceBusinessType.Scene。
+     * @since MapKit 3.9.1
+     */
+    businessInfo?: GeofenceBusinessInfo
+    /**
+     * 地理围栏信息
+     * @since MapKit 3.9.1
+     */
+    info: GeofenceInfo
+  }
+
+  /** @since MapKit 3.9.1 */
+  export interface OpenMapResponse {
+    /**
+     * 取消保存地理围栏
+     * @since MapKit 3.9.1
+     * @defaultValue false
+     */
+    isCancel?: boolean
+    /**
+     * 地理围栏信息
+     * @since MapKit 3.9.1
+     */
+    geofenceInfo: GeofenceInfo
+  }
+
+  /** @since MapKit 3.0.1 */
+  export interface UpdateGeofenceParams {
+    /**
+     * 注册的地理围栏
+     * @since MapKit 3.0.1
+     */
+    registerGeoFence: GeofenceInfo[]
+    /**
+     * 取消的地理围栏
+     * @since MapKit 3.0.1
+     */
+    unregisterGeoFence: GeofenceInfo[]
+  }
+
+  /** @since MapKit 3.0.1 */
+  export interface UpdateGeofenceResponse {
+    /**
+     * 更新成功
+     * @since MapKit 3.0.1
+     * @defaultValue false
+     */
+    success?: boolean
+  }
+
+  /** @since MapKit 3.0.1 */
+  export interface SupportGeofenceResponse {
+    /**
+     * 是否支持地理围栏
+     * @since MapKit 3.0.1
+     * @defaultValue false
+     */
+    isSupport?: boolean
+  }
+
+  /** @since MapKit 3.9.8 */
+  export enum GeofenceBusinessType {
+    /**
+     * 场景类型地理围栏
+     * @since MapKit 3.9.8
+     */
+    Scene = "scene",
+
+    /**
+     * 门锁场景地理围栏
+     * @since MapKit 3.9.8
+     */
+    BleLockScene = "bleLockScene",
+  }
+
+  /** @since MapKit 1.0.6 */
+  export interface LocationBean {
+    /**
+     * wgs84返回GPS坐标，gcj02返回可用于openLocation的坐标
+     * @since MapKit 1.0.6
+     */
     type: string
-    /** 传入 true 会返回高度信息，由于获取高度需要较高精确度，会减慢接口返回速度 */
+    /**
+     * 传入true会返回高度信息。由于获取高度需要较高精度，会减慢接口响应速度。
+     * @since MapKit 1.0.6
+     */
     altitude: boolean
-    /** 开启高精度定位 */
+    /**
+     * 开启高精度定位
+     * @since MapKit 1.0.6
+     */
     isHighAccuracy: boolean
-    /** 高精度定位超时时间(ms)，指定时间内返回最高精度，该值3000ms以上高精度定位才有效果 */
+    /**
+     * 高精度定位超时时间(ms)。指定时间内返回最高精度，该值3000ms以上高精度定位才有效果。
+     * @since MapKit 1.0.6
+     */
     highAccuracyExpireTime: number
   }
 
-  export type LocationCB = {
-    /** 纬度，范围为 -90~90，负数表示南纬 */
+  /** @since MapKit 1.0.6 */
+  export interface LocationCB {
+    /**
+     * 纬度，范围 -90~90，负数表示南纬
+     * @since MapKit 1.0.6
+     */
     latitude: number
-    /** 经度，范围为 -180~180，负数表示西经 */
+    /**
+     * 经度，范围 -180~180，负数表示西经
+     * @since MapKit 1.0.6
+     */
     longitude: number
-    /** 速度，单位 m/s */
+    /**
+     * 速度，单位 m/s
+     * @since MapKit 1.0.6
+     */
     speed: number
-    /** 位置的精确度 */
+    /**
+     * 定位精度
+     * @since MapKit 1.0.6
+     */
     accuracy: number
-    /** 高度，单位 m */
+    /**
+     * 海拔，单位 m
+     * @since MapKit 1.0.6
+     */
     altitude: number
-    /** 垂直精度，单位 m（Android 无法获取，返回 0） */
+    /**
+     * 垂直精度，单位 m（Android无法获取，返回0）
+     * @since MapKit 1.0.6
+     */
     verticalAccuracy: number
-    /** 水平精度，单位 m */
+    /**
+     * 水平精度，单位 m
+     * @since MapKit 1.0.6
+     */
     horizontalAccuracy: number
-    /** 城市名称street */
+    /**
+     * 城市名称
+     * @since MapKit 3.0.4
+     */
     cityName: string
-    /** 街道名称 */
+    /**
+     * 街道名称
+     * @since MapKit 3.0.4
+     */
     streetName: string
-    /** 位置名称 */
+    /**
+     * 位置名称，历史上iOS返回Array类型，建议使用formatAddress字段
+     * @since MapKit 3.0.4
+     */
     address: string
-    /** 国家码 */
+    /**
+     * 格式化地址
+     * @since MapKit 3.6.0
+     */
+    formatAddress: string
+    /**
+     * 国家代码
+     * @since MapKit 3.1.0
+     */
     countryCode: string
-    /** 邮编 */
+    /**
+     * 邮政编码
+     * @since MapKit 3.1.0
+     */
     postalCode: string
-    /** 国家名 */
+    /**
+     * 国家名称
+     * @since MapKit 3.1.1
+     */
     countryName: string
-    /** 省名 */
+    /**
+     * 省份名称
+     * @since MapKit 3.1.1
+     */
     province: string
-    /** 区名, 次级区域名 */
+    /**
+     * 区县名称，二级区域名称
+     * @since MapKit 3.1.1
+     */
     district: string
   }
 
-  export type ChooseBean = {
-    /** 目标地纬度 */
+  /** @since MapKit 1.0.6 */
+  export interface ChooseBean {
+    /**
+     * 目标纬度
+     * @since MapKit 1.0.6
+     */
     latitude?: number
-    /** 目标地经度 */
+    /**
+     * 目标经度
+     * @since MapKit 1.0.6
+     */
     longitude?: number
+    /**
+     * 标题
+     * @since MapKit 7.4.0
+     */
+    title?: string
+    /**
+     * 详细描述文本
+     * @since MapKit 7.4.0
+     */
+    detailText?: string
   }
 
-  export type ChooseCB = {
-    /** 位置名称 */
+  /** @since MapKit 1.0.6 */
+  export interface ChooseCB {
+    /**
+     * 位置名称
+     * @since MapKit 1.0.6
+     */
     name: string
-    /** 详细地址 */
+    /**
+     * 详细地址
+     * @since MapKit 1.0.6
+     */
     address: string
-    /** 纬度，浮点数，范围为-90~90，负数表示南纬。使用 gcj02 国测局坐标系 */
+    /**
+     * 纬度，浮点数，范围 -90~90，负数表示南纬。使用gcj02坐标系。
+     * @since MapKit 1.0.6
+     */
     latitude: number
-    /** 经度，浮点数，范围为-180~180，负数表示西经。使用 gcj02 国测局坐标系 */
+    /**
+     * 经度，浮点数，范围 -180~180，负数表示西经。使用gcj02坐标系。
+     * @since MapKit 1.0.6
+     */
     longitude: number
   }
 
-  export type MapsBean = {
-    /** 可跳转的地图厂商，目前支持：BMK：百度地图 MA：高德地图 TENCENT：腾讯地图 Google：Google地图 */
+  /** @since MapKit 2.1.0 */
+  export interface MapsBean {
+    /**
+     * 支持的地图厂商，目前支持：BMK: 百度地图, MA: 高德地图, TENCENT: 腾讯地图, Google: 谷歌地图
+     * @since MapKit 2.1.0
+     */
     maps: string[]
   }
 
-  export type OpenMapAppBean = {
-    /** 纬度，范围为 -90~90，负数表示南纬 */
+  /** @since MapKit 2.1.0 */
+  export interface OpenMapAppBean {
+    /**
+     * 纬度，范围 -90~90，负数表示南纬
+     * @since MapKit 2.1.0
+     */
     latitude: number
-    /** 经度，范围为 -180~180，负数表示西经 */
+    /**
+     * 经度，范围 -180~180，负数表示西经
+     * @since MapKit 2.1.0
+     */
     longitude: number
-    /** 位置名 */
+    /**
+     * 位置名称
+     * @since MapKit 2.1.0
+     */
     name: string
-    /** 地址的详细说明 */
+    /**
+     * 地址详细描述
+     * @since MapKit 2.1.0
+     */
     address: string
-    /** 地图类型，目前支持：BMK：百度地图 MA：高德地图 TENCENT：腾讯地图 Google：Google地图 */
+    /**
+     * 地图类型，目前支持：BMK: 百度地图, MA: 高德地图, TENCENT: 腾讯地图, Google: 谷歌地图
+     * @since MapKit 2.1.0
+     */
     mapType: string
   }
 
-  export type TransformLocationReq = {
-    /** wgs84 返回 gps 坐标，gcj02 返回可用于 openLocation 的坐标 */
+  /**
+   * 位置信息
+   * @since MapKit 7.4.0
+   */
+  export interface LocationInfo {
+    /**
+     * 纬度，范围 -90~90，负数表示南纬
+     * @since MapKit 7.4.0
+     */
+    latitude: number
+    /**
+     * 经度，范围 -180~180，负数表示西经
+     * @since MapKit 7.4.0
+     */
+    longitude: number
+    /**
+     * 当前点位置名称
+     * @since MapKit 7.4.0
+     */
+    addressName: string
+  }
+
+  /**
+   * 使用第三方地图应用打开地图并导航到指定位置
+   * @since MapKit 7.4.0
+   */
+  export interface OpenMapNavigationBean {
+    /**
+     * 起始位置
+     * @since MapKit 7.4.0
+     */
+    startLocation: LocationInfo
+    /**
+     * 终点位置
+     * @since MapKit 7.4.0
+     */
+    endLocation: LocationInfo
+    /**
+     * 导航模式
+     * @since MapKit 7.5.8
+     */
+    navigationMode: string
+    /**
+     * 地图类型，目前支持：BMK: 百度地图, MA: 高德地图, TENCENT: 腾讯地图, Google: 谷歌地图
+     * @since MapKit 7.4.0
+     */
+    mapType: string
+  }
+
+  /** @since MapKit 3.2.2 */
+  export interface TransformLocationReq {
+    /**
+     * wgs84返回GPS坐标，gcj02返回可用于openLocation的坐标
+     * @since MapKit 3.2.2
+     */
     type: string
-    /** 纬度，范围为 -90~90，负数表示南纬 */
+    /**
+     * 纬度，范围 -90~90，负数表示南纬
+     * @since MapKit 3.2.2
+     */
     latitude: number
-    /** 经度，范围为 -180~180，负数表示西经 */
+    /**
+     * 经度，范围 -180~180，负数表示西经
+     * @since MapKit 3.2.2
+     */
     longitude: number
   }
 
-  export type TransformLocationResp = {
-    /** 纬度，范围为 -90~90，负数表示南纬 */
+  /** @since MapKit 3.2.2 */
+  export interface TransformLocationResp {
+    /**
+     * 纬度，范围 -90~90，负数表示南纬
+     * @since MapKit 3.2.2
+     */
     latitude: number
-    /** 经度，范围为 -180~180，负数表示西经 */
+    /**
+     * 经度，范围 -180~180，负数表示西经
+     * @since MapKit 3.2.2
+     */
     longitude: number
-    /** 城市名称street */
+    /**
+     * 城市名称
+     * @since MapKit 3.2.2
+     */
     cityName: string
-    /** 街道名称 */
+    /**
+     * 街道名称
+     * @since MapKit 3.2.2
+     */
     streetName: string
-    /** 位置名称 */
+    /**
+     * 位置名称，历史上iOS返回Array类型，建议使用formatAddress字段
+     * @since MapKit 3.2.2
+     */
     address: string
-    /** 国家码 */
+    /**
+     * 格式化地址
+     * @since MapKit 3.6.0
+     */
+    formatAddress: string
+    /**
+     * 国家代码
+     * @since MapKit 3.2.2
+     */
     countryCode: string
-    /** 邮编 */
+    /**
+     * 邮政编码
+     * @since MapKit 3.2.2
+     */
     postalCode: string
-    /** 国家名 */
+    /**
+     * 国家名称
+     * @since MapKit 3.2.2
+     */
     countryName: string
-    /** 省名 */
+    /**
+     * 省份名称
+     * @since MapKit 3.2.2
+     */
     province: string
-    /** 区名, 次级区域名 */
+    /**
+     * 区县名称，二级区域名称
+     * @since MapKit 3.2.2
+     */
     district: string
   }
 
-  export type ReverseGeocodeLocationReq = {
-    /** 经度 */
+  /** @since MapKit 3.4.13 */
+  export interface ReverseGeocodeLocationReq {
+    /**
+     * 经度
+     * @since MapKit 3.4.13
+     */
     longitude: number
-    /** 纬度 */
+    /**
+     * 纬度
+     * @since MapKit 3.4.13
+     */
     latitude: number
-    /** 请求的经纬度类型，wgs84 返回 gps 坐标，gcj02 返回可用于 openLocation 的坐标，默认为 wgs84 */
+    /**
+     * 请求坐标类型，wgs84返回GPS坐标，gcj02返回可用于openLocation的坐标，默认为wgs84
+     * @since MapKit 3.4.13
+     * @defaultValue "wgs84"
+     */
     requestType?: string
-    /** 响应的经纬度类型，wgs84 返回 gps 坐标，gcj02 返回可用于 openLocation 的坐标，默认为 wgs84 */
+    /**
+     * 响应坐标类型，wgs84返回GPS坐标，gcj02返回可用于openLocation的坐标，默认为wgs84
+     * @since MapKit 3.4.13
+     * @defaultValue "wgs84"
+     */
     responseType?: string
   }
 
-  export type Coordinate = {
-    /** 经度 */
+  /** @since MapKit 3.4.13 */
+  export interface Coordinate {
+    /**
+     * 经度
+     * @since MapKit 3.4.13
+     */
     longitude: number
-    /** 纬度 */
+    /**
+     * 纬度
+     * @since MapKit 3.4.13
+     */
     latitude: number
   }
 
-  export type MapTypeBean = {
-    /** 地图类型 */
+  /** @since MapKit 3.4.13 */
+  export interface MapTypeBean {
+    /**
+     * 地图类型
+     * @since MapKit 3.4.13
+     */
     type: string
   }
+
+  /** @since MapKit 1.0.6 */
+  export interface LocationError {
+    /**
+     * 定位错误码
+     * @since MapKit 1.0.6
+     */
+    errCode: number
+  }
+
+  /** @since MapKit 1.0.6 */
+  export interface OpenBean {
+    /**
+     * 纬度，范围 -90~90，负数表示南纬
+     * @since MapKit 1.0.6
+     */
+    latitude: number
+    /**
+     * 经度，范围 -180~180，负数表示西经
+     * @since MapKit 1.0.6
+     */
+    longitude: number
+    /**
+     * 缩放级别，范围 5~18
+     * @since MapKit 1.0.6
+     * @defaultValue 18
+     */
+    scale?: number
+    /**
+     * 位置名称
+     * @since MapKit 1.0.6
+     */
+    name?: string
+    /**
+     * 地址详细描述
+     * @since MapKit 1.0.6
+     */
+    address?: string
+  }
+
+  /** @since MapKit 3.4.16 */
+  export interface CoordinateRegion {}
+
+  /**
+   * 地图搜索-参数配置
+   * @since MapKit 3.4.16
+   */
+  export interface AddressRequestParams {
+    /**
+     * 地图能力(Android only)
+     * 0-高德
+     * 1-Google
+     * 2-mapbox
+     * @since MapKit 3.4.16
+     */
+    type: number
+    /**
+     * 模糊搜索关键词 The search string that you want completions for.
+     * @since MapKit 3.4.16
+     */
+    keyword: string
+    /**
+     * 当前城市名字-仅高德搜索需要
+     * 传入""代表在全国进行检索，否则按照传入的city进行范围检索
+     * @since MapKit 3.4.16
+     * @defaultValue ""
+     */
+    city?: string
+    /**
+     * 限制搜索范围的国家代码-仅Google、MapBox地址搜索需要
+     * ISO 3166-1 Alpha-2 国家/地区代码(不区分大小写)
+     * 例如:中国CN、香港HK、台湾TW
+     * @since MapKit 3.4.16
+     */
+    countryCode: string
+    /**
+     * 搜索中心点经纬度、搜索范围(IOS ONLY)设置
+     * @since MapKit 3.4.16
+     */
+    region: CoordinateRegion
+  }
+
+  /** @since MapKit 3.4.16 */
+  export interface LocationCoordinate2D {}
+
+  /**
+   * 地址信息
+   * @since MapKit 3.4.16
+   */
+  export interface AddressInfo {
+    /**
+     * 地址 POI ID
+     * @since MapKit 3.4.16
+     */
+    poiID: string
+    /**
+     * 地址名称
+     * @since MapKit 3.4.16
+     */
+    name: string
+    /**
+     * 详细的地址信息
+     * @since MapKit 3.4.16
+     */
+    address: string
+    /**
+     * 当前地址经纬度坐标
+     * @since MapKit 3.4.16
+     */
+    coordinate2D: LocationCoordinate2D
+  }
 }