Places SDK for iOS のコードサンプル

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

Places SDK for iOS に付属の GitHub の Places SDK for iOS デモアプリでは、Place Autocomplete や Place Photos など、さまざまな機能が紹介されています。また、このデベロッパー ガイドの各ページにコード スニペットも用意されています。このアプリをインポートしてビルドし、API キーを追加してデモを確認し、サンプルコードを使用してご自身のアプリの出発点とすることができます。

サンプルアプリを実行すると、ご自身のデバイスで実行可能なサンプルのリストが表示されます。選択肢の中から 1 つ選びます。

完全なサンプルアプリをローカルで実行する

Places SDK for iOS のサンプルアプリは、GitHub からダウンロード アーカイブとして入手できます。Places SDK for iOS のサンプルアプリをインストールして試すには、次の手順に沿って操作します。

  1. GitHub からコード サンプル アーカイブをダウンロードし、アーカイブを解凍します。または、リポジトリをローカル ディレクトリにクローンします。
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git

  2. ターミナル ウィンドウを開き、サンプル ファイルを展開したディレクトリに移動して、使用するバージョンのディレクトリに移動します。

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. Xcode プロジェクトで、[File] > [Add Package Dependencies] に移動します。URL として https://github.com/googlemaps/ios-places-sdk を入力し、Enter キーを押してパッケージをプルし、[パッケージを追加] をクリックします。
  4. Google Cloud コンソール プロジェクトで Places SDK for iOS と Maps SDK for iOS を有効にします。
  5. Places API または Places API (New) が有効になっているプロジェクトから API キーを取得します。
  6. 以下の適切な手順に沿って、API キーをアプリに追加します。

    SwiftUI

    デモアプリの Info.plist ファイル（GooglePlacesDemos/GooglePlacesDemos）と同じディレクトリに、API キー用の GooglePlacesDemos.xcconfig という名前のローカル構成ファイルを作成します。

    構成ファイルに 2 行を追加して、API キーを定義します。

    PLACES_API_KEY = YOUR_PLACES_API_KEY と MAPS_API_KEY = YOUR_MAPS_API_KEY。

    YOUR_PLACES_API_KEY と YOUR_MAPS_API_KEY は、前の手順で取得した API キーに置き換えます。

    ローカル構成ファイルの作成については、構成設定ファイル（xcconfig）の形式をご覧ください。

    Swift

    SDKDemoAPIKey ファイルを編集し、API キーを適切な定数に貼り付けます。次に例を示します。

    let placesAPIKey = "YOUR_API_KEY"

    次の行が存在する場合は、削除します。

    #error (Register for API Key and insert here. Then delete this line.)

    Xcode で SDKDemoAPIKey ファイルのロックを解除して編集するよう求められたら、[Unlock] を選択します。

    Objective-C

    SDKDemoAPIKey ファイルを編集し、API キーを適切な定数に貼り付けます。次に例を示します。

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    次の行が存在する場合は、削除します。

    #error (Register for API Key and insert here. Then delete this line.)

    Xcode で SDKDemoAPIKey ファイルのロックを解除して編集するよう求められたら、[Unlock] を選択します。

  7. アプリをビルドします。
  8. ビルドが失敗した場合や、アプリを初めて実行したときに API キーに関するエラーでクラッシュした場合は、上記の手順で必要なキーを指定していることを確認してください。
  9. サンプルアプリを実行すると、iOS シミュレータ ウィンドウに Places デモのリストが表示されます。
  10. デモアプリに位置情報へのアクセスを許可するよう求められたら、[許可] を選択します。
  11. これで、選択したサンプルを実行できます。