このページでは、 ユーティリティ ライブラリ をご覧ください。
これらのユーティリティを試すには、次のいずれかを行います。
- ユーティリティ ライブラリを既存の Xcode プロジェクトにインストールします。これらのユーティリティを実際のプロジェクトに追加します。
- デモアプリをインストールして実行します。デモアプリはスタンドアロン プロジェクトであり、ユーティリティを試すために必要なコードがすべて含まれています。
Maps SDK for iOS ユーティリティ ライブラリを Xcode プロジェクトに追加する
次の手順に従って、ユーティリティ ライブラリを Xcode ワークスペースに追加します。
Swift Package Manager を使用する
- Xcode プロジェクトがまだない場合は、ここで作成してローカルマシンに保存します。 (iOS 開発を初めて行う場合は、新しいプロジェクトを作成し、[iOS アプリ テンプレート。Xcode 11.7 以前では、シングルビュー アプリケーションを作成します)。
- Maps SDK for iOS を依存関係として追加します。詳しくは、 オプションについては、SDK のインストールをご覧ください。
- Xcode プロジェクトで、[File] ->Swift パッケージ ->パッケージの依存関係を追加する。
- 表示されたウィンドウで、Maps SDK for iOS ユーティリティ ライブラリのリポジトリ URL を入力します。
https://github.com/googlemaps/google-maps-ios-utils
] をクリックし、[次へ] を選択します。 - この時点で、GitHub アカウントでの認証を求められる場合があります。詳しくは、 新しい P-MAX キャンペーンを GitHub 個人用アクセス トークンを付与してプロセスを続行します。
- 次のウィンドウで [Version] ラジオ オプションを選択し、[Up to Next Major Version] を選択します。 を選択して、Maps SDK for iOS ユーティリティ ライブラリの最新バージョンを入力します。 (「6.0.0」など)。
- [Add to Project] の横にあるプルダウンをクリックし、プロジェクトを選択して、[Add Package] を選択します。
CocoaPods を使用
- Xcode プロジェクトがまだない場合は、ここで作成して インストールします。(iOS 開発を初めて行う場合は、 アプリケーションを表示] をクリックします)。
- プロジェクト用の Pod ファイルがない場合は、
Podfile
という名前のプロジェクト ディレクトリにあります。このファイルでは、 依存関係が存在します。 - プロジェクトの Pod ファイルを編集し、
Google-Maps-iOS-Utils
Pod。こちらの 必要な依存関係が含まれているサンプルを Maps SDK for iOS とユーティリティ ライブラリ:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '9.0.0' pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version end
pod install
を実行します。- Xcode を閉じて、プロジェクトの
Xcode を起動する
.xcworkspace
ファイル。これ以降 プロジェクトを開くために.xcworkspace
ファイルを使用する必要があります。
注: マーカー クラスタリング ユーティリティは、
ですが、マーカー クラスタリングがなくても四分木を使用できます。目標
四分木ユーティリティのみであるため、この引数は
pod 'Google-Maps-iOS-Utils'
~
Pod ファイル内の 'Google-Maps-iOS-Utils/QuadTree'
。
アプリに API キーを追加する
生成手順については、Xcode プロジェクトをセットアップするをご覧ください。 Xcode プロジェクトに追加します。プロジェクトをビルドして実行する
API キーを追加したら、プロジェクトをビルドして実行します。
アプリでユーティリティを使用する
アプリでユーティリティを使用する方法の詳細については、各ユーティリティのドキュメントをご覧ください。
デモアプリをインストールして実行する
ユーティリティ ライブラリにはデモアプリが含まれています。インストールすると、各ユーティリティを試すことができます。
次のいずれかの方法でデモアプリをインストールします。GitHub のファイルを使用する
- ダウンロード コードサンプル アーカイブをご覧ください。 GitHub アーカイブを展開します。
- ターミナル ウィンドウを開き、サンプル ファイルを展開したディレクトリに移動します。
使用する言語の適切なサンプル ディレクトリまでドリルダウンします。
<ph type="x-smartling-placeholder">
- </ph>
- Swift の場合は、
cd google-maps-ios-utils-master/samples/SwiftDemoApp
を実行します。 - Objective-C の場合は、
cd google-maps-ios-utils-master/samples/ObjCDemoApp
を実行します。
- Swift の場合は、
- 次のコマンドを実行します。
pod install
- Xcode を閉じて、プロジェクトの
Xcode を起動する
.xcworkspace
ファイル。これ以降 プロジェクトを開くために.xcworkspace
ファイルを使用する必要があります。
CocoaPods v1.6.1 を使用する
- ターミナル ウィンドウを開き、バージョン 1.6.1 をインストールします。
sudo gem install cocoapods -v1.6.1
- Cocoapods を使用して Google マップのファイルを取得します。
pod try Google-Maps-iOS-Utils
プロンプトが表示されたら、Swift または Objective-C を選択します。CocoaPods が仕様リポジトリを更新して 次に、
SwiftDemoApp.xcodeproj
という名前の一時的な Xcode プロジェクトでデモを開きます。 またはObjCDemoApp.xcodeproj
。
デモアプリに 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 バージョンのデモを編集して、各ユーティリティを試すことができます。 詳しくは、後述のアプリにユーティリティを追加するをご覧ください。