課金を有効にして 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 を追加する手順は次のとおりです。
-
Xcode の
projectまたはworkspaceを開き、[File] > [Add Package Dependencies] の順に移動します。 - URL として「https://github.com/googlemaps/ios-places-sdk」と入力し、Enter キーを押してパッケージをプルし、[Add Package] をクリックします。
-
特定の
versionをインストールするには、[Dependency Rule] フィールドをバージョンベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定して [Exact Version] オプションを使用することをおすすめします。完了したら、[パッケージを追加] をクリックします。 - [パッケージ商品を選択] ウィンドウで、
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 のパッケージ依存関係セクションから削除します。 - インストールを確認するには、ターゲットの [General] ペインに移動します。[Frameworks, Libraries, and Embedded Content] に、インストールされたパッケージが表示されます。Project Navigator の [Package Dependencies] セクションで、パッケージとそのバージョンを確認することもできます。
既存のプロジェクトの package を更新する手順は次のとおりです。
-
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 のパッケージ依存関係セクションから削除します。 - インストールを確認するには、[Project Navigator] の [Package Dependencies] セクションに移動して、パッケージとそのバージョンを確認します。
手動でインストールした既存の Places SDK for iOS を削除する手順は次のとおりです。
-
Xcode プロジェクトの構成設定で、[Frameworks, Libraries, and Embedded Content] を見つけます。マイナス記号(-)を使用して、次のフレームワークを削除します。
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
Xcode プロジェクトの最上位ディレクトリから
GooglePlacesバンドルを削除します。
手動インストール
このガイドでは、Places SDK for iOS と Places Swift SDK for iOS を含む XCFrameworks をプロジェクトに手動で追加し、Xcode でビルド設定を構成する方法について説明します。XCFramework は、Apple シリコンを使用するマシンを含む複数のプラットフォームで使用できるバイナリ パッケージです。Places SDK for iOS、Places Swift SDK for iOS、またはその両方を追加できます。
- 次の SDK バイナリ ファイルとリソース ファイルをダウンロードします。
- Places Swift SDK for iOS をインストールする場合は、次のファイルをインストールします。
- ファイルを解凍して、XCFramework とリソースにアクセスします。
- Xcode を起動し、既存のプロジェクトを開くか、新しいプロジェクトを作成します。iOS 開発に慣れていない場合は、新しいプロジェクトを作成して iOS アプリ テンプレートを選択します。
- プロジェクトから以前のリリースの Maps バンドルをすべて削除します。
-
[全般] タブを開きます。次の XCFramework を、[Frameworks, Libraries, and Embedded Content] のプロジェクトにドラッグします。[Do Not Embed] を選択してください。
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
ダウンロードした 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] を選択します。 - プロジェクト ナビゲータからプロジェクトを選択し、アプリのターゲットを選択します。
-
[Build Phases] タブを開きます。[Link Binary with Libraries] で、次のフレームワークとライブラリを追加します。
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
特定のターゲットではなくプロジェクトを選択し、[Build Settings] タブを開きます。[Linking - General -> Other Linker Flags] セクションで、[Debug] と [Release] に
-ObjCを追加します。これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。
ステップ 3: アプリに API キーを追加する
以下の例で YOUR_API_KEY とある箇所は、実際の API キーに置き替えてください。
次のように、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 のリソース バンドルに含まれています。プライバシー マニフェスト ファイルが含まれていることを確認し、その内容を検査するには、アプリのアーカイブを作成し、そのアーカイブからプライバシー レポートを生成します。
次のステップ
- コードの記述を開始します。ユーザーの Current Placeを取得するスターター アプリを実装することをおすすめします。
- プロジェクトを構成したら、サンプルアプリを試すことができます。
- App Check を使用して API キーを保護する。