Autenticação móvel Android SDK - Amazon Location Service
InstalaçãoFunções de autenticaçãoUso

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á.

Autenticação móvel Android SDK

Esses utilitários ajudam você a se autenticar ao fazer API chamadas do Amazon Location Service a partir de seus aplicativos Android. Isso ajuda especificamente ao usar o Amazon Cognito ou APIas chaves como método de autenticação.

A autenticação móvel Android SDK está disponível no github: Amazon Location Service Mobile Authentication SDK para Android. Além disso, tanto a autenticação móvel SDK quanto a AWS SDK estão disponíveis no repositório AWS Maven.

Instalação

Para usar a autenticação móvelSDK, adicione as seguintes instruções de importação ao seu build.gradle arquivo no Android Studio. 

implementation("software.amazon.location:auth:0.0.1")
implementation("com.amazonaws:aws-android-sdk-location:2.72.0")

Funções de autenticação

O auxiliar de autenticação SDK tem as seguintes funções:

  • authHelper.authenticateWithApiKey("My-Amazon-Location-API-Key"): LocationCredentialsProvider: Essa função retorna um LocationCredentialsProvider inicializado para funcionar com uma API chave.

  • authHelper.authenticateWithCognitoIdentityPool("My-Cognito-Identity-Pool-Id"): LocationCredentialsProvider: Essa função retorna um LocationCredentialsProvider inicializado para funcionar com um pool de identidades do Amazon Cognito.

Uso

Para usar o SDK em seu código, importe as seguintes classes:

import com.amazonaws.services.geo.AmazonLocationClient
import software.amazon.location.auth.AuthHelper
import software.amazon.location.auth.LocationCredentialsProvider

Você tem duas opções ao criar as instâncias do auxiliar de autenticação e do provedor do cliente de localização. Você pode criar uma instância usando APIas chaves de localização da Amazon ou o Amazon Cognito.

  • Para criar uma instância auxiliar de autenticação usando uma API chave de localização da Amazon, declare a classe auxiliar da seguinte forma:

    var authHelper = AuthHelper(applicationContext)
var locationCredentialsProvider : LocationCredentialsProvider = authHelper.authenticateWithApiKey("My-Amazon-Location-API-Key")

  • Para criar uma instância auxiliar de autenticação usando o Amazon Cognito, declare a classe auxiliar da seguinte forma:

    var authHelper = AuthHelper(applicationContext)
var locationCredentialsProvider : LocationCredentialsProvider = authHelper.authenticateWithCognitoIdentityPool("My-Cognito-Identity-Pool-Id")

Você pode criar uma instância do cliente Amazon Location usando o provedor de credenciais de localização e fazer chamadas para o serviço Amazon Location. O exemplo a seguir pesquisa lugares próximos a uma latitude e longitude especificadas.

var locationClient = authHelper.getLocationClient(locationCredentialsProvider.getCredentialsProvider())
var searchPlaceIndexForPositionRequest = SearchPlaceIndexForPositionRequest().withIndexName("My-Place-Index-Name").withPosition(arrayListOf(30.405423, -97.718833))
var nearbyPlaces = locationClient.searchPlaceIndexForPosition(searchPlaceIndexForPositionRequest)