Autenticación móvil de Android SDK - Amazon Location Service

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Autenticación móvil de Android SDK

Estas utilidades te ayudan a autenticarte cuando realizas API llamadas a Amazon Location Service desde tus aplicaciones de Android. Esto ayuda específicamente cuando se utilizan Amazon Cognito o APIclaves como método de autenticación.

La autenticación móvil Android SDK está disponible en github: Amazon Location Service Mobile Authentication SDK for Android. Además, tanto la autenticación móvil como SDK la AWS SDK están disponibles en el repositorio de AWS Maven.

Instalación

Para usar la autenticación móvilSDK, agrega las siguientes instrucciones de importación a tu build.gradle archivo en Android Studio.

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

Funciones de autenticación

El ayudante de autenticación SDK tiene las siguientes funciones:

  • authHelper.authenticateWithApiKey("My-Amazon-Location-API-Key"): LocationCredentialsProvider: Esta función devuelve una clave LocationCredentialsProvider inicializada para que funcione con una API clave.

  • authHelper.authenticateWithCognitoIdentityPool("My-Cognito-Identity-Pool-Id"): LocationCredentialsProvider: Esta función devuelve un conjunto de identidades LocationCredentialsProvider inicializado para que funcione con un grupo de identidades de Amazon Cognito.

Uso

Para utilizarlos SDK en su código, importe las siguientes clases:

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

Tiene dos opciones a la hora de crear las instancias de ayuda de autenticación y de proveedor de clientes de ubicación. Puede crear una instancia con APIlas claves de ubicación de Amazon o Amazon Cognito.

  • Para crear una instancia auxiliar de autenticación mediante una API clave de ubicación de Amazon, declara la clase auxiliar de la siguiente manera:

    var authHelper = AuthHelper(applicationContext) var locationCredentialsProvider : LocationCredentialsProvider = authHelper.authenticateWithApiKey("My-Amazon-Location-API-Key")
  • Para crear una instancia auxiliar de autenticación con Amazon Cognito, declare la clase auxiliar de la siguiente manera:

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

Puedes crear una instancia de cliente de Amazon Location con el proveedor de credenciales de ubicación y realizar llamadas al servicio Amazon Location. En el siguiente ejemplo, se buscan lugares cercanos a una latitud y longitud 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)