【小程序开发】位置 API 集合（二）

IoT砖家涂拉拉2024-03-25 13:32

ty.map.openGeofenceMap

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

权限: [scope.location]

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

参数

Object object

属性 类型 默认值 必填 说明
geoTitle string 否 地理围栏名称
longitude number 否 经度
latitude number 否 纬度
radius number 否 半径
geofenceId string 否 id
type number 否 半径 0:进度地理围栏 1：离开地理围栏
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

函数定义示例

复制代码 
/**
 * 打开地理围栏地图页面,获取地理围栏信息(新建或者编辑地理围栏)
 *权限: [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

属性 类型 默认值 必填 说明
latitude number 是 纬度，范围为 -90~90，负数表示南纬
longitude number 是 经度，范围为 -180~180，负数表示西经
name string 是 位置名
address string 是 地址的详细说明
mapType string 是 地图类型，目前支持：BMK：百度地图 MA：高德地图 TENCENT：腾讯地图 Google：Google 地图
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

函数定义示例

复制代码 
/**
 * 使用三方地图查看位置
 */
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

属性 类型 默认值 必填 说明
geoTitle string 否 地理围栏名称
longitude number 否 经度
latitude number 否 纬度
radius number 否 半径
geofenceId string 否 id
type number 否 半径 0:进度地理围栏 1：离开地理围栏
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

函数定义示例

复制代码 
/**
 * 注册地理围栏
 *权限: [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

属性 类型 默认值 必填 说明
geoTitle string 否 地理围栏名称
longitude number 否 经度
latitude number 否 纬度
radius number 否 半径
geofenceId string 否 id
type number 否 半径 0:进度地理围栏 1：离开地理围栏
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

函数定义示例

复制代码 
/**
 * 取消地理围栏
 *权限: [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

属性 类型 默认值 必填 说明
type string 是 wgs84 返回 gps 坐标，gcj02 返回可用于 openLocation 的坐标
latitude number 是 纬度，范围为 -90~90，负数表示南纬
longitude number 是 经度，范围为 -180~180，负数表示西经
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

object.success回调参数

参数

Object res

属性 类型 说明
latitude number 纬度，范围为 -90~90，负数表示南纬
longitude number 经度，范围为 -180~180，负数表示西经
cityName string 城市名称street
streetName string 街道名称
address string 位置名称
countryCode string 国家码
postalCode string 邮编
countryName string 国家名
province string 省名
district string 区名, 次级区域名

object.fail回调参数

参数

Object res

属性 类型 说明
errorMsg string 插件错误信息
errorCode string 错误码
innerError object 插件外部依赖错误信息 {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

👉 立即开发。

相关推荐
y东施效颦13 分钟前
uni-app页面发布测试环境出现连接服务器超时，点击屏幕重试解决方案
前端·javascript·vue.js·uni-app·vue
大熊程序猿16 分钟前
《开篇：课程目录》
前端·c#
秋田君28 分钟前
深入理解JavaScript设计模式之单例模式
javascript·单例模式·设计模式
摸鱼仙人~1 小时前
React中子传父组件通信操作指南
前端·javascript·react.js
程序员阿超的博客1 小时前
React事件处理：如何给按钮绑定onClick点击事件？
前端·javascript·react.js
甜甜的资料库1 小时前
基于微信小程序的睡眠宝系统源码数据库文档
数据库·微信小程序·小程序
前端小咸鱼一条1 小时前
Vue中渲染函数的使用
javascript·vue.js·ecmascript
沉香亭北2 小时前
vue+vite 全局主题
前端
郑州小张2 小时前
前端解析PDF文件目录以及点击目录实现对应内容预览
前端·javascript
吹牛逼专业户2 小时前
Vue中快速实现主题切换
vue.js
热门推荐
01【图像处理与机器视觉】XJTU期末考点02从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑03KGG转MP3工具|非KGM文件|解密音频04Coze扣子平台完整体验和实践（附国内和国际版对比）05YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】06【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！07R-tree详解08海康Visionmaster-常见问题排查方法-启动阶段09DeepSeek各版本说明与优缺点分析10零代码入门 | Coze——让大模型接入自己的数据库