Android Studio プロジェクトをセットアップする

Places SDK for Android を使用するようにアプリを構成する手順は次のとおりです。Places SDK for Android を使用するすべてのアプリで必要です。

ステップ 1: Android Studio をセットアップする

Arctic Fox 以降の Android Studio が必要です。お持ちでない場合は、ダウンロードしてインストールしてください。
Android Studio で Android Gradle プラグインバージョン 7.0 以降を使用していることを確認してください。

手順 2: SDK をセットアップする

Places SDK for Android ライブラリは、Google の Maven リポジトリを通して利用できます。アプリに SDK を追加するには、以下の手順を行います。

トップレベルの settings.gradle ファイルで、pluginManagement ブロック以下に Gradle プラグインポータル、Google Maven リポジトリ、Maven セントラルリポジトリをインクルードします。pluginManagement ブロックは、スクリプト内の他のステートメントよりも前に配置する必要があります。
```
pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
} 
```
トップレベルの settings.gradle ファイルで、dependencyResolutionManagement ブロック以下に Google の Maven リポジトリと Maven セントラルリポジトリをインクルードします。
```
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
} 
```
モジュール レベルの build.gradle ファイルの dependencies セクションで、Places SDK for Android に依存関係を追加します。
```
dependencies {
    implementation 'com.google.android.libraries.places:places:3.1.0'
}
```
モジュールレベルの build.gradle ファイルで、compileSdk と minSdk を次の値に設定します。
注: compileSdk が 31 以上、minSdk が 21 以上に設定されていることを確認します。
```
android {
    compileSdk 31

    defaultConfig {
        minSdk 21
        // ...
    }
```

ステップ 3: API キーをプロジェクトに追加する

このセクションでは、アプリで安全に参照されるように API キーを保存する方法を説明します。API キーは、バージョン管理システムにはチェックインせず、プロジェクトのルートディレクトリにある local.properties ファイルに保存することをおすすめします。local.properties ファイルについて詳しくは、Gradle プロパティファイルをご覧ください。

このタスクを効率化するには、Android 用 Secrets Gradle プラグインを使用します。プラグインをインストールして API キーを保存するには:

Android Studio でプロジェクトレベルの build.gradle ファイルを開き、buildscript の配下にある dependencies 要素に次のコードを追加します。
```
plugins {
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
}
```
次に、モジュールレベルの build.gradle ファイルを開き、次のコードを plugins 要素に追加します。
```
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
    
```
ファイルを保存して、プロジェクトを Gradle と同期します。
プロジェクトレベルのディレクトリで local.properties を開き、次のコードを追加します。YOUR_API_KEY は、API キーに置き換えます。
```
MAPS_API_KEY=YOUR_API_KEY
    
```
ファイルを保存します。
AndroidManifest.xml ファイルで com.google.android.geo.API_KEY に移動し、android:value attribute を次のように更新します。
```
<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${MAPS_API_KEY}" />
    
```

注: 上記のように、com.google.android.geo.API_KEY は、API キーとして推奨されるメタデータ名です。この名前のキーは、Places SDK for Android など、Android プラットフォーム上の複数の Google マップベースの API の認証に使用できます。下位互換性を確保するため、API では com.google.android.maps.v2.API_KEY という名前もサポートされています。この従来の名前は、Android Maps API v2 の認証にのみ使用できます。アプリでは、API キーのメタデータ名を 1 つのみ指定できます。両方を指定すると、API から例外がスローされます。

手順 4. Places API クライアントを初期化する

次の例に示すように、アクティビティまたはフラグメント内で Places SDK for Android を初期化します（Places.initialize() を呼び出すときに API キーを渡します）。

Java


    // Initialize the SDK
    Places.initialize(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);

Kotlin


    // Initialize the SDK
    Places.initialize(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)

これで、Places SDK for Android を使用できるようになりました。

ステップ 5: Android デバイスをセットアップする

Places SDK for Android を使用するアプリを実行するには、Android 4.0 以降をベースとし Google API を含む Android デバイスまたは Android Emulator にアプリをデプロイする必要があります。

Android デバイスを使用する場合は、ハードウェアデバイス上でのアプリの実行の手順を踏んでください。
Android Emulator を使用する場合は、Android Studio に付属している Android Virtual Device（AVD）Manager を使用して仮想デバイスを作成し、エミュレータをインストールしてください。
注: Android Emulator を使用する場合は、必ず [Play ストア] 列に再生アイコン が表示されているデバイスを選択してください。このアイコンは、プロファイルが CTS に完全に対応しており、Play ストアアプリを含むシステムイメージを使用できることを示しています。

次のステップ

プロジェクトの構成が完了したら、サンプルアプリを試すことができます。