getLocation(params: Object)

版本要求:
MapKit≥1.0.6@ray-js/ray≥1.2.10
支持平台:
iOSAndroid
import { map } from '@ray-js/ray';

const { getLocation } = map;

// Promise 调用
try {
  const res = await getLocation({ ...params });
  console.log(res);
} catch (err) {
  console.log(err.errorMsg);
}

描述

获取当前地理位置和速度

参数

属性类型必填说明
typestring是wgs84返回GPS坐标，gcj02返回可用于openLocation的坐标
altitudeboolean是传入true会返回高度信息。由于获取高度需要较高精度，会减慢接口响应速度。
isHighAccuracyboolean是开启高精度定位
highAccuracyExpireTimenumber是高精度定位超时时间(ms)。指定时间内返回最高精度，该值3000ms以上高精度定位才有效果。
complete() => void否接口调用结束的回调函数（调用成功、失败都会执行）
success(params: Object) => void否接口调用成功的回调函数
fail(params: Object) => void否接口调用失败的回调函数
success 回调参数
属性类型说明MapKit 最低版本
latitudenumber纬度，范围 -90~90，负数表示南纬v3.0.5
longitudenumber经度，范围 -180~180，负数表示西经v3.0.5
speednumber速度，单位 m/sv3.0.5
accuracynumber定位精度v3.0.5
altitudenumber海拔，单位 mv3.0.5
verticalAccuracynumber垂直精度，单位 m（Android无法获取，返回0）v3.0.5
horizontalAccuracynumber水平精度，单位 mv3.0.5
cityNamestring城市名称v3.0.5
streetNamestring街道名称v3.0.5
addressstring位置名称，历史上iOS返回Array类型，建议使用formatAddress字段v3.0.5
formatAddressstring格式化地址v3.6.0
countryCodestring国家代码v3.1.0
postalCodestring邮政编码v3.1.0
countryNamestring国家名称v3.1.1
provincestring省份名称v3.1.1
districtstring区县名称，二级区域名称v3.1.1
fail 回调参数
属性类型说明
errorMsgstring错误信息
errorCodestring | number错误码
错误扩展

返回值

无

示例代码

import { map } from '@ray-js/ray'

map.getLocation({
  type: "gcj02",
  altitude: false,
  isHighAccuracy: false,
  highAccuracyExpireTime: 3000,
  success: data => {
    console.log(data);
  },
  fail: error => {
    console.error(error);
  },
});