設定

このページでは、Maps 3D SDK for Android を使用してビルドを開始する準備として必要な手順について説明します。セットアップ プロセスでは、SDK で使用するために Google Cloud プロジェクトと API を構成し、Android Studio プロジェクトを設定します。最初の 3D 地図をアプリに追加する前に、以下の手順を完了してください。

Google Cloud プロジェクトと API キーを設定する

Maps 3D SDK for Android で開発を開始する前に、次の手順に沿って、Maps 3D SDK for Android で使用する Google Cloud プロジェクトと API キーを設定する必要があります。

ステップ 1

Console

  1. Google Cloud コンソールの [プロジェクトの選択] ページで [新しいプロジェクト] をクリックし、新しい Cloud プロジェクトの作成を開始します。

    [プロジェクトの選択] ページに移動

  2. Cloud プロジェクトで お支払いが有効になっていることを確認します。

    Google Cloud では、無料トライアルを提供しています。トライアルは、90 日が経過するか、アカウントの費用が 300 ドルに達した時点のいずれか早い方の時点で終了します。解約はいつでも可能です。詳しくは、請求先アカウントのクレジットおよび Google Maps Platform の料金をご覧ください。

Cloud SDK

gcloud projects create "PROJECT"

詳しくは、Google Cloud SDK、Cloud SDK のインストール、および以下のコマンドをご覧ください。

ステップ 2

Google Maps Platform を使用するには、プロジェクトで使用する API または SDK を有効にする必要があります。

一部の統合では、複数の API または SDK を有効にする必要があります。有効にする API や SDK がわからない場合は、API Picker を使用するか、該当する API / SDK のドキュメントをご覧ください。

1 つ以上の API または SDK を有効にするには:

Console

  1. Cloud コンソールの Maps API ライブラリ ページにアクセスし、有効にできる Google Maps Platform の API と SDK をご確認ください。

    Maps API ライブラリ ページに移動

  2. 有効にする API または SDK をクリックします。
    • [有効にする] ボタンが表示された場合は、このボタンをクリックして、選択した API または SDK を有効にします。
    • [管理] ボタンが表示された場合、その API または SDK はすでに有効になっています。何もする必要がありません。
    • いずれかのボタンをクリックすると、選択した API または SDK のダッシュボードが表示されます（このプロジェクトから API または SDK を削除するには、[無効にする] ボタンをクリックします）。

Cloud SDK

次のコマンドを実行すると、Maps、Routes、Places のすべての API が有効になります。

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

詳しくは、Google Cloud SDK、Cloud SDK のインストール、および以下のコマンドをご覧ください。

Environment API を有効にするには、次のコマンドを使用します。

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com"

ステップ 3

このステップでは API キーを作成します。本番環境で API キーを使用する場合は、キーの使用を制限することを強くおすすめします。詳しくは、各サービスの API キーの使用ページをご覧ください。

API キーは、プロジェクトに関連付けられたリクエストを認証し、リクエストの使用回数を追跡して課金するために使われる一意の識別子です。少なくとも 1 つの API キーをプロジェクトに関連付ける必要があります。

API キーを作成するには:

コンソール

  1. [Google Maps Platform] > [認証情報] ページに移動します。

    [認証情報] ページに移動

  2. [認証情報] ページで、[認証情報を作成] > [API キー] をクリックします。
    [API キーを作成しました] ダイアログで、新しく作成された API キーが表示されます。
  3. [閉じる] をクリックします。
    新しい API キーは、[認証情報] ページの [API キー] に一覧で表示されます。
    （本番環境で使用する前に必ず API キーを制限するようにしてください）

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

詳しくは、Google Cloud SDK、Cloud SDK のインストール、および以下のコマンドをご覧ください。

SDK を有効にするには、Google Cloud コンソールの Maps 3D SDK for Android ページをご覧ください。これらの手順の詳細については、Google Maps Platform スタートガイドをご覧ください。

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

