feat: updated places 5.0.0 (#960)

* feat: Overhaul snippets app into a multi-activity demo

This commit transforms the snippets project from a single-activity example into a comprehensive, multi-activity demonstration app. It now serves as a catalog of Places SDK features, with separate, self-contained examples for both Java and Kotlin.

Key changes:

- **New App Structure**:
  - `KotlinMainActivity` is the new launcher, presenting a `RecyclerView` of available demos. A parallel `JavaMainActivity` is also included.
  - A `MainApplication` class now handles the centralized initialization of the Places SDK.
  - The app now supports an edge-to-edge display theme.

- **New Demo Activities**:
  - **Current Place**: Finds and displays a list of likely places near the user's current location, handling permission requests.
  - **Place Autocomplete**: Demonstrates the `AutocompleteSupportFragment`, the autocomplete intent, and programmatic predictions, with a toggle for location bias vs. restriction.
  - **Place Details**: Fetches and displays basic details for a specific Place ID.
  - **Place Photos**: Fetches and displays a photo and its attributions for a place.
  - **Places Icon**: Shows how to retrieve and display a place's icon mask and background color.
  - **Is Open**: Checks if a place is open, using both a `Place` object and a Place ID.

- **UI and Layouts**:
  - Added dedicated XML layouts for each new activity and for `RecyclerView` list items.
  - Implemented standard UI patterns with `MaterialToolbar`, `RecyclerView`, and `ConstraintLayout`.

- **Build & Dependency Updates**:
  - Upgraded Gradle to version 9.1.0.
  - Updated various AndroidX and Material Design library versions.
  - Added `core-ktx` dependency.

* feat: updated places to 5.0.0

* feat: added PlaceDetailsCompose

* feat: added PlaceDetailsUIKit

* feat: added PlacesUIKit3D

* feat: snippets

* feat: updated CurrentPlace, PlaceDetails

* feat: header

* feat: place autocomplete

* fix: removed duplicated

---------

Co-authored-by: dkhawk <107309+dkhawk@users.noreply.github.com>

Author: kikoso

PlaceDetailsCompose/app/build.gradle.kts

@@ -116,6 +116,7 @@ dependencies {
     implementation(libs.androidx.activity.compose)
     implementation(libs.androidx.lifecycle.viewmodel.compose)
     implementation(libs.androidx.fragment.ktx)
+    implementation(libs.androidx.compose.material.icons.core)
 
     // --- Google Play Services ---
     // These are the essential libraries for this sample, providing Maps and Places functionality.

PlaceDetailsCompose/gradle/libs.versions.toml

@@ -7,28 +7,27 @@
 # --- Core Android & Kotlin ---
 # These are the fundamental versions for building the Android app.
 agp = "8.13.0"
-kotlin = "2.2.10"
+kotlin = "2.2.20"
 coreKtx = "1.17.0"
 fragmentKtx = "1.8.9"
 material = "1.13.0"
-lifecycleViewModelCompose = "2.9.3"
+lifecycleViewModelCompose = "2.9.4"
+material-icons = "1.7.8"
 
 # --- Jetpack Compose ---
 # Versions for Jetpack Compose, Android's modern UI toolkit.
 # The Compose BOM (Bill of Materials) manages the versions of different Compose libraries
 # to ensure they are compatible with each other.
-composeBom = "2025.08.01"
-activityCompose = "1.10.1"
-ui = "1.9.0"
-uiTooling = "1.9.0"
-uiViewbinding = "1.9.0"
+composeBom = "2025.09.01"
+activityCompose = "1.11.0"
+androidxUi = "1.9.2"
 
 # --- Google Services (Maps, Places, Location) ---
 # Versions for Google Play Services libraries, which are essential for this sample.
 googleMaps = "19.2.0"
-places = "4.4.1"
+places = "5.0.0"
 playServicesLocation = "21.3.0" # Required for the FusedLocationProviderClient to get the device's location.
-mapsCompose = "6.10.0"
+mapsCompose = "6.11.0"
 
 # --- Testing ---
 # Versions for testing libraries.
@@ -50,16 +49,17 @@ androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref =
 androidx-lifecycle-viewmodel-compose = { group = "androidx.lifecycle", name = "lifecycle-viewmodel-compose", version.ref = "lifecycleViewModelCompose" }
 androidx-fragment-ktx = { group = "androidx.fragment", name = "fragment-ktx", version.ref = "fragmentKtx" }
 material = { group = "com.google.android.material", name = "material", version.ref = "material" }
+androidx-compose-material-icons-core = { module = "androidx.compose.material:material-icons-core", version.ref = "material-icons" }
 
 # --- Jetpack Compose ---
 # The Compose BOM (Bill of Materials) simplifies dependency management by coordinating the versions of various Compose libraries.
 # By using platform(), we don't need to specify versions for individual Compose artifacts.
 androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }
 androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
 androidx-material3 = { group = "androidx.compose.material3", name = "material3" }
-androidx-ui-tooling = { group = "androidx.compose.ui", name = "ui-tooling", version.ref = "uiTooling" }
-androidx-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview", version.ref = "ui" }
-androidx-ui-viewbinding = { group = "androidx.compose.ui", name = "ui-viewbinding", version.ref = "uiViewbinding" }
+androidx-ui-tooling = { group = "androidx.compose.ui", name = "ui-tooling", version.ref = "androidxUi" }
+androidx-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview", version.ref = "androidxUi" }
+androidx-ui-viewbinding = { group = "androidx.compose.ui", name = "ui-viewbinding", version.ref = "androidxUi" }
 
 # --- Google Services (Maps, Places, Location) ---
 # These are the key libraries for this sample app, providing map, place details, and location functionalities.

PlaceDetailsUIKit/gradle/libs.versions.toml

@@ -14,11 +14,11 @@ targetSdk = "36"
 # --- Core Android & Kotlin ---
 # These are the fundamental versions for building the Android app.
 agp = "8.13.0"
-kotlin = "2.2.10"
+kotlin = "2.2.20"
 coreKtx = "1.17.0"
 appcompat = "1.7.1"
-activity = "1.10.1"
-lifecycle = "2.9.3"
+activity = "1.11.0"
+lifecycle = "2.9.4"
 fragmentKtx = "1.8.9"
 material = "1.13.0"
 constraintlayout = "2.2.1"
@@ -27,15 +27,14 @@ constraintlayout = "2.2.1"
 # Versions for Jetpack Compose, Android's modern UI toolkit.
 # The Compose BOM (Bill of Materials) manages the versions of different Compose libraries
 # to ensure they are compatible with each other.
-composeBom = "2025.08.01"
-activityCompose = "1.10.1"
-ui = "1.9.0"
-uiTooling = "1.9.0"
+composeBom = "2025.09.01"
+activityCompose = "1.11.0"
+ui = "1.9.2"
 
 # --- Google Services (Maps, Places, Location) ---
 # Versions for Google Play Services libraries, which are essential for this sample.
 googleMaps = "19.2.0"
-places = "4.4.1"
+places = "5.0.0"
 playServicesLocation = "21.3.0" # Required for the FusedLocationProviderClient to get the device's location.
 
 # --- Testing ---
@@ -68,7 +67,7 @@ androidx-constraintlayout = { group = "androidx.constraintlayout", name = "const
 androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }
 androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
 androidx-material3 = { group = "androidx.compose.material3", name = "material3" }
-androidx-ui-tooling = { group = "androidx.compose.ui", name = "ui-tooling", version.ref = "uiTooling" }
+androidx-ui-tooling = { group = "androidx.compose.ui", name = "ui-tooling", version.ref = "ui" }
 androidx-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview", version.ref = "ui" }
 
 # --- Google Services (Maps, Places, Location) ---

PlacesUIKit3D/gradle/libs.versions.toml

@@ -7,42 +7,42 @@
 # --- Core Android & Kotlin ---
 # These are the fundamental versions for building the Android app.
 agp = "8.13.0"
-kotlin = "2.2.10"
+kotlin = "2.2.20"
 coreKtx = "1.17.0"
-lifecycleRuntimeKtx = "2.9.3"
+lifecycleRuntimeKtx = "2.9.4"
 fragmentKtx = "1.8.9"
 material = "1.13.0"
 
 # --- Jetpack Compose ---
 # Versions for Jetpack Compose, Android's modern UI toolkit.
 # The Compose BOM (Bill of Materials) manages the versions of different Compose libraries
 # to ensure they are compatible with each other.
-composeBom = "2025.08.01"
-activityCompose = "1.10.1"
+composeBom = "2025.09.01"
+activityCompose = "1.11.0"
 fragmentCompose = "1.8.9"
 
 # --- Google Services (Maps, Places, Location) ---
 # Versions for Google Play Services libraries, which are essential for this sample.
 playServicesMaps3d = "0.0.2"
-places = "4.4.1"
+places = "5.0.0"
 mapsUtilsKtx = "5.2.0"
 
 # --- Dependency Injection ---
 # Version for Hilt, a dependency injection library for Android.
-hilt = "2.57.1"
+hilt = "2.57.2"
 
 # --- Testing ---
 # Versions for testing libraries.
 junit = "4.13.2"
 junitVersion = "1.3.0"
 espressoCore = "3.7.0"
-truth = "1.4.4"
+truth = "1.4.5"
 
 # --- Gradle Plugins ---
 # Versions for Gradle plugins used in the build process.
 secretsGradlePlugin = "2.0.1"
-ksp = "2.2.10-2.0.2"
-kotlinParcelize = "2.2.10"
+ksp = "2.2.20-2.0.3"
+kotlinParcelize = "2.2.20"
 
 # --- Miscellaneous ---
 # Other libraries used in the project.

demo-java/app/src/main/java/com/example/placesdemo/AutocompleteAddressActivity.java

@@ -52,6 +52,7 @@
 import com.google.android.libraries.places.api.model.AddressComponent;
 import com.google.android.libraries.places.api.model.AddressComponents;
 import com.google.android.libraries.places.api.model.Place;
+import com.google.android.libraries.places.api.model.PlaceTypes;
 import com.google.android.libraries.places.api.net.PlacesClient;
 import com.google.android.libraries.places.widget.Autocomplete;
 import com.google.android.libraries.places.widget.model.AutocompleteActivityMode;

demo-kotlin/app/build.gradle.kts

@@ -19,6 +19,7 @@ plugins {
     alias(libs.plugins.jetbrains.kotlin.android)
     alias(libs.plugins.secrets.gradle.plugin)
     alias(libs.plugins.jetbrains.kotlin.parcelize)
+    kotlin("kapt")
 }
 
 android {
@@ -54,6 +55,7 @@ dependencies {
 
     implementation(libs.volley)
     implementation(libs.glide)
+    kapt(libs.glide.compiler)
     implementation(libs.viewbinding)
     implementation(libs.multidex)
 

demo-kotlin/app/src/main/java/com/example/placesdemo/AutocompleteAddressActivity.kt

@@ -86,7 +86,7 @@ class AutocompleteAddressActivity : BaseActivity(),
                 // The user canceled the operation.
                 Log.i(TAG, "User canceled autocomplete")
             }
-        } as ActivityResultCallback<ActivityResult>)
+        })
     // [END maps_solutions_android_autocomplete_define]
 
     // [START maps_solutions_android_autocomplete_intent]

