本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

iOS Mobile Tracking SDK

Amazon Location 行動追蹤SDK提供公用程式，可協助輕鬆驗證、擷取裝置位置，以及傳送位置更新至 Amazon Location Trackers。SDK 支援以可設定的更新間隔對位置更新進行本機篩選。這可降低資料成本，並最佳化 iOS 應用程式的間歇性連線。

iOS 追蹤SDK可在 上取得 GitHub：適用於 iOS SDK的 Amazon Location Mobile Tracking。

本節涵蓋 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 Mobile SDK追蹤函數

適用於 iOS SDK的 Amazon Location 行動追蹤包含下列功能：

範例

本節詳細說明使用 iOS SDK版 Amazon Location Mobile Tracking 的範例。

下列範例示範追蹤裝置位置和擷取追蹤位置的功能：

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)
    }
})
}