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 コンソールでキーを構成するときに、サンプルアプリのバンドル識別子にキーを制限して、自分のアプリだけがそのキーを使用できるようにすることができます。SDK のサンプルアプリのデフォルトのバンドル識別子は
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 デモの一覧が表示されます。
- 表示されるオプションからいずれか 1 つを選び、Maps SDK for iOS の機能を試します。
- GoogleMapsDemos が位置情報にアクセスするのを許可するよう求められたら、[許可] を選択します。