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

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

各リリースについて、リリースノートが用意されています。

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

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

• Xcode バージョン 26.0 以降

ステップ 2: Xcode プロジェクトを作成して Navigation SDK をインストールする

Swift Package Manager

Navigation SDK は、 Swift Package Manager を使用してインストールできます。SDK を追加するには、既存の Navigation SDK の依存関係をすべて削除してください。

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

1. Xcode project または workspace を開き、[File] > [Add Package Dependencies] の順に移動します。
2. URL として https://github.com/googlemaps/ios-navigation-sdk を入力し、Enter キーを押してパッケージをプルし、[パッケージを追加] をクリックします。
3. 特定の version をインストールするには、[依存関係ルール] フィールドをバージョン ベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定して [Exact Version] オプションを使用することをおすすめします。完了したら、[Add Package] をクリックします。
4. [Choose Package Products] ウィンドウで、GoogleNavigation が指定した main ターゲットに追加されることを確認します。完了したら、[Add Package] をクリックします。
5. インストールを確認するには、ターゲットの [General] ペインに移動します。[Frameworks, Libraries, and Embedded Content] に、インストールされたパッケージが表示されます。[Project Navigator] の [Package Dependencies] セクションで、パッケージとそのバージョンを確認することもできます。

既存のプロジェクトの package を更新する手順は次のとおりです。

1. Xcode で、[File] > [Packages] > [Update To Latest Package Versions] の順に移動します。
2. インストールを確認するには、プロジェクト ナビゲータの [パッケージの依存関係] セクションに移動して、パッケージとそのバージョンを確認します。

重要: アーティファクトを解決できない場合や、エラーが発生する場合があります。その場合は、[File] > [Packages] > [Reset Package Cache] を選択します。

手動でインストールした既存の Navigation SDK for iOS を削除する手順は次のとおりです。

1. Xcode プロジェクトの構成設定で、[Frameworks, Libraries, and Embedded Content] を見つけます。マイナス記号（-）を使用して、次のフレームワークを削除します。
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. Xcode プロジェクトの最上位ディレクトリから、GoogleMaps バンドルを削除します。

手動インストール

このガイドでは、Navigation SDK for iOS と Maps SDK for iOS を含む XCFrameworks をプロジェクトに手動で追加し、Xcode でビルド設定を構成する方法について説明します。XCFramework は、M1 チップセットを使用するマシンを含む複数のプラットフォームで使用できるバイナリ パッケージです。

Navigation SDK for iOS と Maps SDK for iOS の XCFrameworks をインストールする手順は次のとおりです。

1. 次の SDK バイナリとリソース ファイルをダウンロードします。
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Xcode を起動し、既存のプロジェクトを開くか、新しいプロジェクトを作成します。iOS を初めて使用する場合は、新しいプロジェクトを作成して iOS アプリ テンプレートを選択します。
3. プロジェクトから既存のマップ、Navigation、プレイスの参照をすべて削除します。
   重要: Places SDK for iOS は Navigation SDK for iOS に含まれていないため、別途インストールする必要があります。これは、Places SDK for iOS のバージョン 5.0 以降に該当します。Places SDK for iOS と Navigation SDK for iOS の同じバージョンをダウンロードしてインストールすることをおすすめします。Places SDK for iOS をインストールするをご覧ください。
4. 次の XCFrameworks を、[Frameworks, Libraries, and Embedded Content] の下にあるプロジェクトにドラッグして、Maps SDK と Navigation SDK の両方をインストールします（プロンプトが表示されたら、[Copy items if needed] を選択します）。
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. ダウンロードした GoogleMapsResources から GoogleMaps.bundle を Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[Copy items if needed] が選択されていることを確認します。
6. ダウンロードした GoogleNavigationResources から GoogleNavigation.bundle を Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[Copy items into destination group's folder] が選択されていることを確認します。
7. プロジェクト ナビゲータからプロジェクトを選択し、アプリケーションのターゲットを選択します。
8. [Build Phases] タブを開き、[Link Binary with Libraries] で次のフレームワークとライブラリを追加します。
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CarPlay.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • MapKit.framework
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. アプリケーションのターゲットで、[Capabilities] タブを選択し、[Background Modes] をオンにして、次のモードを有効にします。
   • 音声、AirPlay、ピクチャー イン ピクチャー
   • 位置情報の更新
10. 特定のターゲットではなくプロジェクトを選択し、[Build Settings] タブを開きます。[Other Linker Flags] セクションで、debug と release の両方に ‑ObjC を追加します。これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。
    重要: SDK には Swift シンボルが含まれています。純粋な Objective-C プロジェクトを作成する場合は、プロジェクトに空の .swift ファイルを作成するか、Xcode プロジェクトの [Other Linker Flags] セクションに以下を追加する必要があります。

    -L$(DEVELOPER_DIR)/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/$(PLATFORM_NAME)

11. Info.plist を開き、次の Key-Value ペアを追加します。
    • キー: NSLocationWhenInUseUsageDescription（プライバシー - 使用中の位置情報の使用目的の説明）
      値: 「このアプリは、ターンバイターン方式ナビのために位置情報を使用する権限を必要とします。」
    • キー: NSLocationAlwaysAndWhenInUseUsageDescription（プライバシー - 位置情報の常時使用と使用中の使用状況の説明）
      値: 「このアプリは、ターンバイターン方式ナビのために位置情報を使用する権限を必要とします。」

ステップ 3: API キーをプロジェクトに追加する

次の例は、Xcode で API キーをプロジェクトに追加する方法を示しています。

Swift

次のように、API キーを AppDelegate.swift に追加します。

1. 次の import ステートメントを追加します。

   import GoogleMaps
   import GoogleNavigation

2. application(_:didFinishLaunchingWithOptions:) メソッドに次のコードを追加します。

   GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

次のように、API キーを AppDelegate.m に追加します。

1. 次の import ステートメントを追加します。

   @import GoogleMaps;
   @import GoogleNavigation;

2. application:didFinishLaunchingWithOptions: メソッドに次のコードを追加します。

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

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

注: 以下は、アプリをウェブストアにデプロイする場合に関連します。

Apple は、アプリストアのアプリに対してアプリのプライバシーの詳細を義務付けています。最新情報や詳細については、Apple アプリストアのプライバシーの詳細ページをご覧ください。

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

モビリティ サービスのお客様の場合

モビリティ サービスをご利用のお客様は、モビリティのドキュメントで請求についてご確認ください。トランザクションの記録について詳しくは、お支払い情報を設定するをご覧ください。Navigation SDK の実装にトランザクション ID を追加する方法については、サービスの使用状況を Mobility トランザクションに関連付けるをご覧ください。

次のステップ

これで API キーと Xcode プロジェクトが用意できたので、アプリを作成・実行する準備が整いました。 Navigation SDK for iOS には、開発を始めるのに役立つチュートリアルが用意されています。詳しくは、以下をご覧ください。

• チュートリアル
  • ルートをナビゲートする
  • ナビゲーション イベントをリッスンする
• App Check を使用して API キーを保護する
• コードサンプルと Codelab