getLocation

getLocation là API dùng để lấy thông tin vị trí địa lí hiện tại của device.

Tham số

Thuộc tính	Kiểu dữ liệu	Bắt buộc	Mô tả
cacheTimeout	number		Thời gian mà cache toạ độ địa lý của thiết bị có hiệu lực. Đơn vị tính là giây, mặc định 30 giây. Sử dụng cache toạ độ giúp tăng tốc độ lấy location, đồng thời tiết kiệm pin.
type	number		Chọn độ chính xác: 0 - low accuracy. Sử dụng wifi để lấy location 1 - high accuracy. Sử dụng GPS để lấy location
success	Function		Callback function khi lấy thông tin location được thực hiện thành công
fail	Function		Callback function khi lấy thông tin location thất bại
complete	Function		Callback function khi việc lấy thông tin location kết thúc cho dù thành công hay thất bại

Callback success function payload

Thuộc tính	Kiểu dữ liệu	Mô tả
latitude	number	Kinh độ của thiết bị
longitude	number	Vĩ độ của thiết bị
altitude	number	Độ cao của thiết bị so với mực nước biển
accuracy	number	Độ chính xác của vị trí; tính bằng mét
altitudeAccuracy	number	Độ chính xác của độ cao; tính bằng mét
heading	number	Hướng di chuyển
speed	number	Tốc độ di chuyển; tính bằng m/s

Ví dụ

import apis from '@v-miniapp/apis'

apis.getLocation({
  cacheTimeout: 30,
  type: 1,
  success: (res) => {
    console.log("Location:", res);
  },
  fail: (e) => {
    console.log("Error:", e);
    apis.showToast({
      type: "fail",
      content: "Không thể lấy vị trí",
    });
  },
});