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

課金を有効にして API キーを作成したら、アプリの開発に使用する Xcode プロジェクトをセットアップできます。

各リリースのリリースノートを確認できます。

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

Places SDK for iOS を使用してプロジェクトを作成するには、以下が必要です。

• Xcode バージョン 15.0 以降

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

Swift Package Manager

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

重要: 以下の手順は Xcode 15 以降を使用していることを前提としていますが、以前のバージョンの Xcode でも同様の手順で行うことができます。

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

1. Xcode project または workspace を開き、[File] > [Add Package Dependencies] に移動します。
2. URL として https://github.com/googlemaps/ios-places-sdk を入力し、Enter キーを押してパッケージを取得し、[パッケージを追加] をクリックします。
3. 特定の version をインストールするには、[依存関係ルール] フィールドをバージョンベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定し、[Exact Version] オプションを使用することをおすすめします。完了したら、[パッケージを追加] をクリックします。
4. [パッケージ プロダクトを選択] ウィンドウで、指定したメイン ターゲットに GooglePlaces、GooglePlacesSwift、またはその両方が追加されることを確認します。完了したら、[パッケージを追加] をクリックします。

   非推奨の GitHub URL から Google プレイス Swift を更新している場合

   重要: バージョン 0.3.0 以降、Google Places Swift にアクセスするための GitHub URL が変更されました。古い URL https://github.com/googlemaps/ios-places-swift-sdk からアクセスしていた GooglePlacesSwift のバージョンを更新する場合は、Xcode のパッケージ依存関係セクションから削除します。

5. インストールを確認するには、ターゲットの [全般] ペインに移動します。[フレームワーク、ライブラリ、埋め込みコンテンツ] に、インストールされているパッケージが表示されます。Project Navigator の [Package Dependencies] セクションでパッケージとそのバージョンを確認することもできます。Xcode には GitHub バージョンが表示されます。これは GooglePlaces のバージョン（9.2.0 など）と一致しますが、GooglePlacesSwift のバージョン（0.3.0 など）とは一致しません。

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

1. Xcode で、[File] > [Packages] > [Update To Latest Package Versions] に移動します。

   非推奨の GitHub URL から Google プレイス Swift を更新している場合

   重要: バージョン 0.3.0 以降、Google Places Swift にアクセスするための GitHub URL が変更されました。古い URL https://github.com/googlemaps/ios-places-swift-sdk からアクセスしていた GooglePlacesSwift のバージョンを更新する場合は、Xcode のパッケージ依存関係セクションから削除します。

2. インストールを確認するには、Project Navigator の [Package Dependencies] セクションに移動して、パッケージとそのバージョンを確認します。

重要: アーティファクトを解決できない場合やエラーが発生する場合があります。その場合は、[ファイル] > [パッケージ] > [パッケージ キャッシュをリセット] を選択します。

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

1. Xcode プロジェクトの構成設定で、[フレームワーク、ライブラリ、埋め込みコンテンツ] を見つけます。マイナス記号（-）を使用して、次のフレームワークを削除します。
   • GooglePlaces.xcframework
   • GooglePlacesSwift.xcframework
2. Xcode プロジェクトの最上位ディレクトリから、GooglePlaces バンドルを削除します。

手動インストール

このガイドでは、Places SDK for iOS と Places Swift SDK for iOS（プレビュー版）を含む XCFramework を手動でプロジェクトに追加し、Xcode でビルド設定を構成する方法について説明します。XCFramework は、Apple シリコンを使用するマシンなど、複数のプラットフォームで使用できるバイナリ パッケージです。Places SDK for iOS、Places Swift SDK for iOS（プレビュー版）、またはその両方を追加できます。

1. 次の SDK バイナリとリソース ファイルをダウンロードします。
   • GooglePlaces
   • GooglePlacesResources
2. Places Swift SDK for iOS（プレビュー版）をインストールする場合は、次のファイルをインストールします。
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. ファイルを抽出して XCFramework とリソースにアクセスします。
4. Xcode を起動し、既存のプロジェクトを開くか、新しいプロジェクトを作成します。iOS アプリを初めて開発する場合は、新規プロジェクトの作成時に iOS アプリ テンプレートを選択してください。
5. プロジェクトから以前のリリースの Maps バンドルをすべて削除します。
6. [全般] タブを開きます。次の XCFramework をプロジェクトの [フレームワーク、ライブラリ、埋め込みコンテンツ] にドラッグします。[埋め込まない] を選択します。
   • GooglePlaces.xcframework
   Places Swift SDK for iOS（プレビュー版）をインストールする場合は、次の XCFramework をプロジェクトの [Frameworks, Libraries, and Embedded Content] にドラッグします。[埋め込まない] を選択します。
   • GooglePlacesSwift.xcframework
