設定

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

前提条件

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

  • iOS の最小バージョン: iOS 16.0 以降をターゲットに設定します。
  • Xcode: Xcode バージョン 16.0 以降。

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

Maps 3D SDK for iOS を使用して開発を始める前に、次の手順に沿って、Maps 3D SDK for iOS で使用する 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 がわからない場合は、Capabilities Explorer を使用するか、該当する 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" \
    "weather.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 iOS ページをご覧ください。これらの手順を完了する方法については、Google Maps Platform スタートガイドをご覧ください。

Xcode プロジェクトを設定する

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

課金を有効化して API キーを作成すると、アプリの開発に使う Xcode プロジェクトをセットアップできるようになります。

ステップ 1: 必要なソフトウェアをインストールする

Maps 3D SDK for iOS を使用してプロジェクトをビルドするには、以下をダウンロードしてインストールする必要があります。

  • Xcode バージョン 16.0 以降

ステップ 2: Xcode プロジェクトを作成し、Maps 3D SDK for iOS をインストールする

Swift Package Manager

Maps 3D SDK for iOS は、Swift Package Manager を使用してインストールできます。

新規または既存のプロジェクトに SDK を追加する手順は次のとおりです。

  • Xcode の project または workspace を開き、[File] > [Add Package Dependencies] に移動します。
  • URL として「https://github.com/googlemaps/ios-maps-3d-sdk」と入力し、Enter キーを押してパッケージをプルし、[Add Package] をクリックします。
  • [Choose Package Products] ウィンドウで、GoogleMaps3D が指定したメイン ターゲットに追加されることを確認します。完了したら、[Add Package] をクリックします。
  • インストールを確認するには、ターゲットの [General] ペインに移動します。[Frameworks, Libraries, and Embedded Content] に、インストールされたパッケージが表示されます。プロジェクト ナビゲータの [Package Dependencies] セクションで、パッケージとそのバージョンを確認することもできます。

ステップ 3: アプリに API キーを追加する

Swift Package Manager

次のように、アプリのメイン エントリ ポイント（または地図が読み込まれる前）に API キーを追加します。

  1. 以下のインポート文を追加します。
    import GoogleMaps3D
  2. 次のメソッドを追加します。YOUR_API_KEY は実際の API キーに置き換えてください。 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

ステップ 4（省略可）: Apple のプライバシー マニフェスト ファイルを検査する

Apple は、App Store のアプリにアプリのプライバシーの詳細を義務付けています。

Apple のプライバシー マニフェスト ファイルは、SDK のリソース バンドルに含まれています。プライバシー マニフェスト ファイルが含まれていることを確認し、その内容を検査するには、アプリのアーカイブを作成し、そのアーカイブからプライバシー レポートを生成します。

次のステップ

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