demo-kotlin/app/src/main/java/com/example/placesdemo/CurrentPlaceActivity.kt

@@ -25,11 +25,13 @@ import androidx.activity.result.contract.ActivityResultContracts
 import androidx.annotation.RequiresPermission
 import androidx.core.content.ContextCompat
 import com.example.placesdemo.databinding.CurrentPlaceActivityBinding
+import com.google.android.gms.maps.model.LatLng
 import com.google.android.libraries.places.api.Places
+import com.google.android.libraries.places.api.model.CircularBounds
 import com.google.android.libraries.places.api.model.Place
-import com.google.android.libraries.places.api.net.FindCurrentPlaceRequest
-import com.google.android.libraries.places.api.net.FindCurrentPlaceResponse
 import com.google.android.libraries.places.api.net.PlacesClient
+import com.google.android.libraries.places.api.net.SearchNearbyRequest
+import com.google.android.libraries.places.api.net.SearchNearbyResponse
 
 /**
  * Activity to demonstrate [PlacesClient.findCurrentPlace].
@@ -40,6 +42,9 @@ class CurrentPlaceActivity : BaseActivity() {
 
     private lateinit var binding: CurrentPlaceActivityBinding
 
+    val boulderCenter = LatLng(40.01499, -105.27055)
+    val radiusMeters = 5000.0
+
     @SuppressLint("MissingPermission")
     val requestPermissionLauncher =
         registerForActivityResult(
@@ -145,9 +150,9 @@ class CurrentPlaceActivity : BaseActivity() {
     @RequiresPermission(allOf = [permission.ACCESS_FINE_LOCATION, permission.ACCESS_WIFI_STATE])
     private fun findCurrentPlaceWithPermissions() {
         setLoading(true)
-        val currentPlaceRequest = FindCurrentPlaceRequest.newInstance(placeFields)
-        val currentPlaceTask = placesClient.findCurrentPlace(currentPlaceRequest)
-        currentPlaceTask.addOnSuccessListener { response: FindCurrentPlaceResponse? ->
+        val currentPlaceRequest = SearchNearbyRequest.newInstance(CircularBounds.newInstance(boulderCenter, radiusMeters), placeFields)
+        val currentPlaceTask = placesClient.searchNearby(currentPlaceRequest)
+        currentPlaceTask.addOnSuccessListener { response: SearchNearbyResponse? ->
             response?.let {
                 binding.response.text = StringUtil.stringify(it, isDisplayRawResultsChecked)
             }

demo-kotlin/app/src/main/java/com/example/placesdemo/PlaceAutocompleteActivity.kt

@@ -37,9 +37,9 @@ import com.google.android.libraries.places.api.model.RectangularBounds
 import com.google.android.libraries.places.api.net.FindAutocompletePredictionsRequest
 import com.google.android.libraries.places.api.net.FindAutocompletePredictionsResponse
 import com.google.android.libraries.places.api.net.PlacesClient
-import com.google.android.libraries.places.widget.Autocomplete
-import com.google.android.libraries.places.widget.AutocompleteActivity
+import com.google.android.libraries.places.widget.PlaceAutocompleteActivity
 import com.google.android.libraries.places.widget.AutocompleteSupportFragment
+import com.google.android.libraries.places.widget.PlaceAutocomplete
 import com.google.android.libraries.places.widget.listener.PlaceSelectionListener
 import com.google.android.libraries.places.widget.model.AutocompleteActivityMode
 
@@ -140,14 +140,14 @@ class PlaceAutocompleteActivity : BaseActivity() {
             RESULT_OK -> {
                 val data: Intent? = result.data
                 if (data != null) {
-                    val place = Autocomplete.getPlaceFromIntent(data)
+                    val place = PlaceAutocomplete.getPredictionFromIntent(data)
                     binding.response.text =
-                        StringUtil.stringifyAutocompleteWidget(place, isDisplayRawResultsChecked)
+                        StringUtil.stringifyAutocompletePrediction(place, isDisplayRawResultsChecked)
                 }
             }
-            AutocompleteActivity.RESULT_ERROR -> {
-                val status = Autocomplete.getStatusFromIntent(intent)
-                binding.response.text = status.statusMessage
+            PlaceAutocompleteActivity.RESULT_ERROR -> {
+                val status = PlaceAutocomplete.getResultStatusFromIntent(intent)
+                binding.response.text = status?.statusMessage
             }
             RESULT_CANCELED -> {
                 // The user canceled the operation.
@@ -156,9 +156,8 @@ class PlaceAutocompleteActivity : BaseActivity() {
     }
 
     private fun startAutocompleteActivity() {
-        val autocompleteIntent = Autocomplete.IntentBuilder(mode, placeFields)
+        val autocompleteIntent = PlaceAutocomplete.IntentBuilder()
             .setInitialQuery(query)
-            .setHint(hint)
             .setCountries(countries)
             .setLocationBias(locationBias)
             .setLocationRestriction(locationRestriction)
@@ -269,6 +268,7 @@ class PlaceAutocompleteActivity : BaseActivity() {
         else emptyList()
     }
 
+    // This Enum is deprecated, but there is no replacement. See https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/widget/model/AutocompleteActivityMode
     private val mode: AutocompleteActivityMode
         get() {
             val isOverlayMode =

demo-kotlin/app/src/main/java/com/example/placesdemo/PlaceDetailsAndPhotosActivity.kt

@@ -15,7 +15,6 @@
  */
 package com.example.placesdemo
 
