設定

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

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 がわからない場合は、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

次のコマンドを実行すると、マップ、ルート、プレイスのすべての 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 キーを押してパッケージをプルし、[パッケージを追加] をクリックします。
  • [Choose Package Products] ウィンドウで、GoogleMaps3D が指定したメイン ターゲットに追加されることを確認します。完了したら、[パッケージを追加] をクリックします。
  • インストールを確認するには、ターゲットの [全般] ペインに移動します。[Frameworks, Libraries, and Embedded Content] に、インストールされているパッケージが表示されます。プロジェクト ナビゲータの [パッケージの依存関係] セクションで、パッケージとそのバージョンを確認することもできます。

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

次のステップ

これで、Maps 3D SDK for iOS で使用する Google Cloud プロジェクト、API キー、Xcode プロジェクトが設定されました。次に、アプリに 3D マップを追加します。