# 位置

# openLocation

openLocation(Object object)

使用内置地图查看位置

参数

Object object

属性 类型 默认值 必填 说明
latitude number 纬度,范围为-90~90,负数表示南纬。使用 gcj02 国测局坐标系
longitude number 经度,范围为-180~180,负数表示西经。使用 gcj02 国测局坐标系
scale number 18 缩放比例,范围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
   })
 }
})

# getLocation

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

getLocation(Object object)

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

参数

Object object

属性 类型 默认值 必填 说明
type string gcj02 目前不管该参数如何,都会返回gcj02坐标。
altitude boolean false 传入 true 会返回高度信息,由于获取高度需要较高精确度,会减慢接口返回速度
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

注意

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

# chooseLocation

基础库1.3.9开始支持,iOS版本2.1.23,Android版本2.1.38, 依赖扩展 SDK

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定位到默认位置,后续可手动搜索、选择位置
© 2021 凡泰极客
  • 免费试用
  • 编组
  • 编组 2