位置

检测位置变更

SDK 钩子： useGeolocation

useGeolocation是一个返回设备位置信息的钩子。位置发生变化时，值也会变化。它利用 GPS 信息检测当前位置，并会随着用户移动自动更新。例如，可用于在地图类服务中显示用户当前位置，或在配送应用中追踪实时移动路线。它可以调整位置信息的精度和更新周期，因此既能将电量消耗降到最低，又能保持所需级别的精度。

签名

function useGeolocation({ accuracy, distanceInterval, timeInterval }: UseGeolocationOptions): Location | null;

参数

• options · 必填 · UseGeolocationOptions

  这是位置信息检测所需的设置对象。

  • options.accuracy · Accuracy

    设置位置精度。 Accuracy.Lowest：误差范围在 3KM 以内， Accuracy.Low：误差范围在 1KM 以内， Accuracy.Balanced：误差范围在几百米以内， Accuracy.High：误差范围在 10M 以内， Accuracy.Highest：最高精度， Accuracy.BestForNavigation：适用于导航的最高精度
  • options.timeInterval · number

    以更新位置信息的最小周期为单位，单位为毫秒(ms)。此值设置位置信息更新发生的最短间隔，但受系统或环境影响，实际更新间隔可能会比指定周期更长。
  • options.distanceInterval · number

    将位置变化距离设置为米(m)单位。

返回值

• Location | null

  会返回包含设备位置信息的对象。详情请参见 Location。

示例

在屏幕上显示位置信息

import React, { useState, useCallback } from 'react';
import { View, Text } from 'react-native';
import { useGeolocation, Accuracy } from '@apps-in-toss/framework';

// 检测位置变更
function LocationWatcher() {
  const location = useGeolocation({
    accuracy: Accuracy.Balanced,
    distanceInterval: 10,
    timeInterval: 1000,
  });

  if (location == null) {
    return <Text>正在获取位置信息...</Text>;
  }

  return (
    <View>
      <Text>
        位置信息：{location.latitude}, {location.longitude}
      </Text>
    </View>
  );
}

体验示例应用

apps-in-toss-examples 在仓库中 with-location-tracking 下载代码，或扫描下方二维码亲自体验。

二维码链接：intoss://with-location-tracking