Maps Android KTX

Maps Android Kotlin 拡張機能（KTX）には、Maps SDK for Android と Maps SDK for Android ユーティリティライブラリ用の Kotlin 拡張機能がまとめられています。これらの拡張機能を使用すると、Maps SDK for Android 向けの開発を行う際に、簡潔でわかりやすい Kotlin を作成するための Kotlin 言語機能を利用できます。Maps KTX はオープンソースで、例と合わせて GitHub で入手できます。

インストール

Maps SDK for Android 用と Maps SDK for Android ユーティリティライブラリ用（省略可）の KTX をインストールするには、build.gradle.kts ファイルに次の依存関係を追加します。

dependencies {

    // KTX for the Maps SDK for Android library
    implementation("com.google.maps.android:maps-ktx:5.1.1")
}

使用例

KTX ライブラリをインストールすると、拡張関数、名前付きパラメータとデフォルト引数、分解宣言、コルーチンなどの便利な Kotlin 言語機能を使用できるようになります。

コルーチンを使用して GoogleMap を取得する

GoogleMap へのアクセスは、コルーチンを使用して取得できます。

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    val mapFragment: SupportMapFragment? =
      supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
    val googleMap: GoogleMap? = mapFragment?.awaitMap()
  }
}

マーカーを追加する

マーカーを追加するには、DSL スタイルのメソッドの addMarker() を使用します。

val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
  position(sydney)
  title("Marker in Sydney")
}

カメラアクティビティを収集する

カメラの移動などのイベントは、Kotlin Flow で収集できます。

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    googleMap.cameraMoveEvents().collect {
      print("Received camera move event")
    }
  }
}

サポートされている機能の一覧は、リファレンスドキュメントでご確認いただけます。

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

このライブラリの GitHub リポジトリには、ご所有のアプリ内で Maps KTX ライブラリを使う方法を示すデモアプリケーションが含まれています。

このデモアプリケーションを試すには、次の手順を行います。

GitHub で、対象の ZIP ファイルのクローンを作成するか、ファイルをダウンロードします。
Android Studio で [File] -> [Open] を選択し、先ほどクローン作成かダウンロードしたファイルがあるディレクトリに移動して、そのフォルダを開きます。
デモアプリに API キーを追加します。

Maps SDK for Android キーを取得します。
ルートディレクトリで、secrets.properties というファイルを作成します。ご自身の API キーを守るため、このファイルはバージョン管理の対象にしてはいけません。
次の 1 行を secrets.properties に追加します。
```
MAPS_API_KEY="YOUR_API_KEY"
```
この行の YOUR_API_KEY は、最初の手順で取得した実際の API キーです。secrets.defaults.properties は一例としてご覧ください。

[Run configuration] で、モジュール app-ktx を選択します。
[Run 'app-ktx'] を選択します。

次のステップ

Google Maps Platform の次の Kotlin 拡張機能についても、利用をご検討ください。

Map SDK for Android ユーティリティライブラリ用 KTX
Places SDK for Android 用 KTX

Maps Android KTX コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。