セットアップとデモ

プラットフォームを選択: Android iOS

このページでは、 ユーティリティ ライブラリ をご覧ください

これらのユーティリティを試すには、次のいずれかを行います。

Maps SDK for iOS ユーティリティ ライブラリを Xcode プロジェクトに追加する

次の手順に従って、ユーティリティ ライブラリを Xcode ワークスペースに追加します。

Swift Package Manager を使用する

  1. Xcode プロジェクトがまだない場合は、ここで作成してローカルマシンに保存します。 (iOS 開発を初めて行う場合は、新しいプロジェクトを作成し、[iOS アプリ テンプレート。Xcode 11.7 以前では、シングルビュー アプリケーションを作成します)。
  2. Maps SDK for iOS を依存関係として追加します。詳しくは、 オプションについては、SDK のインストールをご覧ください。
  3. Xcode プロジェクトで、[File] ->Swift パッケージ ->パッケージの依存関係を追加する
  4. 表示されたウィンドウで、Maps SDK for iOS ユーティリティ ライブラリのリポジトリ URL を入力します。 https://github.com/googlemaps/google-maps-ios-utils] をクリックし、[次へ] を選択します。
    • この時点で、GitHub アカウントでの認証を求められる場合があります。詳しくは、 新しい P-MAX キャンペーンを GitHub 個人用アクセス トークンを付与してプロセスを続行します。
  5. 次のウィンドウで [Version] ラジオ オプションを選択し、[Up to Next Major Version] を選択します。 を選択して、Maps SDK for iOS ユーティリティ ライブラリの最新バージョンを入力します。 (「6.0.0」など)。
  6. [Add to Project] の横にあるプルダウンをクリックし、プロジェクトを選択して、[Add Package] を選択します。

CocoaPods を使用

  1. Xcode プロジェクトがまだない場合は、ここで作成して インストールします。(iOS 開発を初めて行う場合は、 アプリケーションを表示] をクリックします)。
  2. プロジェクト用の Pod ファイルがない場合は、 Podfile という名前のプロジェクト ディレクトリにあります。このファイルでは、 依存関係が存在します。
  3. プロジェクトの 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
  4. pod install を実行します。
  5. Xcode を閉じて、プロジェクトの Xcode を起動する .xcworkspace ファイル。これ以降 プロジェクトを開くために .xcworkspace ファイルを使用する必要があります。

注: マーカー クラスタリング ユーティリティは、 ですが、マーカー クラスタリングがなくても四分木を使用できます。目標 四分木ユーティリティのみであるため、この引数は pod 'Google-Maps-iOS-Utils'~ Pod ファイル内の 'Google-Maps-iOS-Utils/QuadTree'

アプリに API キーを追加する

生成手順については、Xcode プロジェクトをセットアップするをご覧ください。 Xcode プロジェクトに追加します。

プロジェクトをビルドして実行する

API キーを追加したら、プロジェクトをビルドして実行します。

アプリでユーティリティを使用する

アプリでユーティリティを使用する方法の詳細については、各ユーティリティのドキュメントをご覧ください。

デモアプリをインストールして実行する

ユーティリティ ライブラリにはデモアプリが含まれています。インストールすると、各ユーティリティを試すことができます。

次のいずれかの方法でデモアプリをインストールします。

GitHub のファイルを使用する

  1. ダウンロード コードサンプル アーカイブをご覧ください。 GitHub アーカイブを展開します。
  2. ターミナル ウィンドウを開き、サンプル ファイルを展開したディレクトリに移動します。 使用する言語の適切なサンプル ディレクトリまでドリルダウンします。 <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 を実行します。
  3. 次のコマンドを実行します。
    pod install
  4. Xcode を閉じて、プロジェクトの Xcode を起動する .xcworkspace ファイル。これ以降 プロジェクトを開くために .xcworkspace ファイルを使用する必要があります。

CocoaPods v1.6.1 を使用する

  1. ターミナル ウィンドウを開き、バージョン 1.6.1 をインストールします。
    sudo gem install cocoapods -v1.6.1
  2. Cocoapods を使用して Google マップのファイルを取得します。
    pod try Google-Maps-iOS-Utils

    プロンプトが表示されたら、Swift または Objective-C を選択します。CocoaPods が仕様リポジトリを更新して 次に、SwiftDemoApp.xcodeproj という名前の一時的な Xcode プロジェクトでデモを開きます。 または ObjCDemoApp.xcodeproj

デモアプリに API キーを追加する

[API キーの取得] で、 取得する必要があります。そのキーをデモアプリの Xcode プロジェクトに追加します。

Swift

次のように、API キーを AppDelegate.swift に追加します。

  1. 次の import ステートメントを追加します。
    import GoogleMaps
  2. 次の行を編集して、二重引用符の間に API キーを追加します。
    // Change this key to a valid key registered with the demo app bundle id.
    let mapsAPIKey = ""

Objective-C

次のように、API キーを AppDelegate.m に追加します。

  1. 次の import ステートメントを追加します。
    @import GoogleMaps;
  2. 次の行を編集して、二重引用符の間に 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 バージョンのデモを編集して、各ユーティリティを試すことができます。 詳しくは、後述のアプリにユーティリティを追加するをご覧ください。