コードサンプルの概要

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

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

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

Places SDK for iOS は CocoaPods ポッドとして提供されています。CocoaPods は、Swift と Objective-C の Cocoa プロジェクト向けのオープンソースの依存関係マネージャーです。

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

以下の手順に沿って CocoaPods をインストールし、Places SDK for iOS をお試しください。

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

    GitHub のファイルを使用する

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

      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 キーをまだお持ちでない場合は、instructionsに沿って Cloud コンソールでプロジェクトを設定し、API キーを取得します。Cloud コンソールで鍵を構成するときに、アプリのバンドル 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 がプロンプトを表示する場合は、[ロック解除] を選択します。
  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 の具体的な機能を示したコード スニペットが掲載されています。たとえば、オートコンプリート現在の場所を取得する写真などのガイドや、このガイドの他のページをご覧ください。