-import android.graphics.Bitmap
 import android.os.Bundle
 import android.text.TextUtils
 import android.view.View
@@ -30,10 +29,10 @@ import com.example.placesdemo.databinding.PlaceDetailsAndPhotosActivityBinding
 import com.google.android.libraries.places.api.Places
 import com.google.android.libraries.places.api.model.PhotoMetadata
 import com.google.android.libraries.places.api.model.Place
-import com.google.android.libraries.places.api.net.FetchPhotoRequest
-import com.google.android.libraries.places.api.net.FetchPhotoResponse
 import com.google.android.libraries.places.api.net.FetchPlaceRequest
 import com.google.android.libraries.places.api.net.FetchPlaceResponse
+import com.google.android.libraries.places.api.net.FetchResolvedPhotoUriRequest
+import com.google.android.libraries.places.api.net.FetchResolvedPhotoUriResponse
 import com.google.android.libraries.places.api.net.PlacesClient
 
 /**
@@ -167,7 +166,7 @@ class PlaceDetailsAndPhotosActivity : BaseActivity() {
         if (!TextUtils.isEmpty(customPhotoReference)) {
             localPhotoMetadata = PhotoMetadata.builder(customPhotoReference).build()
         }
-        val photoRequestBuilder = FetchPhotoRequest.builder(localPhotoMetadata!!)
+        val photoRequestBuilder = FetchResolvedPhotoUriRequest.builder(localPhotoMetadata!!)
         val maxWidth = readIntFromTextView(binding.photoMaxWidth)
         if (maxWidth != null) {
             photoRequestBuilder.maxWidth = maxWidth
@@ -176,11 +175,18 @@ class PlaceDetailsAndPhotosActivity : BaseActivity() {
         if (maxHeight != null) {
             photoRequestBuilder.maxHeight = maxHeight
         }
-        val photoTask = placesClient.fetchPhoto(photoRequestBuilder.build())
-        photoTask.addOnSuccessListener { response: FetchPhotoResponse ->
-            val bitmap = response.bitmap
-            binding.photo.setImageBitmap(bitmap)
-            StringUtil.prepend(binding.photoMetadata, StringUtil.stringify(bitmap))
+        val photoTask = placesClient.fetchResolvedPhotoUri(photoRequestBuilder.build())
+        photoTask.addOnSuccessListener { response: FetchResolvedPhotoUriResponse ->
+            val uri = response.uri
+            if (uri != null) {
+                Glide.with(binding.photo.context)
+                    .load(uri)
+                    .into(binding.photo)
+
+                StringUtil.prepend(binding.photoMetadata, StringUtil.stringify(uri))
+            } else {
+                StringUtil.prepend(binding.photoMetadata, "No photo available")
+            }
         }
         photoTask.addOnFailureListener { exception: Exception ->
             exception.printStackTrace()
@@ -289,4 +295,4 @@ class PlaceDetailsAndPhotosActivity : BaseActivity() {
     companion object {
         private const val FETCHED_PHOTO_KEY = "photo_image"
     }
-}
+}