翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

iOS モバイル追跡 SDK

Amazon Location モバイル追跡SDKは、Amazon Location Trackers の認証、デバイス位置のキャプチャ、位置の更新の送信を容易にするユーティリティを提供します。は、設定可能な更新間隔によるロケーション更新のローカルフィルタリングSDKをサポートしています。これにより、データコストを削減し、iOS アプリケーションの断続的な接続を最適化できます。

iOS 追跡SDKは、 で利用できます GitHub。Amazon Location Mobile Tracking SDK for iOS 。

このセクションでは、Amazon Location モバイル追跡 iOS の以下のトピックについて説明しますSDK。

インストール

iOS SDKのモバイル追跡をインストールするには、次の手順に従います。

使用方法

次の手順は、Cognito の認証情報を使用して認証ヘルパーを作成する方法を示しています。

フィルター

Amazon Location モバイル追跡 iOS SDKには、3 つの組み込みロケーションフィルターがあります。

この例では、作成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 モバイル追跡には、次の機能が含まれています。

例

このセクションでは、Amazon Location Mobile Tracking SDK for iOS を使用する例について詳しく説明します。

次の例は、デバイスの位置を追跡し、追跡された位置を取得する機能を示しています。

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