GitHub の Maps SDK for iOS リポジトリには、iOS アプリで Maps SDK for iOS を使用する方法を示すサンプルが含まれています。サンプルアプリには、SDK の注目機能のコードが含まれています。アプリの作成の開始点として使用できます。
Maps SDK for iOS のサンプル リスト
以下は、デモアプリの主なサンプル アクティビティです。簡単な参照として、各サンプル アクティビティがリンク先のページで再現されています。利用可能なサンプルの一覧については、GitHub の サンプル フォルダをご覧ください。
- 基本地図を表示する
- マーカーの情報ウィンドウを表示する
- 地図にマーカーを追加する
- 位置情報をリバース ジオコーディングする
- 地図のジェスチャーを有効または無効にする
- マーカー イベントを処理する
- 現在地ボタンを有効にする
- 地図上にポリゴンを描画する
- 地図上にポリラインを描画する
完全なサンプルアプリをローカルで実行する
Maps SDK for iOS のサンプルアプリは、GitHub からダウンロード アーカイブとして入手できます。以下の手順に沿って、Maps SDK for iOS のサンプルアプリをインストールして試します。
git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git
を実行して、サンプル リポジトリのクローンをローカル ディレクトリに作成します。ターミナル ウィンドウを開き、サンプルファイルのクローンを作成したディレクトリに移動して、GoogleMaps ディレクトリにドリルダウンします。
Swift
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
pod install
open GoogleMapsSwiftDemos.xcworkspace
Objective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
pod install
open GoogleMapsDemos.xcworkspace
- Xcode でコンパイル ボタンを押して、現在のスキームでアプリをビルドします。ビルドでエラーが発生し、Swift の場合は
SDKConstants.swift
ファイル、Objective-C の場合はSDKDemoAPIKey.h
ファイルに API キーを入力するよう求められます。 - API キーをまだお持ちでない場合は、手順に沿って 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";
SDKConstants.swift
ファイル(Swift)またはSDKDemoAPIKey.h
ファイル(Objective-C)で、次の行を削除します。これは、ユーザー定義の問題の登録に使用される行です。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 に現在地へのアクセスを許可するよう求められたら、[許可] を選択します。