FinClip为企业提供小程序生态圈技术产品,开发者可在FinClip小程序开发帮助中心找到相关FinClip小程序指引

# 位置

# openLocation

iOS需依赖扩展SDK或MapSDK,如果同时依赖了扩展SDK和MapSDK,则优先使用MapSDK提供的openLocation。

Android需依赖MapSDK(暂不支持谷歌方案)

openLocation(Object object)

使用内置地图查看位置

参数

Object object

属性 类型 默认值 必填 说明
latitude number 纬度,范围为-90~90,负数表示南纬。使用 gcj02 国测局坐标系
longitude number 经度,范围为-180~180,负数表示西经。使用 gcj02 国测局坐标系
scale number 16 缩放比例,范围5~18
name string 位置名
address string 地址的详细说明
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

ft.getLocation({
 type: 'gcj02', //返回可以用于wx.openLocation的经纬度
 success (res) {
   const latitude = res.latitude
   const longitude = res.longitude
   ft.openLocation({
     latitude,
     longitude,
     scale: 18
   })
 }
})

注意

  • 接口授权失败(iOS):
  1. 用户拒绝授权,会返回错误信息: unauthorized,用户未授予位置权限
  2. 宿主App禁止小程序主动申请权限,会返回错误信息:unauthorized disableauthorized,SDK被禁止申请位置权限
  • 接口授权失败(Android):
  1. 用户拒绝授权,则地图View定位到默认位置,后续可手动搜索、选择位置

# getLocation

基础库1.3.9开始支持,iOS版本2.1.23

iOS需依赖扩展SDK

Android需依赖扩展SDK或MapSDK,如果同时依赖了扩展SDK和MapSDK,则优先使用MapSDK提供的getLocation。

Android使用扩展SDK如果碰到定位慢、定位成功率不满足需求的情况,可以集成MapSDK,使用第三方定位SDK(高德、百度、谷歌)提供的定位能力,否则建议使用扩展SDK提供的getLocation。

getLocation(Object object)

获取当前的地理位置等信息。当用户离开小程序后,此接口无法调用。

参数

Object object

属性 类型 默认值 必填 说明
type string gcj02 目前不管该参数如何,都会返回gcj02坐标。

注意:Android不支持此属性。
Android如果使用的是扩展SDK提供的getLocation,则返回gcj02。
如果使用的是MapSDK提供的getLocation,高德与百度国内地区返回gcj02,国外地区返回wgs84,谷歌国内外均返回wgs84。
实际返回值请以success回调函数type属性值为准。并做好坐标转换处理。
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

注意

  • 接口授权失败(iOS):
  1. 用户拒绝授权,会返回错误信息: unauthorized,用户未授予位置权限
  2. 宿主App禁止小程序主动申请权限,会返回错误信息:unauthorized disableauthorized,SDK被禁止申请位置权限
  • 接口授权失败(Android):
  1. 用户拒绝授权,会返回错误信息:unauthorized 用户未授予获取位置信息权限
  2. 宿主App禁止小程序主动申请权限,会返回错误信息:unauthorized disableauthorized SDK被禁止了主动发起权限申请

# choosePoi

iOS需依赖扩展SDK

Android需依赖MapSDK(暂不支持谷歌方案)

choosePoi(Object object)

打开POI列表选择位置,支持模糊定位(精确到市)和精确定位混选。

参数

Object object

属性 类型 默认值 必填 说明
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性 类型 说明
type number 选择不显示位置时,值为0,选择城市时,值为 1,选择精确位置时,值为 2
city string 城市名称
name string 位置名称
address string 详细地址
latitude string 纬度,浮点数,范围为-90~90,负数表示南纬。使用 gcj02 国测局坐标系
longitude string 经度,浮点数,范围为-180~180,负数表示西经。使用 gcj02 国测局坐标系

注意

  • 接口授权失败(iOS):
  1. 用户拒绝授权,会返回错误信息: unauthorized,用户未授予位置权限
  2. 宿主App禁止小程序主动申请权限,会返回错误信息:unauthorized disableauthorized,SDK被禁止申请位置权限
  • 接口授权失败(Android):
  1. 用户拒绝授权,则地图View定位到默认位置,后续可手动搜索、选择位置

# chooseLocation

基础库1.3.9开始支持,iOS版本2.1.23

iOS需依赖扩展SDK或MapSDK,如果同时依赖了扩展SDK和MapSDK,则优先使用MapSDK提供的openLocation。

Android需依赖MapSDK(暂不支持谷歌方案)

chooseLocation(Object object)

打开地图选择位置。

参数

Object object

属性 类型 默认值 必填 说明
latitude number 目标地纬度
longitude number 目标地经度
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性 类型 说明
name string 位置名称
address string 详细地址
latitude string 纬度,浮点数,范围为-90~90,负数表示南纬。使用 gcj02 国测局坐标系
longitude string 经度,浮点数,范围为-180~180,负数表示西经。使用 gcj02 国测局坐标系

注意

  • 接口授权失败(iOS):
  1. 用户拒绝授权,会返回错误信息: unauthorized,用户未授予位置权限
  2. 宿主App禁止小程序主动申请权限,会返回错误信息:unauthorized disableauthorized,SDK被禁止申请位置权限
  • 接口授权失败(Android):
  1. 用户拒绝授权,则地图View定位到默认位置,后续可手动搜索、选择位置
© 2022 FinClip with ❤

👋🏻 嘿,你好!

「FinClip」是一套基于云原生框架设计的小程序容器。能够让任何移动应用在集成小程序SDK之后,获得可用、安全的小程序运行能力。

>> 点我免费注册体验

查看产品文档
了解与 FinClip 相关的一切信息

产品博客 👈  了解产品更新与核心功能介绍
资源下载 👈  获取小程序 SDK 与开发工具
文档中心 👈  查询 FinClip 小程序开发指南与答疑

商务咨询热线
预约 FinClip 产品介绍,咨询商务报价或私有化部署事宜

0755-86967467

获取产品帮助
联系 FinClip 技术顾问,获取产品资料或加入开发者社群

联系线上
人工客服

或 👉  点击这里,提交咨询工单