Places SDK for iOS に付属している SDK デモアプリでは、Place Autocomplete やプレイス写真など、さまざまな機能を紹介しています。また、このデベロッパー ガイドの各ページでもコード スニペットをご確認いただけます。
CocoaPods を使って SDK のデモを試す
Places SDK for iOS は、CocoaPods Pod として入手できます。CocoaPods は、Swift プロジェクトと Objective-C Cocoa プロジェクトのオープンソース依存関係マネージャーです。
Places SDK for iOS には、pod try
コマンドを使用してインストール、実行できる SDK デモアプリ一式が用意されています。
- GooglePlaces では、プレイス オートコンプリートとプレイスの写真を紹介しています。
CocoaPods をインストールして、Places SDK for iOS を試す手順は次のとおりです。
- CocoaPods ツールがない場合は、ターミナルから以下のコマンドを実行して、macOS 上に CocoaPods ツールをインストールします。詳細については、CocoaPods スタートガイドをご覧ください。
sudo gem install cocoapods
- 次の 2 つの方法のいずれかを使用してサンプル ファイルを取得します。
GitHub のファイルを使用する
- GitHub からコードサンプル アーカイブをダウンロードして、アーカイブを展開します。
- ターミナル ウィンドウを開いて、サンプル ファイルを展開したディレクトリに移動し、GooglePlaces ディレクトリまでドリルダウンします。
Swift
cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift
Objective-C
cd maps-sdk-for-ios-samples-master/GooglePlaces
- 次のコマンドを実行します。
pod install
open GooglePlacesDemos.xcworkspace
CocoaPods v1.6.1 を使用する
- ターミナル ウィンドウを開き、バージョン 1.6.1 をインストールします。
sudo gem install cocoapods -v1.6.1
- CocoaPods を使用して Google プレイス ファイルを取得する:
pod try GooglePlaces
CocoaPods が仕様リポジトリを更新してから、一時的な Xcode プロジェクト
GooglePlacesDemos.xcworkspace
で SDK デモを開きます。
- Google Cloud Console プロジェクトで Places SDK for iOS を有効にします。
- まだ API キーをお持ちでない場合は、こちらの手順に沿って Cloud Console にプロジェクトを設定し、API キーを取得します。Cloud Console で鍵を構成するときに、アプリのバンドル ID を指定して、アプリのみが鍵を使用できるようにすることができます。SDK サンプルアプリのデフォルトのバンドル ID は
com.example.GooglePlacesDemos
です。 SDKDemoAPIKey
ファイルを編集して、API キーを適切な定数に貼り付けます。次に例を示します。Swift
let placesAPIKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- 編集のために
SDKDemoAPIKey
ファイルのロック解除を求めるメッセージが Xcode に表示された場合は、[Unlock] を選択します。 - 存在する場合は、次の行を削除します。これは、問題の登録に使用されるためです。
Swift
#error (API キーを登録してここに挿入)この行を削除します。」
Objective-C
#error Register your API key and insert here, then delete this line.
- 再度、プロジェクトをビルドして実行します。
- ビルドが失敗するか、アプリの初回実行時に API キーに関するエラーが発生してアプリがクラッシュする場合は、
SDKDemoAPIKey
ファイルに必要なキーが渡されていることを確認してください。 - GooglePlaces デモを実行している場合、iOS シミュレータ ウィンドウに Places デモのリストが表示されます。
- GooglePlacesDemos に位置情報へのアクセスを許可するよう求められたら、[許可] を選択します。
- これで、選択したサンプルを実行できます。
デベロッパー ガイドのコード スニペットを使用する
デベロッパー ガイドの各ページには、API の特定の機能を示すコード スニペットが含まれています。たとえば、このガイドのオートコンプリート、現在の場所を取得する、写真などのガイドをご覧ください。