Places Android KTX の概要と設定

Places Android KTX は、Places SDK for Android 用の Kotlin 拡張機能のコレクションです。これらの拡張機能を使用すると、Places SDK for Android 向けの開発を行う際に、簡潔でわかりやすい Kotlin を作成するための Kotlin 言語機能を利用できます。Places KTX はオープンソースで、サンプルとともに GitHub で入手できます。

Places SDK 用の KTX をインストールする

Places SDK for Android 用の KTX をインストールするには、アプリレベルの build.gradle ファイルに次の依存関係を追加します。

dependencies {
    implementation 'com.google.maps.android:places-ktx:0.4.0'
}

Maps SDK V3 ベータ版で Places 静的ライブラリを使用している場合は、代わりにアプリレベルの build.gradle ファイルに次の依存関係を追加します。

dependencies {
    implementation 'com.google.maps.android:places-v3-ktx:0.4.0'
}

サンプル アプリケーションを試す

このライブラリの GitHub リポジトリには、Places KTX ライブラリを独自のアプリで使用する方法を示すデモ アプリケーションも含まれています。

選択肢が表示されている Places KTX サンプルアプリの最初の画面
Places Search デモアプリの画面

デモ アプリケーションを試す手順は次のとおりです。

  1. GitHub から、ZIP ファイルのクローンを作成するか、ZIP ファイルをダウンロードします。
  2. Android Studio で [File] -> [Open] を選択し、ディレクトリに移動して、クローンを作成またはダウンロードしたフォルダを開きます。
  3. デモアプリに API キーを追加します。
    1. Places API キーを取得します。
    2. ルート ディレクトリに secure.properties というファイルを作成します。API キーを保護するため、このファイルはバージョン管理しないでください。
    3. 次の 1 行を secure.properties
      PLACES_API_KEY=”YOUR_API_KEY”
      に追加します。ここで、YOUR_API_KEY は最初のステップで取得した実際の API キーです。例として secure.properties.template をご覧ください。
  4. 実行構成で、モジュール [app] を選択します。
  5. [Run 'app'] を選択します。