このセクションでは、Maps 3D SDK for Android で使用する Android Studio プロジェクトを作成して設定する方法について説明します。

パート 1: プロジェクトと Gradle の構成を設定する

  1. Empty Views Activity テンプレートを使用して、新しい Android Studio プロジェクトを作成します。

  2. ソース管理に Git を使用している場合は、プロジェクトの .gitignore ファイルを変更して、シークレット ファイルがバージョン管理に commit されないようにします。

    • プロジェクトのルート ディレクトリで、.gitignore ファイルを開きます。
    • 次の行を追加します。
    secrets.properties

  3. プロジェクト レベルの build.gradle.kts ファイルを更新します。

    • プロジェクトのルート ディレクトリで、build.gradle.kts ファイルを開きます。
    • plugins ブロックに Secrets Gradle プラグインを追加します。
    plugins {
  alias(libs.plugins.android.application) apply false
  alias(libs.plugins.kotlin.android) apply false
  alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
}

  4. gradle/libs.versions.toml ファイルを更新します。 - gradle/libs.versions.toml ファイルを開きます。通常、プロジェクトのルート ディレクトリ内の gradle ディレクトリにあります。 - バージョン セクションで、SDK と Secrets Gradle プラグインのバージョンを追加します。

    maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
secretsGradlePlugin = "2.0.1"

    -   In the library section, add the SDK library:

    play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }

    -   In the plugin section, add the Secrets Gradle plugin:

    secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }

  5. モジュール レベルの app/build.gradle.kts ファイルを更新します。 - モジュール レベルの build.gradle.kts ファイルを開きます。通常、app ディレクトリ内にあります。 - ファイルの上部で、Secrets Gradle プラグインを plugins ブロックに追加します。

    plugins {
  alias(libs.plugins.android.application)
  alias(libs.plugins.kotlin.android)
  alias(libs.plugins.secrets.gradle.plugin) // Add this line
}

    -   In the `dependencies` block, add the SDK:

    dependencies {
  // ... other dependencies
  implementation(libs.play.services.maps3d) // Add this line
}

    -   At the end of the file, outside of the `android` and `dependencies`
    blocks, add the secrets configuration:

    secrets {
  // Optionally specify a different filename containing your secrets.
  // The plugin defaults to "local.properties"
  propertiesFileName = "secrets.properties"

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

パート 2: API キーをプロジェクトに追加する

  1. secrets.properties ファイルを作成します。

    • アプリ モジュールのルート ディレクトリ（通常は app ディレクトリ）に、secrets.properties という名前の新しいファイルを作成します。
    • API キーをファイルに追加します。
    MAPS3D_API_KEY=YOUR_API_KEY_HERE
``` Note: Make sure you
    replace `YOUR_API_KEY_HERE` with the API key that you configured for use
with the Maps 3D SDK for Android.

  2. local.defaults.properties ファイルを作成します。 - アプリ モジュールのルート ディレクトリに、secrets.properties という名前の新しいファイルを作成します。 - デフォルトまたはプレースホルダの API キーをファイルに追加します。このファイルはバージョン管理にチェックインできます。

    MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER

パート 3: AndroidManifest.xml ファイルを更新する

  1. app/src/main/AndroidManifest.xml ファイルを開きます。

  2. <application> タグの <activity> タグの前に、次の <meta-data> 要素を追加して API キーを宣言します。

    <application
  ...>

  <meta-data
      android:name="com.google.android.geo.maps3d.API_KEY"
      android:value="${MAPS3D_API_KEY}" />

  <activity
      ...>
  </activity>
</application>

    ビルドプロセス中に、Secrets Gradle プラグインによって ${MAPS3D_API_KEY} プレースホルダが secrets.properties ファイルのキーに置き換えられます。

次のステップ

Google Cloud プロジェクト、API キー、Android Studio プロジェクトをセットアップして Maps 3D SDK for Android で使用できるようにしたので、アプリに 3D 地図を追加できます。