コードサンプルの概要

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

Places SDK for iOS に付属している SDK デモアプリでは、Place Autocomplete やプレイス写真など、さまざまな機能を紹介しています。また、このデベロッパー ガイドの各ページでもコード スニペットをご確認いただけます。

CocoaPods を使って SDK のデモを試す

Places SDK for iOS は、CocoaPods Pod として入手できます。CocoaPods は、Swift プロジェクトと Objective-C Cocoa プロジェクトのオープンソース依存関係マネージャーです。

Places SDK for iOS には、pod try コマンドを使用してインストール、実行できる SDK デモアプリ一式が用意されています。

CocoaPods をインストールして、Places SDK for iOS を試す手順は次のとおりです。

  1. CocoaPods ツールがない場合は、ターミナルから以下のコマンドを実行して、macOS 上に CocoaPods ツールをインストールします。詳細については、CocoaPods スタートガイドをご覧ください。 
    sudo gem install cocoapods
  2. 次の 2 つの方法のいずれかを使用してサンプル ファイルを取得します。

    GitHub のファイルを使用する

    1. GitHub からコードサンプル アーカイブをダウンロードして、アーカイブを展開します。
    2. ターミナル ウィンドウを開いて、サンプル ファイルを展開したディレクトリに移動し、GooglePlaces ディレクトリまでドリルダウンします。

      Swift

      cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-master/GooglePlaces
    3. 次のコマンドを実行します。
      pod install
      
open GooglePlacesDemos.xcworkspace

    CocoaPods v1.6.1 を使用する

    1. ターミナル ウィンドウを開き、バージョン 1.6.1 をインストールします。 
      sudo gem install cocoapods -v1.6.1
    2. CocoaPods を使用して Google プレイス ファイルを取得する: 
      pod try GooglePlaces

      CocoaPods が仕様リポジトリを更新してから、一時的な Xcode プロジェクト GooglePlacesDemos.xcworkspace で SDK デモを開きます。

  3. Google Cloud Console プロジェクトで Places SDK for iOS を有効にします。
  4. まだ API キーをお持ちでない場合は、こちらの手順に沿って Cloud Console にプロジェクトを設定し、API キーを取得します。Cloud Console で鍵を構成するときに、アプリのバンドル ID を指定して、アプリのみが鍵を使用できるようにすることができます。SDK サンプルアプリのデフォルトのバンドル ID は com.example.GooglePlacesDemos です。
  5. SDKDemoAPIKey ファイルを編集して、API キーを適切な定数に貼り付けます。次に例を示します。

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. 編集のために SDKDemoAPIKey ファイルのロック解除を求めるメッセージが Xcode に表示された場合は、[Unlock] を選択します。
  7. 存在する場合は、次の行を削除します。これは、問題の登録に使用されるためです。

    Swift

    #error （API キーを登録してここに挿入）この行を削除します。」

    Objective-C

    #error Register your API key and insert here, then delete this line.
  8. 再度、プロジェクトをビルドして実行します。
  9. ビルドが失敗するか、アプリの初回実行時に API キーに関するエラーが発生してアプリがクラッシュする場合は、SDKDemoAPIKey ファイルに必要なキーが渡されていることを確認してください。
  10. GooglePlaces デモを実行している場合、iOS シミュレータ ウィンドウに Places デモのリストが表示されます。
  11. GooglePlacesDemos に位置情報へのアクセスを許可するよう求められたら、[許可] を選択します。
  12. これで、選択したサンプルを実行できます。

デベロッパー ガイドのコード スニペットを使用する

デベロッパー ガイドの各ページには、API の特定の機能を示すコード スニペットが含まれています。たとえば、このガイドのオートコンプリート、現在の場所を取得する、写真などのガイドをご覧ください。