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

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

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

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

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

  • Xcode バージョン 26.0 以降

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

Swift Package Manager

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

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

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

    非推奨の GitHub URL から Google Places Swift を更新する場合

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

  5. インストールを確認するには、ターゲットの [General] ペインに移動します。[Frameworks, Libraries, and Embedded Content] に、インストールされたパッケージが表示されます。Project Navigator の [Package Dependencies] セクションで、パッケージとそのバージョンを確認することもできます。

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

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

    非推奨の GitHub URL から Google Places Swift を更新する場合

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

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

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

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

手動インストール

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

  1. 次の SDK バイナリ ファイルとリソース ファイルをダウンロードします。
  2. Places Swift SDK for iOS をインストールする場合は、次のファイルをインストールします。
  3. ファイルを解凍して、XCFramework とリソースにアクセスします。
  4. Xcode を起動し、既存のプロジェクトを開くか、新しいプロジェクトを作成します。iOS 開発に慣れていない場合は、新しいプロジェクトを作成して iOS アプリ テンプレートを選択します。
  5. プロジェクトから以前のリリースの Maps バンドルをすべて削除します。
  6. [全般] タブを開きます。次の XCFramework を、[Frameworks, Libraries, and Embedded Content] のプロジェクトにドラッグします。[Do Not Embed] を選択してください。
    • GooglePlaces.xcframework
    Places Swift SDK をインストールする場合は、次の XCFramework をプロジェクトの [Frameworks, Libraries, and Embedded Content] にドラッグします。[Do Not Embed] を選択してください。
    • GooglePlacesSwift.xcframework
  7. ダウンロードした GooglePlacesResources から GooglePlaces.bundle を Xcode プロジェクトの最上位ディレクトリにコピーします。プロンプトが表示されたら、[Copy items into destination group's folder] を選択します。

    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] に変更します。

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

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

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

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

  • 次の import ステートメントを追加します。
    import GooglePlacesSwift
  • 次のコードを application(_:didFinishLaunchingWithOptions:) メソッドに追加し、YOUR_API_KEY を実際の API キーに置き換えます。
    PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

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

  • 次の import ステートメントを追加します。
    import GooglePlaces
  • 次のコードを application(_:didFinishLaunchingWithOptions:) メソッドに追加し、YOUR_API_KEY を実際の API キーに置き換えます。
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

  • 次の import ステートメントを追加します。
    @import GooglePlaces;
  • 次のコードを application:didFinishLaunchingWithOptions: メソッドに追加し、YOUR_API_KEY を実際の API キーに置き換えます。
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

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

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

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

次のステップ