Android モバイル認証 SDK - Amazon Location Service
インストール認証関数使用方法

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Android モバイル認証 SDK

これらのユーティリティは、Android アプリケーションから Amazon Location Service APIを呼び出すときに認証するのに役立ちます。これは、Amazon Cognito または APIキーを認証方法として使用する場合に特に役立ちます。

Android モバイル認証SDKは、github: Amazon Location Service Mobile Authentication SDK for Android で利用できます。さらに、モバイル認証SDKと AWS SDK の両方が AWS Maven リポジトリ で利用できます。

インストール

モバイル認証 を使用するにはSDK、Android Studio のbuild.gradleファイルに次のインポートステートメントを追加します。

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

認証関数

認証ヘルパーSDKには次の関数があります。

  • authHelper.authenticateWithApiKey("My-Amazon-Location-API-Key"): LocationCredentialsProvider: この関数は、APIキーを操作するためにLocationCredentialsProvider初期化された を返します。

  • authHelper.authenticateWithCognitoIdentityPool("My-Cognito-Identity-Pool-Id"): LocationCredentialsProvider: この関数は、Amazon Cognito ID プールを操作するためにLocationCredentialsProvider初期化された を返します。

使用方法

コードSDKで を使用するには、次のクラスをインポートします。

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

認証ヘルパーとロケーションクライアントプロバイダーインスタンスを作成するときは、2 つのオプションがあります。Amazon Location APIキーまたは Amazon Cognitoを使用してインスタンスを作成できます。

  • Amazon Location API Key を使用して認証ヘルパーインスタンスを作成するには、ヘルパークラスを次のように宣言します。

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

  • Amazon Cognito を使用して認証ヘルパーインスタンスを作成するには、ヘルパークラスを次のように宣言します。

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

Amazon Location クライアントインスタンスは、ロケーション認証情報プロバイダーを使用して作成し、Amazon Location サービスに電話をかけることができます。次の例では、指定された緯度と経度に近い場所を検索します。

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)