As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Rastreamento móvel iOS SDK

O rastreamento móvel de localização da Amazon SDK fornece utilitários que ajudam a autenticar, capturar posições de dispositivos e enviar atualizações de posição para os Amazon Location Trackers com facilidade. O SDK suporta a filtragem local de atualizações de localização com intervalos de atualização configuráveis. Isso reduz os custos de dados e otimiza a conectividade intermitente para seus aplicativos iOS.

O rastreamento do iOS SDK está disponível em GitHub: Amazon Location Mobile Tracking SDK para iOS.

Esta seção aborda os seguintes tópicos para o rastreamento móvel de localização da Amazon para iOSSDK:

Instalação

Use o procedimento a seguir para instalar o rastreamento móvel SDK para iOS:

Uso

O procedimento a seguir mostra como criar um auxiliar de autenticação usando credenciais do Cognito.

Filtros

O rastreamento móvel de localização da Amazon para iOS SDK tem três filtros de localização embutidos.

Este exemplo adiciona filtros no LocationTracker momento da criação:

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

Este exemplo ativa e desativa o filtro em tempo de execução comLocationTracker:

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

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

Funções de SDK rastreamento de dispositivos móveis para iOS

O rastreamento móvel de localização da Amazon SDK para iOS inclui as seguintes funções:

Exemplos

Esta seção detalha exemplos de uso do Amazon Location Mobile Tracking SDK para iOS.

O exemplo a seguir demonstra a funcionalidade para rastrear a localização do dispositivo e recuperar os locais rastreados:

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

Comece a rastrear a localização:

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

Continue rastreando a localização:

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

Pare de rastrear a localização:

locationTracker.stopTracking()

Inicie o rastreamento em segundo plano:

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

Retomar o rastreamento em segundo plano:

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

Para interromper o rastreamento em segundo plano:

locationTracker.stopBackgroundTracking()

Recupere os locais rastreados do dispositivo a partir do rastreador:

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