Authentification mobile Android SDK - Amazon Location Service
InstallationFonctions d'authentificationUtilisation

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. De plus, l'authentification mobile SDK et l'authentification AWS SDK sont disponibles dans le référentiel AWS Maven.

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 valeur LocationCredentialsProvider initialisée pour fonctionner avec une API clé.

  • authHelper.authenticateWithCognitoIdentityPool("My-Cognito-Identity-Pool-Id"): LocationCredentialsProvider: Cette fonction renvoie une valeur LocationCredentialsProvider 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)