本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

iOS 移动设备追踪 SDK

Amazon Location 移动追踪SDK提供实用工具，可帮助轻松进行身份验证、捕获设备位置以及向亚马逊位置追踪器发送位置更新。SDK支持使用可配置的更新间隔对位置更新进行本地筛选。这可以降低数据成本，并优化 iOS 应用程序的间歇性连接。

iOS 追踪功能SDK可在以下网址获得 GitHub：iOS 版亚马逊定位移动追踪SDK。

本节涵盖了 Amazon Location 移动追踪 iOS 的以下主题SDK：

安装

使用以下步骤安装 iOS 版移动SDK追踪功能：

使用量

以下过程向您展示如何使用来自 Cognito 的凭据创建身份验证助手。

筛选条件

Amazon Location 移动追踪 iOS SDK 有三个内置的位置过滤器。

此示例在创建时LocationTracker在中添加过滤器：

val config = LocationTrackerConfig(
    trackerName = "MY-TRACKER-NAME",
    logLevel = TrackingSdkLogLevel.DEBUG,
    accuracy = Priority.PRIORITY_HIGH_ACCURACY,
    latency = 1000,
    frequency = 5000,
    waitForAccurateLocation = false,
    minUpdateIntervalMillis = 5000,
    locationFilters = mutableListOf(TimeLocationFilter(), DistanceLocationFilter(), AccuracyLocationFilter())
)

locationTracker = LocationTracker(
    applicationContext,
    locationCredentialsProvider,
    config,
)

此示例使用以下命令在运行时启用和禁用过滤器：LocationTracker

// To enable the filter
locationTracker?.enableFilter(TimeLocationFilter())

// To disable the filter
locationTracker?.disableFilter(TimeLocationFilter())

iOS 手机SDK追踪功能

iOS 版的 Amazon L SDK ocation 移动追踪包括以下功能：

示例

本节详细介绍了使用适用SDK于 iOS 的 Amazon 定位移动追踪的示例。

以下示例演示了跟踪设备位置和检索追踪位置的功能：

Privacy - Location When In Use Usage Description
Privacy - Location Always and When In Use Usage Description

开始追踪地点：

do {
    try locationTracker.startTracking()
    } 
catch TrackingLocationError.permissionDenied {
        // Handle permissionDenied by showing the alert message or opening the app settings
        }

继续追踪地点：

do { 
    try locationTracker.resumeTracking()
    } 
catch TrackingLocationError.permissionDenied {
    // Handle permissionDenied by showing the alert message or opening the app settings
    }

停止追踪地点：

locationTracker.stopTracking()

开始后台跟踪：

do {
    locationTracker.startBackgroundTracking(mode: .Active) // .Active, .BatterySaving, .None
    } 
catch TrackingLocationError.permissionDenied {
   // Handle permissionDenied by showing the alert message or opening the app settings
   }

恢复背景跟踪：

do {
    locationTracker.resumeBackgroundTracking(mode: .Active)
    } 
catch TrackingLocationError.permissionDenied {
    // Handle permissionDenied by showing the alert message or opening the app settings
    }

要停止背景跟踪，请执行以下操作：

locationTracker.stopBackgroundTracking()

从追踪器中检索设备的追踪位置：

func getTrackingPoints(nextToken: String? = nil) {
let startTime: Date = Date().addingTimeInterval(-86400) // Yesterday's day date and time
let endTime: Date = Date() 
locationTracker.getTrackerDeviceLocation(nextToken: nextToken, startTime: startTime, endTime: endTime, completion: { [weak self] result in
    switch result {
    case .success(let response):
        
        let positions = response.devicePositions
        // You can draw positions on map or use it further as per your requirement

        // If nextToken is available, recursively call to get more data
        if let nextToken = response.nextToken {
            self?.getTrackingPoints(nextToken: nextToken)
        }
    case .failure(let error):
        print(error)
    }
})
}