Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Authentification mobile Android SDK
Ces utilitaires vous aident à vous authentifier lorsque vous passez des API appels Amazon Location Service depuis vos applications Android. Cela est particulièrement utile lorsque vous utilisez Amazon Cognito ou des APIclés comme méthode d'authentification.
L'authentification mobile Android SDK est disponible sur github : Amazon Location Service Mobile Authentication SDK pour Android
Installation
Pour utiliser l'authentification mobileSDK, ajoutez les instructions d'importation suivantes à votre build.gradle
fichier dans Android Studio.
implementation("software.amazon.location:auth:0.0.1") implementation("com.amazonaws:aws-android-sdk-location:2.72.0")
Fonctions d'authentification
L'assistant d'authentification SDK possède les fonctions suivantes :
authHelper.authenticateWithApiKey("My-Amazon-Location-API-Key"): LocationCredentialsProvider
: Cette fonction renvoie une valeurLocationCredentialsProvider
initialisée pour fonctionner avec une API clé.authHelper.authenticateWithCognitoIdentityPool("My-Cognito-Identity-Pool-Id"): LocationCredentialsProvider
: Cette fonction renvoie une valeurLocationCredentialsProvider
initialisée pour fonctionner avec un pool d'identités Amazon Cognito.
Utilisation
Pour utiliser le SDK dans votre code, importez les classes suivantes :
import com.amazonaws.services.geo.AmazonLocationClient import software.amazon.location.auth.AuthHelper import software.amazon.location.auth.LocationCredentialsProvider
Deux options s'offrent à vous lorsque vous créez l'assistant d'authentification et les instances du fournisseur de clients de localisation. Vous pouvez créer une instance à l'aide des APIclés de localisation Amazon ou d'Amazon Cognito.
-
Pour créer une instance d'assistance à l'authentification à l'aide d'une API clé de localisation Amazon, déclarez la classe d'assistance comme suit :
var authHelper = AuthHelper(applicationContext) var locationCredentialsProvider : LocationCredentialsProvider = authHelper.authenticateWithApiKey("
My-Amazon-Location-API-Key
") -
Pour créer une instance d'assistance à l'authentification à l'aide d'Amazon Cognito, déclarez la classe d'assistance comme suit :
var authHelper = AuthHelper(applicationContext) var locationCredentialsProvider : LocationCredentialsProvider = authHelper.authenticateWithCognitoIdentityPool("
My-Cognito-Identity-Pool-Id
")
Vous pouvez créer une instance client Amazon Location à l'aide du fournisseur d'informations de localisation et passer des appels au service Amazon Location. L'exemple suivant recherche des lieux proches d'une latitude et d'une longitude spécifiées.
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)