با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
RxJava یک کتابخانه برنامه نویسی واکنشی برای نوشتن برنامه های ناهمزمان و مبتنی بر رویداد با استفاده از توالی های قابل مشاهده است.
کتابخانه Maps Rx به شما امکان می‌دهد توالی‌های قابل مشاهده را برای رویدادهای ناهمزمان در Maps SDK برای Android و Places SDK برای Android دریافت کنید تا بتوانید از مجموعه غنی ویژگی‌های RxJava استفاده کنید.
نصب و راه اندازی
برای نصب کتابخانه Maps Rx در پروژه Google Maps:
وابستگی های زیر را به فایل build.gradle سطح ماژول خود اضافه کنید:
dependencies {// RxJava bindings for the Maps SDKimplementation("com.google.maps.android:maps-rx:1.0.0")// RxJava bindings for the Places SDKimplementation("com.google.maps.android:places-rx:1.0.0")// 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:19.2.0")implementation("com.google.android.libraries.places:places:4.4.1")implementation("io.reactivex.rxjava3:rxjava:3.1.11")
برای همگام سازی این تغییرات، پروژه خود را در Android Studio بازسازی کنید.
مثال استفاده
یک Observable برای رویدادهای کلیک نشانگر به عنوان یک تابع افزونه در شی GoogleMap دریافت کنید:
googleMap.markerClickEvents().subscribe { marker ->
Log.d("MapsRx", "Marker ${marker.title} was clicked")}
مثال بعدی به شما نشان می دهد که چگونه می توانید از عملگر RxJava، merge ، برای ترکیب رویدادهای مختلف دوربین در یک جریان قابل مشاهده استفاده کنید:
Observable.merge(googleMap.cameraIdleEvents(),googleMap.cameraMoveEvents(),googleMap.cameraMoveCanceledEvents(),googleMap.cameraMoveStartedEvents()).subscribe {// Notified when any camera event occurs}
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Maps Rx library enables the use of RxJava with the Maps SDK and Places SDK for Android to handle asynchronous events.\u003c/p\u003e\n"],["\u003cp\u003eIt provides observable sequences for events like marker clicks and camera movements, allowing developers to leverage RxJava features.\u003c/p\u003e\n"],["\u003cp\u003eYou can install the library by adding specific dependencies to your \u003ccode\u003ebuild.gradle\u003c/code\u003e file and rebuilding your project.\u003c/p\u003e\n"],["\u003cp\u003eThe library offers extension functions and operators to simplify the integration of RxJava with Google Maps functionality.\u003c/p\u003e\n"]]],["The Maps Rx library, designed for use with RxJava, allows developers to receive observable sequences for asynchronous events on the Maps SDK and Places SDK for Android. To install, add dependencies for `maps-rx`, `places-rx`, and the latest `Maps SDK`, `Places SDK`, and `RxJava` to the `build.gradle` file, then rebuild the project. Developers can subscribe to events, like marker clicks, using extension functions. The library also supports merging multiple event types, such as various camera events, into a single observable stream using RxJava operators.\n"],null,["RxJava is a reactive programming library for composing asynchronous and event-based programs by\nusing observable sequences.\n\nThe [Maps Rx library](https://github.com/googlemaps/android-maps-rx)\nlets you receive observable sequences for asynchronus events on the Maps SDK for Android\nand Places SDK for Android so you can take advantage of the rich set of RxJava features.\n\nInstallation **Note:** See the [Maps Rx library](https://github.com/googlemaps/android-maps-rx) documentation on GitHub for the latest system requirements and installation instructions.\n\nTo install the Maps Rx library in your Google Maps project:\n\n1. Add the following dependencies to your module-level `build.gradle` file:\n\n ```yaml\n dependencies {\n // RxJava bindings for the Maps SDK\n implementation(\"com.google.maps.android:maps-rx:1.0.0\")\n\n // RxJava bindings for the Places SDK\n implementation(\"com.google.maps.android:places-rx:1.0.0\")\n\n // It is recommended to also include the latest Maps SDK, Places SDK and RxJava so you\n // have the latest features and bug fixes.\n implementation(\"com.google.android.gms:play-services-maps:19.2.0\")\n implementation(\"com.google.android.libraries.places:places:4.4.1\")\n implementation(\"io.reactivex.rxjava3:rxjava:3.1.11\")\n ```\n2. Rebuild your project in Android Studio to sync these changes.\n\nExample Usage\n\nReceive an Observable for marker click events as an extension function on the GoogleMap object: \n\n```yaml\ngoogleMap.markerClickEvents()\n .subscribe { marker -\u003e\n Log.d(\"MapsRx\", \"Marker ${marker.title} was clicked\")\n }\n```\n\nThe next example shows you how you can use the RxJava operator, `merge`, to combine\nvarious camera events into a single Observable stream: \n\n```yaml\nObservable.merge(\n googleMap.cameraIdleEvents(),\n googleMap.cameraMoveEvents(),\n googleMap.cameraMoveCanceledEvents(),\n googleMap.cameraMoveStartedEvents()\n).subscribe {\n // Notified when any camera event occurs\n}\n```\n\nWhat's next\n\n- View the [Maps Rx library](https://github.com/googlemaps/android-maps-rx) GitHub project page.\n- View the [Maps Rx library API reference](https://googlemaps.github.io/android-maps-rx/)."]]
