このページでは、Maps SDK for iOS の ユーティリティ ライブラリ をセットアップする方法について説明します。
これらのユーティリティを試すには、次のいずれかを行います。
- ユーティリティ ライブラリの を既存の Xcode プロジェクトにインストールします。これらのユーティリティを独自のプロジェクトに追加します。
- デモアプリをインストールして実行します。デモアプリは、ユーティリティを試すために必要なすべてのコードを含むスタンドアロン プロジェクトです。
Maps SDK for iOS ユーティリティ ライブラリを Xcode プロジェクトに追加する
次の手順に沿って、ユーティリティ ライブラリを Xcode ワークスペースに追加します。
Swift Package Manager を使用する
- Xcode プロジェクトをまだ作成していない場合は、ここで作成してローカルマシンに保存します (iOS アプリを初めて開発する場合は、新規プロジェクトの作成時に [iOS App template] を選択してください。Xcode 11.7 以前では [Single View Application] を作成します)。
- Maps SDK for iOS を依存関係として追加します。オプションについては、 SDK のインストールをご覧ください。
- Xcode プロジェクトで、[File] -> [Swift Packages] -> [Add Package Dependency] に移動します。
- 表示されたウィンドウに、Maps SDK for iOS ユーティリティ ライブラリのリポジトリ URL
https://github.com/googlemaps/google-maps-ios-utilsを入力して、[Next] を選択します。 - この時点で、GitHub アカウントでの認証を求められることがあります。手順に沿って GitHub 個人アクセス トークンを作成し、プロセスを続行します。
- 次のウィンドウで、[Version] ラジオボタンを選択し、プルダウン リストから [Up to Next Major Version] を選択して、Maps SDK for iOS ユーティリティ ライブラリの最新の バージョン(「6.0.0」など)を入力します。
- [Add to Project] の横にあるプルダウンをクリックしてプロジェクトを選択し、[Add Package] を選択します。
アプリに API キーを追加する
API キーを生成して Xcode プロジェクトに追加する手順については、Xcode プロジェクトをセットアップするをご覧ください。プロジェクトをビルドして実行する
API キーを追加したら、プロジェクトをビルドして実行します。
アプリでユーティリティを使用する
アプリでの使用方法について詳しくは、各ユーティリティのドキュメントをご覧ください。
デモアプリをインストールして実行する
ユーティリティ ライブラリには、インストールして各ユーティリティを試すことができるデモアプリが含まれています。
デモアプリをインストールします。GitHub のファイルを使用する
- GitHub
から
コードサンプル アーカイブ
をダウンロードして、アーカイブを解凍します。または、リポジトリをローカル ディレクトリにクローンします。
git clone https://github.com/googlemaps/google-maps-ios-utils.git
- ターミナル ウィンドウを開き、サンプルファイルを展開したディレクトリに移動して、
使用する言語の適切なサンプル ディレクトリに移動します:
Swift
cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeprojObjective-C
cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj
デモアプリに API キーを追加する
API キーを取得するで、アプリの API キーを生成します。このキーをデモアプリの Xcode プロジェクトに追加します。Swift
次のように、API キーを AppDelegate.swift に追加します。
- 次の import ステートメントを追加します。
import GoogleMaps
- 次の行を編集して、二重引用符の間に API キーを追加します。
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
次のように、API キーを AppDelegate.m に追加します。
- 次の import ステートメントを追加します。
@import GoogleMaps;
- 次の行を編集して、二重引用符の間に API キーを追加します。
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
デモアプリをビルドして実行する
API キーを追加したら、プロジェクトをビルドして実行します。
- デモの Swift バージョンを実行している場合は、アプリに表示するユーティリティを選択できます。
- デモの Objective-C バージョンを実行している場合は、 マーカー クラスタリング ユーティリティのデモが表示されます。デモの Objective-C バージョンを編集して、各ユーティリティを試すことができます。 詳しくは、下記のアプリにユーティリティを追加するをご覧ください。