Maps SDK for iOS に付属の SDK デモアプリには、SDK の機能のハイライトを示すサンプルが含まれています。デモアプリのコードを調べて、各サンプルの実装方法を確認します。
SDK のデモを試す
Maps SDK for iOS SDK のデモアプリは、GitHub からダウンロード アーカイブまたは CocoaPods Pod として提供されています。CocoaPods は、Swift と Objective-C の Cocoa プロジェクト向けのオープンソースの依存関係マネージャーです。
Maps SDK for iOS SDK のデモアプリをインストールして試す手順は次のとおりです。
- サンプル ファイルを取得するには、次の 2 つの方法があります。
GitHub から直接取得
- GitHub からコードサンプル アーカイブをダウンロードし、アーカイブを展開します。
- ターミナル ウィンドウを開き、サンプル ファイルを展開したディレクトリに移動して、GoogleMaps ディレクトリにドリルダウンします。
Swift
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
Objective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
- 次のコマンドを実行します。
Swift
pod install open GoogleMapsSwiftDemos.xcworkspace
Objective-C
pod install open GoogleMapsDemos.xcworkspace
CocoaPods v1.6.1 を使用する
- CocoaPods ツールをまだインストールしていない場合は、ターミナルから次のコマンドを実行して、macOS にバージョン 1.6.1 をインストールします。詳しくは、CocoaPods のスタートガイドをご覧ください。
sudo gem install cocoapods -v1.6.1
- Cocoapods を使用して Google マップのファイルを取得します。
pod try GoogleMaps
プロンプトが表示されたら、Swift または Objective-C を選択します。CocoaPods が仕様リポジトリを更新し、
SwiftDemoApp.xcodeproj
またはObjCDemoApp.xcodeproj
という名前の一時的な Xcode プロジェクトでデモを開きます。
- Xcode でコンパイル ボタンをクリックしてビルドし、現在のスキームを実行します。ビルド時にエラーが発生し、Swift の場合は
SDKConstants.swift
ファイルに、Objective-C の場合はSDKDemoAPIKey.h
ファイルに API キーを入力するよう求められます。 - API キーをまだお持ちでない場合は、instructionsに沿って Google Cloud コンソールでプロジェクトを設定し、API キーを取得します。Cloud コンソールで鍵を構成するときに、アプリのバンドル ID を指定して、自分のアプリだけが鍵を使用できるようになります。SDK サンプルアプリのデフォルトのバンドル ID は
com.example.GoogleMapsDemos
です。 - Swift の場合は
SDKConstants.swift
ファイルを編集し、Objective-C の場合はSDKDemoAPIKey.h
ファイルを編集して、apiKey
定数またはkAPIKey
定数の定義に API キーを貼り付けます。次に例を示します。Swift
static let apiKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- ユーザー定義の問題の登録に使用するため、次の行を削除します。
Swift
#error (Register for API Key and insert here. Then delete this line.”)
Objective-C
#error Register for API Key and insert here.
- プロジェクトをビルドして実行します。iOS シミュレータ ウィンドウが開き、Maps SDK のデモのリストが表示されます。
- 表示されたオプションのいずれかを選択して、Maps SDK for iOS の機能を試します。
- GoogleMapsDemos に位置情報へのアクセスを許可するよう求められたら、[許可] を選択します。
デベロッパー ガイドのコード スニペットを使用する
デベロッパー ガイドの各ページには、API の具体的な機能を示したコード スニペットが掲載されています。サンプルについては、マップ オブジェクト、マーカー、シェイプに関するガイドと、このガイドの他のページをご覧ください。