自学内容网 自学内容网

【小程序开发】位置 API 集合(二)

ty.map.openGeofenceMap

打开地理围栏地图页面,获取地理围栏信息(新建或者编辑地理围栏)

权限: [scope.location]

需引入MapKit,且在>=3.0.1版本才可使用

参数

Object object

属性类型默认值必填说明
geoTitlestring地理围栏名称
longitudenumber经度
latitudenumber纬度
radiusnumber半径
geofenceIdstringid
typenumber半径 0:进度地理围栏 1:离开地理围栏
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

函数定义示例

/**
 * 打开地理围栏地图页面,获取地理围栏信息(新建或者编辑地理围栏)
 *权限: [scope.location]
 */
export function openGeofenceMap(params?: {
  /** 地理围栏名称 */
  geoTitle?: string;
  /** 经度 */
  longitude?: number;
  /** 纬度 */
  latitude?: number;
  /** 半径 */
  radius?: number;
  /** id */
  geofenceId?: string;
  /**
   * 半径
   * 0:进度地理围栏
   * 1:离开地理围栏
   */
  type?: number;
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

👉 立即开发

ty.map.openMapAppLocation

使用三方地图查看位置

需引入MapKit,且在>=2.1.1版本才可使用

参数

Object object

属性类型默认值必填说明
latitudenumber纬度,范围为 -90~90,负数表示南纬
longitudenumber经度,范围为 -180~180,负数表示西经
namestring位置名
addressstring地址的详细说明
mapTypestring地图类型,目前支持:BMK:百度地图 MA:高德地图 TENCENT:腾讯地图 Google:Google 地图
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

函数定义示例

/**
 * 使用三方地图查看位置
 */
export function openMapAppLocation(params: {
  /** 纬度,范围为 -90~90,负数表示南纬 */
  latitude: number;
  /** 经度,范围为 -180~180,负数表示西经 */
  longitude: number;
  /** 位置名 */
  name: string;
  /** 地址的详细说明 */
  address: string;
  /** 地图类型,目前支持:BMK:百度地图 MA:高德地图 TENCENT:腾讯地图 Google:Google地图 */
  mapType: string;
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

ty.map.registerGeofence

注册地理围栏

权限: [scope.location]

需引入MapKit,且在>=3.0.1版本才可使用

参数

Object object

属性类型默认值必填说明
geoTitlestring地理围栏名称
longitudenumber经度
latitudenumber纬度
radiusnumber半径
geofenceIdstringid
typenumber半径 0:进度地理围栏 1:离开地理围栏
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

函数定义示例

/**
 * 注册地理围栏
 *权限: [scope.location]
 */
export function registerGeofence(params?: {
  /** 地理围栏名称 */
  geoTitle?: string;
  /** 经度 */
  longitude?: number;
  /** 纬度 */
  latitude?: number;
  /** 半径 */
  radius?: number;
  /** id */
  geofenceId?: string;
  /**
   * 半径
   * 0:进度地理围栏
   * 1:离开地理围栏
   */
  type?: number;
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

ty.map.unregisterGeofence

取消地理围栏

权限: [scope.location]

需引入MapKit,且在>=3.0.1版本才可使用

参数

Object object

属性类型默认值必填说明
geoTitlestring地理围栏名称
longitudenumber经度
latitudenumber纬度
radiusnumber半径
geofenceIdstringid
typenumber半径 0:进度地理围栏 1:离开地理围栏
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

函数定义示例

/**
 * 取消地理围栏
 *权限: [scope.location]
 */
export function unregisterGeofence(params?: {
  /** 地理围栏名称 */
  geoTitle?: string;
  /** 经度 */
  longitude?: number;
  /** 纬度 */
  latitude?: number;
  /** 半径 */
  radius?: number;
  /** id */
  geofenceId?: string;
  /**
   * 半径
   * 0:进度地理围栏
   * 1:离开地理围栏
   */
  type?: number;
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

ty.map.transformLocation

根据经纬度获取地址

需引入MapKit,且在>=3.2.2版本才可使用

参数

Object object

属性类型默认值必填说明
typestringwgs84 返回 gps 坐标,gcj02 返回可用于 openLocation 的坐标
latitudenumber纬度,范围为 -90~90,负数表示南纬
longitudenumber经度,范围为 -180~180,负数表示西经
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数

object.success回调参数

参数

Object res

属性类型说明
latitudenumber纬度,范围为 -90~90,负数表示南纬
longitudenumber经度,范围为 -180~180,负数表示西经
cityNamestring城市名称street
streetNamestring街道名称
addressstring位置名称
countryCodestring国家码
postalCodestring邮编
countryNamestring国家名
provincestring省名
districtstring区名, 次级区域名

object.fail回调参数

参数

Object res

属性类型说明
errorMsgstring插件错误信息
errorCodestring错误码
innerErrorobject插件外部依赖错误信息 {errorMsg: string, errorCode: string }

函数定义示例

/**
 * 根据经纬度获取地址
 */
export function transformLocation(params: {
  /** wgs84 返回 gps 坐标,gcj02 返回可用于 openLocation 的坐标 */
  type: string
  /** 纬度,范围为 -90~90,负数表示南纬 */
  latitude: number
  /** 经度,范围为 -180~180,负数表示西经 */
  longitude: number
  /** 接口调用结束的回调函数(调用成功、失败都会执行) */
  complete?: () => void
  /** 接口调用成功的回调函数 */
  success?: (params: {
    /** 纬度,范围为 -90~90,负数表示南纬 */
    latitude: number
    /** 经度,范围为 -180~180,负数表示西经 */
    longitude: number
    /** 城市名称street */
    cityName: string
    /** 街道名称 */
    streetName: string
    /** 位置名称 */
    address: string
    /** 国家码 */
    countryCode: string
    /** 邮编 */
    postalCode: string
    /** 国家名 */
    countryName: string
    /** 省名 */
    province: string
    /** 区名, 次级区域名 */
    district: string
  }) => void
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string
    errorCode: string | number
    innerError: {
      errorCode: string | number
      errorMsg: string
    }
  }) => void
}): void

 👉 立即开发


原文地址:https://blog.csdn.net/Ms_Smart/article/details/136814241

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!