RxJava Library

  • The Maps Rx library enables the use of RxJava with the Maps SDK and Places SDK for Android to handle asynchronous events.

  • It provides observable sequences for events like marker clicks and camera movements, allowing developers to leverage RxJava features.

  • You can install the library by adding specific dependencies to your build.gradle file and rebuilding your project.

  • The library offers extension functions and operators to simplify the integration of RxJava with Google Maps functionality.

RxJava is a reactive programming library for composing asynchronous and event-based programs by using observable sequences.

The Maps Rx library lets you receive observable sequences for asynchronus events on the Maps SDK for Android and Places SDK for Android so you can take advantage of the rich set of RxJava features.

Installation

To install the Maps Rx library in your Google Maps project:

  1. Add the following dependencies to your module-level build.gradle file:

    dependencies {
    // RxJava bindings for the Maps SDK
    implementation(libs.maps.rx)

    // RxJava bindings for the Places SDK
    implementation(libs.places.rx)

    // It is recommended to also include the latest Maps SDK, Places SDK and RxJava so you
    // have the latest features and bug fixes.
    implementation(libs.play.services.maps)
    implementation(libs.places)
    implementation(libs.rxjava)
  2. Rebuild your project in Android Studio to sync these changes.

Example Usage

Receive an Observable for marker click events as an extension function on the GoogleMap object:

googleMap.markerClickEvents()
  .subscribe { marker ->
    Log.d("MapsRx", "Marker ${marker.title} was clicked")
  }

The next example shows you how you can use the RxJava operator, merge, to combine various camera events into a single Observable stream:

Observable.merge(
  googleMap.cameraIdleEvents(),
  googleMap.cameraMoveEvents(),
  googleMap.cameraMoveCanceledEvents(),
  googleMap.cameraMoveStartedEvents()
).subscribe {
  // Notified when any camera event occurs
}

What's next