[Video](https://www.youtube.com/watch?v=AgGE7fAMrdA)

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

The [Places Rx library](https://github.com/googlemaps/android-maps-rx)
lets you receive observable sequences for asynchronous 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

> [!NOTE]
> **Note:** See the [Places Rx library](https://github.com/googlemaps/android-maps-rx) documentation on GitHub for system requirements and installation instructions.

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

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

   <br />

   ```yaml
       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("com.google.android.gms:play-services-maps:20.0.0")
       implementation("com.google.android.libraries.places:places:5.3.0")
       implementation("io.reactivex.rxjava3:rxjava:3.1.12")
   ```

   <br />

2. Rebuild your project in Android Studio to sync these changes.

## Example usage

Receive a
[Single](https://reactivex.io/documentation/single.html) and
subscribe to it when fetching place details:

```yaml
    placesClient.fetchPlace(
        placeId = "thePlaceId",
        placeFields = listOf(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS),
        actions = {},
    ).subscribe(
        { response ->
            Log.d("PlacesRx", "Successfully got place ${response.place.id}")
        },
        { error ->
            Log.e("PlacesRx", "Could not get place: ${error.message}")
        },
    )
}
```

## What's next

- See the [Places Rx library](https://github.com/googlemaps/android-maps-rx) GitHub project page.
- See the [Places Rx library API reference](https://googlemaps.github.io/android-maps-rx/).