このページでは、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
-
Google Cloud コンソールの [プロジェクトの選択] ページで [新しいプロジェクト] をクリックし、新しい Cloud プロジェクトの作成を開始します。
-
Cloud プロジェクトで お支払いが有効になっていることを確認します。
Google Cloud では、無料トライアルを提供しています。トライアルは、90 日が経過するか、アカウントの費用が 300 ドルに達した時点のいずれか早い方の時点で終了します。解約はいつでも可能です。詳しくは、請求先アカウントのクレジットおよび Google Maps Platform の料金をご覧ください。
Cloud SDK
gcloud projects create "PROJECT"
詳しくは、Google Cloud SDK、Cloud SDK のインストール、および以下のコマンドをご覧ください。
ステップ 2: API または SDK を有効にする
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 をご確認ください。
- 有効にする 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 キーの使用ページをご覧ください。
API キーは、使用量と課金のためにプロジェクトに関連付けられたリクエストを認証する固有識別子です。少なくとも 1 つの API キーをプロジェクトに関連付ける必要があります。 新しいキーを作成する場合、または既存のキーに API や SDK を追加する場合は、次の手順に沿って操作します。
Console
-
[Google Maps Platform] > [キーと認証情報] ページに移動します。
- プロンプトが表示されたら、プロジェクトを選択します。
-
次のいずれかを行います。
-
新しい鍵を作成する:
- [認証情報を作成] > [API キー] をクリックします。
- [API キーの作成] パネルで、[API の制限の選択] リストを開きます。
- このキーに不要な API をすべてクリアし、使用する予定の API が選択されたままであることを確認します。
- [作成] をクリックします。パネルに新しい API キーが表示されます。
-
既存の鍵を使用する:
- 鍵の名前をクリックします。
- [API の制限を選択] リストで、使用する API を選択します。
- [保存] をクリックします。
ここで API を選択しても、API は有効になりません。選択した各 API が API ライブラリで有効になっていることを確認します。
-
- 後で鍵文字列を表示するには、[鍵と認証情報] ページに移動し、鍵の [鍵を表示] をクリックします。
コンソールの表示がこれらの手順と異なる場合は、Google Cloud ドキュメントの API キーを作成すると API 制限を追加するをご覧ください。
Cloud SDK
次のコマンドで、PROJECT_ID をプロジェクト ID に置き換えます。
-
新しい鍵を作成する: 次のコマンドを実行します。DISPLAY_NAME は鍵の名前に置き換えます。SERVICE_NAME は、使用する予定の API のサービス名（
places.googleapis.comなど）に置き換えます。さらに API を許可するには、--api-targetフラグを繰り返します。gcloud services api-keys create \ --project="PROJECT_ID" \ --display-name="DISPLAY_NAME" \ --api-target=service=SERVICE_NAME
詳しくは、Google Cloud SDK、Cloud SDK のインストール、および以下のコマンドをご覧ください。
-
既存の鍵を使用する: 次のコマンドを実行します。KEY_ID は鍵の ID に置き換えます。SERVICE_NAME は、追加する API のサービス名に置き換えます。
--appendフラグは、キーですでに許可されている API を保持します。このフラグを指定しない場合、コマンドはそれらを置き換えます。gcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=SERVICE_NAME
詳しくは、Google Cloud SDK、Cloud SDK のインストール、および以下のコマンドをご覧ください。
鍵 ID は、鍵文字列や表示名ではありません。これを確認するには、
gcloud services api-keys list --project="PROJECT_ID"を実行します。ID はnameフィールドの最後の部分（projects/PROJECT_NUMBER/locations/global/keys/KEY_ID）です。
鍵文字列を表示するには、gcloud services api-keys get-key-string KEY_ID
--project="PROJECT_ID" を実行します。
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 キーを追加します。
- 以下のインポート文を追加します。
import GoogleMaps3D
- 次のメソッドを追加します。
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 マップを追加できます。