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

設定

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

前提条件

Maps 3D SDK for Android を使用するには、プロジェクトと対象デバイスが次の要件を満たしている必要があります。

最小 API レベル: Android API レベル 24（Android 7.0）以降。アプリは 24 以上の minSdk をターゲットにする必要があります。
Google Play 開発者サービス: Maps 3D SDK for Android は Google Play 開発者サービスに依存しています。対象デバイス（および Google API を搭載したエミュレータ）には、Google Play 開発者サービスがインストールされている必要があります。

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

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

ステップ 1

Console

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

[プロジェクトの選択] ページに移動
Cloud プロジェクトでお支払いが有効になっていることを確認します。

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

Cloud SDK

gcloud projects create "PROJECT"

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

gcloud projects create

ステップ 2

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

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

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

Console

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

Maps API ライブラリページに移動
有効にする 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" \
    "weather.googleapis.com"

ステップ 3

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

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

API キーを作成するには:

コンソール

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

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

Cloud SDK

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

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

gcloud services api-keys create

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

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

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

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

Empty Views Activity テンプレートを使用して、新しい Android Studio プロジェクトを作成します。プロジェクト構成で、[Minimum SDK] を [API 24] 以上に設定します。
ソース管理に Git を使用している場合は、プロジェクトの .gitignore ファイルを変更して、シークレットファイルがバージョン管理に commit されないようにします。
- プロジェクトのルートディレクトリで、.gitignore ファイルを開きます。
- 次の行を追加します。
```
secrets.properties
```
プロジェクトレベルの 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
}
```
次のように gradle/libs.versions.toml ファイルを更新します。
- gradle/libs.versions.toml ファイルを開きます。このファイルは通常、プロジェクトのルートディレクトリ内の gradle ディレクトリにあります。
- [versions] セクションで、SDK と Secrets Gradle プラグインのバージョンを追加します。
```
# See https://developers.google.com/android/guides/setup?device=phone-tablet for available releases
maps3dSdk = "16.0.0"
# See https://github.com/google/secrets-gradle-plugin/releases for available releases
secretsGradlePlugin = "2.0.1"
```
- [library] セクションに SDK ライブラリを追加します。
```
play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }
```
- [plugins] セクションに、Secrets Gradle プラグインを追加します。
```
secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }
```

モジュールレベルの 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
}

dependencies ブロックに、Maps 3D SDK for Android の Google Play 開発者サービス依存関係を追加します。

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

ファイルの末尾（android ブロックと dependencies ブロックの外側）に、シークレット構成を追加します。

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 キーをプロジェクトに追加する

secrets.properties ファイルを作成します。
- アプリモジュールのルートディレクトリ（通常は app ディレクトリ）に、secrets.properties という名前の新しいファイルを作成します。
- API キーをファイルに追加します。
```
MAPS3D_API_KEY=YOUR_API_KEY_HERE
```
注: YOUR_API_KEY_HERE は、Maps 3D SDK for Android で使用するように構成した API キーに置き換えてください。
local.defaults.properties ファイルを作成します。 - アプリモジュールのルートディレクトリに、local.defaults.properties という名前の新しいファイルを作成します。 - デフォルトまたはプレースホルダの API キーをファイルに追加します。このファイルはバージョン管理にチェックインできます。
```
MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
```

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

app/src/main/AndroidManifest.xml ファイルを開きます。
<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 ファイルのキーに置き換えられます。

プログラムによるビューの初期化（省略可）

XML レイアウトではなくプログラムでマップビューを初期化する場合は、Map3DInitConfig を使用します。

import com.google.android.gms.maps3d.Map3DInitConfig
import com.google.android.gms.maps3d.Map3DView
import com.google.android.gms.maps3d.model.Map3DMode

// Set configuration options using the factory method
val config = Map3DInitConfig.create(
    mapMode = Map3DMode.HYBRID,
    centerLat = 38.544012,
    centerLng = -107.670428
)

val map3DView = Map3DView(context, config)

次のステップ

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

設定 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

前提条件

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

ステップ 1

Console

Cloud SDK

ステップ 2

Console

Cloud SDK

ステップ 3

コンソール

Cloud SDK

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

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

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

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

プログラムによるビューの初期化（省略可）

次のステップ

設定

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