기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

iOS 모바일 추적 SDK

Amazon Location 모바일 추적은 쉽게 인증하고 디바이스 위치를 캡처하고 Amazon Location Tracker에 위치 업데이트를 전송하는 데 도움이 되는 유틸리티를 SDK 제공합니다. 는 구성 가능한 업데이트 간격을 사용하여 위치 업데이트의 로컬 필터링을 SDK 지원합니다. 이렇게 하면 데이터 비용이 절감되고 iOS 애플리케이션의 간헐적 연결이 최적화됩니다.

iOS 추적SDK은 iOS용 GitHubAmazon Location Mobile Tracking 에서 사용할 수 있습니다. SDK

이 섹션에서는 Amazon Location 모바일 추적 iOS 에 대한 다음 주제를 다룹니다SDK.

설치

다음 절차에 따라 iOSSDK용 모바일 추적을 설치합니다.

사용량

다음 절차에서는 Cognito의 자격 증명을 사용하여 인증 도우미를 생성하는 방법을 보여줍니다.

필터

Amazon Location 모바일 추적 iOS에는 3개의 내장 위치 필터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 추적 함수

iOSSDK용 Amazon Location 모바일 추적에는 다음 함수가 포함됩니다.

예시

이 섹션에서는 iOSSDK용 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)
    }
})
}