7. ダウンロードした GooglePlacesResources から GooglePlaces.bundle を Xcode プロジェクトの最上位ディレクトリにコピーします。プロンプトが表示されたら、[ Copy items into destination group's folder] を選択してください。
   
   iOS 向け Places Swift SDK（プレビュー版）をインストールする場合は、ダウンロードした GooglePlacesSwiftResources から GooglePlacesSwift.bundle を Xcode プロジェクトのトップレベル ディレクトリにコピーします。プロンプトが表示されたら、[Copy items into destination group's folder] を選択してください。
8. プロジェクト ナビゲータでプロジェクトを選択し、アプリのターゲットを選択します。
9. [Build Phases] タブを開きます。[Link Binary with Libraries] 内に、次のフレームワークとライブラリを追加します。
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

10. （特定のターゲットではなく）プロジェクトを選択して、[Build Settings] タブを開きます。[Linking - General -> Other Linker Flags] セクションで、[Debug] と [Release] に -ObjC を追加します。これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。

CocoaPods

Places SDK for iOS と Places Swift SDK for iOS（プレビュー版）は、CocoaPod ポッド GooglePlaces と GooglePlacesSwift として利用できます。

CocoaPods は、Swift と Objective-C の Cocoa プロジェクトで依存関係を管理するためのオープンソース ツールです。CocoaPods ツールがない場合は、ターミナルから以下のコマンドを実行して、macOS 上に CocoaPods ツールをインストールします。詳しくは、CocoaPods スタートガイドをご覧ください。

sudo gem install cocoapods

Podfile を作成して、SDK とその依存関係をインストールします。

1. Xcode プロジェクトをまだ作成していない場合は、ここで作成してローカルマシンに保存しますiOS アプリを初めて開発する場合は、新規プロジェクトの作成時に iOS アプリ テンプレートを選択してください。
2. プロジェクトのディレクトリに、Podfile という名前のファイルを作成します。このファイルでプロジェクトの依存関係を定義します。
3. Podfile を編集して、依存関係とそのバージョンを追加します。アプリケーションのターゲット名と、GooglePlaces pod と GooglePlacesSwift pod の名前を指定する例を次に示します。

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '9.2.0'
     pod 'GooglePlacesSwift', '0.3.0'
   end

   pod outdated を定期的に実行して、新しいバージョンがあるかどうかを検出し、常に最新の状態に保つようにしてください。
4. Podfile を保存します。

5. ターミナルを開き、Podfile を含むディレクトリに移動します。

   cd <path-to-project>

6. pod install コマンドを実行します。Podfile で指定した API とその依存関係がインストールされます。

   pod install

7. Xcode を終了し、プロジェクトの .xcworkspace ファイルを（ダブルクリックして）開いて、Xcode を起動します。これ以降、このプロジェクトを開くには .xcworkspace ファイルを使用する必要があります。

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

1. ターミナルを開き、Podfile を含むプロジェクト ディレクトリに移動します。
2. pod update コマンドを実行します。これにより、Podfile で指定されたすべての API が最新バージョンに更新されます。

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

以下の例で YOUR_API_KEY とある箇所は、実際の API キーに置き替えてください。

Swift

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

• 次のインポート文を追加します。

  import GooglePlaces

• 次のコードを application(_:didFinishLaunchingWithOptions:) メソッドに追加し、「YOUR_API_KEY」YOUR_API_KEY をお客様の API キーに置き換えます。

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

• 次のインポート文を追加します。

  @import GooglePlaces;

• 次のコードを application:didFinishLaunchingWithOptions: メソッドに追加し、「YOUR_API_KEY」YOUR_API_KEYをお客様の API キーに置き換えます。

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

GooglePlacesSwift

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

• 次のインポート文を追加します。

  import GooglePlacesSwift

• 次のコードを application(_:didFinishLaunchingWithOptions:) メソッドに追加し、「YOUR_API_KEY」YOUR_API_KEYをお客様の API キーに置き換えます。

  PlacesClient.provideAPIKey("YOUR_API_KEY")

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

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

Apple は、App Store でアプリを公開するデベロッパーに対して、アプリのプライバシーに関する詳細情報の開示を求めています。最新情報と詳細については、Apple App Store のプライバシーに関する詳細情報のページをご覧ください。

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

次のステップ

• コードの記述を開始します。最初に、ユーザーの現在地を取得するスターター アプリを実装することをおすすめします。
• プロジェクトの設定が完了したら、サンプルアプリを確認できます。
• App Check を使用して API キーを保護する。