Authentification mobile iOS 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 iOS SDK

Ces utilitaires vous aident à vous authentifier lorsque vous passez des API appels Amazon Location Service depuis vos applications iOS. Cela est particulièrement utile lorsque vous utilisez Amazon Cognito ou des APIclés comme méthode d'authentification.

L'authentification mobile iOS SDK est disponible sur github : Amazon Location Service Mobile Authentication SDK pour iOS.

Installation

Installez-le SDK dans un projet Xcode :

  1. Accédez à Fichier, puis sélectionnez Ajouter des dépendances de package dans votre XCode projet.

  2. Tapez le package URL : https://github.com/aws-geospatial/amazon-location-mobile-auth-sdk-ios/ dans la barre de recherche et appuyez sur la touche Entrée.

  3. Sélectionnez le amazon-location-mobile-auth-sdk-ios package et appuyez sur Ajouter un package.

  4. Sélectionnez le produit AmazonLocationiOSAuthSDK du package et appuyez sur Ajouter un package.

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 l'authentification mobileSDK, ajoutez les instructions suivantes à votre activité :

import AmazonLocationiOSAuthSDK
import AWSLocationXCF

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 :

    let authHelper = AuthHelper()
let locationCredentialsProvider = authHelper.authenticateWithAPIKey(apiKey: "My-Amazon-Location-API-Key", region: "account-region")

  • Pour créer une instance d'assistance à l'authentification à l'aide d'Amazon Cognito, déclarez la classe d'assistance comme suit :

    let authHelper = AuthHelper()
let locationCredentialsProvider = authHelper.authenticateWithCognitoUserPool(identityPoolId: "My-Amazon-Location-API-Key", region: "account-region")

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.

let locationClient = AWSLocation.default()
let searchPlaceIndexForPositionRequest = AWSLocationSearchPlaceIndexForPositionRequest()!
searchPlaceIndexForPositionRequest.indexName = "My-Place-Index-Name"
searchPlaceIndexForPositionRequest.position = [30.405423, -97.718833]
let nearbyPlaces = locationClient.searchPlaceIndex(forPosition: searchPlaceIndexForPositionRequest)