Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

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

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

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

このドキュメントでは、Android Studio Hedgehog と Android Gradle プラグインバージョン 8.2 を使用した開発環境について説明します。

ステップ 2. SDK をセットアップする

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

最上位レベルの settings.gradle.kts ファイルで、 Gradle プラグインポータル、 Google Maven リポジトリ、および Maven 中央リポジトリを pluginManagement ブロック以下に含めます。pluginManagement ブロックは、スクリプト内の他のステートメントよりも前に配置する必要があります。
```
pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
} 
```

最上位レベルの settings.gradle.kts ファイルで、 Google の Maven リポジトリと Maven 中央リポジトリを dependencyResolutionManagement ブロック以下に含めます:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
    }
}

dependencies **モジュール** レベルの build.gradle.kts ファイルのセクションに、Places SDK for Android への依存関係を追加します。

注: Places SDK for Android バージョン 3.5.0 には kotlin-bom 1.8.0 以降が必要です。 kotlin-bom 依存関係について詳しくは、推移的依存関係での最新の kotlin-stdlib バージョンの使用をご覧ください。
Groovy
```
dependencies {
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation("com.google.android.libraries.places:places:3.5.0")
}
```
Kotlin
```
          dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:6.0.2")
}
```

モジュールレベルの build.gradle.kts ファイルで、compileSdk と minSdk をそれぞれ次の値に設定します:

注: compileSdk は 34 以上、minSdk は 23 以上に設定するようにします。

Groovy

android {
    compileSdk 34

    defaultConfig {
        minSdk 23
        // ...
    }
}

Kotlin

android {
    compileSdk = 34

    defaultConfig {
        minSdk = 23
        // ...
    }
}

モジュールレベルの build.gradle ファイルの buildFeatures セクションに BuildConfig クラスを追加します。このクラスを使用すると、この手順で後ほど定義するメタデータの値にアクセスできます。
Groovy
```
android {
  // ...
  buildFeatures {
    buildConfig true
    // ...
  }
}
```
Kotlin
```
android {
  // ...
  buildFeatures {
    buildConfig = true
    // ...
  }
}
```

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

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

このタスクを簡単にするには、Android 用 Secrets Gradle プラグインの使用をおすすめします。

Android 用 Secrets Gradle プラグインをインストールして API キーを保存する手順は次のとおりです。

Android Studio で最上位レベルの build.gradle.kts または build.gradle ファイルを開き、 plugins ブロックに次のコードを追加します。

Kotlin

plugins {
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") version "2.0.1" apply false
}

Groovy

plugins {
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
}

モジュールレベルの build.gradle.kts または build.gradle ファイルを開き、次のコードを plugins 要素に追加します。

Kotlin

plugins {
    id("com.android.application")
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
}

Groovy

plugins {
    id 'com.android.application'
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
}

Android Studio を使用している場合は、プロジェクトを Gradle と同期します。
最上位レベルのディレクトリで secrets.properties ファイルを開き、次のコードを追加します。YOUR_API_KEY を API キーに置き換えます。API キーをバージョン管理にチェックインしないように、secrets.properties を .gitignore ファイルに追加します（または、バージョン管理システムから除外します）。
注: secrets.properties ファイルが存在しない場合は、local.properties ファイルと同じフォルダに作成します。
```
PLACES_API_KEY=YOUR_API_KEY
```
最上位レベルのディレクトリ（secrets.properties ファイルと同じフォルダ）に local.defaults.properties ファイルを作成し、次のコードを追加します。

注: コードは表示されているとおりに入力してください。`DEFAULT_API_KEY` を API キーに置き換えないでください。
DEFAULT_API_KEY
```
PLACES_API_KEY=DEFAULT_API_KEY
```
このファイルの目的は、API キーのバックアップ場所を提供し、secrets.properties ファイルがない場合にビルドが失敗しないようにすることです。この状況は、secrets.properties を省略したバージョン管理システムからアプリのクローンを作成し、API キーを提供するために secrets.properties ファイルをまだローカルに作成していない場合に発生する可能性があります。

Android Studio でモジュールレベルの build.gradle.kts または build.gradle ファイルを開き、secrets プロパティを編集します。secrets プロパティが存在しない場合は、追加します。

プラグインのプロパティを編集して、propertiesFileName を "secrets.properties" に、 defaultPropertiesFileName を "local.defaults.properties" に設定し、他のプロパティを設定します。

Kotlin

secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the root directory (the same folder as the root local.properties file).
    // 2. Add this line, where YOUR_API_KEY is your API key:
    //        MAPS_API_KEY=YOUR_API_KEY
    propertiesFileName = "secrets.properties"

    // A properties file containing default secret values. This file can be
    // checked in version control.
    defaultPropertiesFileName = "local.defaults.properties"
}

Groovy

secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the root directory (the same folder as the root local.properties file).
    // 2. Add this line, where YOUR_API_KEY is your API key:
    //        MAPS_API_KEY=YOUR_API_KEY
    propertiesFileName = "secrets.properties"

    // A properties file containing default secret values. This file can be
    // checked in version control.
    defaultPropertiesFileName = "local.defaults.properties"
}

ステップ 4. Places API クライアントを初期化する

アクティビティまたはフラグメント内で Places SDK for Android を初期化するには、 Places.initializeWithNewPlacesApiEnabled() を呼び出すときに API キーを渡します。

Kotlin

    // Define a variable to hold the Places API key.
    val apiKey = BuildConfig.PLACES_API_KEY

    // Log an error if apiKey is not set.
    if (apiKey.isEmpty() || apiKey == "DEFAULT_API_KEY") {
        Log.e("Places test", "No api key")
        finish()
        return
    }

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

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

Java

    // Define a variable to hold the Places API key.
    String apiKey = BuildConfig.PLACES_API_KEY;

    // Log an error if apiKey is not set.
    if (TextUtils.isEmpty(apiKey) || apiKey.equals("DEFAULT_API_KEY")) {
      Log.e("Places test", "No api key");
      finish();
      return;
    }

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

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

これで、Places SDK for Android の使用を開始する準備ができました。

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

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

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

次のステップ

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

Android Studio プロジェクトをセットアップする コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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

ステップ 2. SDK をセットアップする

Groovy

Kotlin

Groovy

Kotlin

Groovy

Kotlin

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

Kotlin

Groovy

Kotlin

Groovy

Kotlin

Groovy

ステップ 4. Places API クライアントを初期化する

Kotlin

Java

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

次のステップ

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