feat: Overhaul snippets app into a multi-activity demo (#955)

* 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: Upgrade Places SDK to 5.0.0

This commit upgrades the Places SDK for Android from version 4.4.1 to 5.0.0.

Key changes include:

- Updating all build.gradle.kts and libs.versions.toml files to use the new SDK version.

- Migrating from deprecated Place fields.

- Adopting centralized SDK versioning in libs.versions.toml for better consistency across modules.

* fix: fixed checksum

* fix: minSdk

* chore: modified .gitignore (#961)

* feat: replace enums

* chore: removed dependabot flow (#962)

* 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: Upgrade Places SDK to 5.0.0

This commit upgrades the Places SDK for Android from version 4.4.1 to 5.0.0.

Key changes include:

- Updating all build.gradle.kts and libs.versions.toml files to use the new SDK version.

- Migrating from deprecated Place fields.

- Adopting centralized SDK versioning in libs.versions.toml for better consistency across modules.

* fix: fixed checksum

* fix: minSdk

* feat: replace enums

* docs: Correct snippet region tags for autocomplete intent

* docs: Correct snippet tags in PlaceAutocompleteActivity

* docs: Fixes some missing region tags

Moved the "maps_places_place_details_simple" tag into executed code to ensure it works as expected.

Key changes:

-   **Place Details**:
    -   The `PlaceDetailsActivity` (both Java and Kotlin) now requests the `Place.Field.LOCATION` field.
    -   The fetched `LatLng` coordinates are now displayed in the UI, providing a more complete example of the data available.

-   **Place Autocomplete**:
    -   The `PlaceAutocompleteActivity` (both Java and Kotlin) now requests and displays the `FORMATTED_ADDRESS` of the selected place.
    -   The autocomplete intent example now filters for the `ESTABLISHMENT` type instead of `ADDRESS`.

-   **Current Place**:
    -   The code in `CurrentPlaceActivity` (both Java and Kotlin) has been wrapped in `maps_places_current_place` snippet tags and annotated with comments to improve its utility as a documentation example.

---------

Co-authored-by: Enrique López-Mañas <eenriquelopez@gmail.com>

Author: dkhawk

PlaceDetailsUIKit/gradle/libs.versions.toml

@@ -4,6 +4,13 @@
 # https://docs.gradle.org/current/userguide/version_catalog_basics.html
 
 [versions]
+# --- Android SDK Versions ---
+# These versions define the API levels for compiling, targeting, and running the app.
+# By centralizing them here, we ensure all modules in the project are aligned.
+compileSdk = "36"
+minSdk = "27"
+targetSdk = "36"
+
 # --- Core Android & Kotlin ---
 # These are the fundamental versions for building the Android app.
 agp = "8.13.0"

demo-java/app/build.gradle.kts

@@ -21,12 +21,12 @@ plugins {
 
 android {
     namespace = "com.example.placesdemo"
-    compileSdk = 36
+    compileSdk = libs.versions.sdk.compile.get().toInt()
 
     defaultConfig {
         applicationId = "com.example.placesdemo"
-        minSdk = 23
-        targetSdk = 36
+        minSdk = libs.versions.sdk.min.get().toInt()
+        targetSdk = libs.versions.sdk.target.get().toInt()
         versionCode = 1
         versionName = "1.0"
 

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

@@ -52,12 +52,10 @@
 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.TypeFilter;
 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;
 
-import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
 
@@ -154,14 +152,12 @@ private void startAutocompleteIntent() {
         // Set the fields to specify which types of place data to
         // return after the user has made a selection.
         List<Place.Field> fields = Arrays.asList(Place.Field.ADDRESS_COMPONENTS,
-                Place.Field.LAT_LNG, Place.Field.VIEWPORT);
+                Place.Field.LOCATION, Place.Field.VIEWPORT);
 
         // Build the autocomplete intent with field, country, and type filters applied
         Intent intent = new Autocomplete.IntentBuilder(AutocompleteActivityMode.OVERLAY, fields)
-                .setCountries(Arrays.asList("US"))
-                .setTypesFilter(new ArrayList<String>() {{
-                    add(TypeFilter.ADDRESS.toString().toLowerCase());
-                }})
+                .setCountries(List.of("US"))
+                .setTypesFilter(List.of("establishment"))
                 .build(this);
         startAutocomplete.launch(intent);
     }
@@ -251,7 +247,7 @@ private void fillInAddress(Place place) {
 
     // [START maps_solutions_android_autocomplete_map_add]
     private void showMap(Place place) {
-        coordinates = place.getLatLng();
+        coordinates = place.getLocation();
 
         // It isn't possible to set a fragment's id programmatically so we set a tag instead and
         // search for it using that.

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

@@ -110,7 +110,6 @@ protected void onCreate(@Nullable Bundle savedInstanceState) {
                 Field.EDITORIAL_SUMMARY,
                 Field.INTERNATIONAL_PHONE_NUMBER,
                 Field.OPENING_HOURS,
-                Field.PHONE_NUMBER,
                 Field.RESERVABLE,
                 Field.SECONDARY_OPENING_HOURS,
                 Field.SERVES_BEER,
@@ -122,8 +121,7 @@ protected void onCreate(@Nullable Bundle savedInstanceState) {
                 Field.SERVES_WINE,
                 Field.TAKEOUT,
                 Field.UTC_OFFSET,
-                Field.WEBSITE_URI,
-                Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
+                Field.WEBSITE_URI
         );
         fieldSelector = new FieldSelector(
                 binding.useCustomFields,

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

@@ -31,6 +31,7 @@
 
 import android.content.Context;
 import android.graphics.Bitmap;
+import android.graphics.Color;
 import android.os.Bundle;
 import android.text.TextUtils;
 import android.view.View;
@@ -159,8 +160,9 @@ private void attemptFetchPhoto(Place place) {
 
     private void attemptFetchIcon(Place place) {
         binding.icon.setImageBitmap(null);
-        binding.icon.setBackgroundColor(place.getIconBackgroundColor());
-        String url = place.getIconUrl();
+        Integer bc = place.getIconBackgroundColor();
+        binding.icon.setBackgroundColor(bc == null ? Color.TRANSPARENT : bc);
+        String url = place.getIconMaskUrl();
         Glide.with(this).load(url).into(binding.icon);
     }
 
@@ -234,7 +236,7 @@ private boolean validateInputs(boolean isFetchPhotoChecked, boolean isFetchIconC
                     "Using 'Custom photo reference', but 'Also fetch photo?' is not selected.");
             return false;
         }
-        if (isFetchIconChecked && !placeFields.contains(Field.ICON_URL)) {
+        if (isFetchIconChecked && !placeFields.contains(Field.ICON_MASK_URL)) {
             binding.response.setText(R.string.fetch_icon_missing_fields_warning);
             return false;
         }

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

@@ -230,11 +230,11 @@ private List<Field> getPlaceFields() {
             return fieldSelector.getSelectedFields();
         } else {
             return new ArrayList<>(Arrays.asList(
-                    Field.ADDRESS,
+                    Field.FORMATTED_ADDRESS,
                     Field.BUSINESS_STATUS,
                     Field.CURRENT_OPENING_HOURS,
                     Field.ID,
-                    Field.NAME,
+                    Field.DISPLAY_NAME,
                     Field.OPENING_HOURS,
                     Field.UTC_OFFSET
             ));

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

@@ -142,9 +142,9 @@ static String stringify(FindCurrentPlaceResponse response, boolean raw) {
   }
 
   static String stringify(Place place) {
-    return place.getName()
+    return place.getDisplayName()
             + " ("
-            + place.getAddress()
+            + place.getFormattedAddress()
             + ")";
   }
 

demo-java/gradle/libs.versions.toml

@@ -1,16 +1,20 @@
 [versions]
-activity = "1.10.1"
+sdk-compile = "36"
+sdk-min = "24"
+sdk-target = "36"
+
+activity = "1.11.0"
 androidGradlePlugin = "8.13.0"
-androidMapsUtils = "3.16.0"
+androidMapsUtils = "3.19.0"
 appcompat = "1.7.1"
 constraintlayout = "2.2.1"
 fragment = "1.8.9"
-glide = "5.0.4"
+glide = "5.0.5"
 mapsSecretsGradlePlugin = "2.0.1"
 material = "1.13.0"
 multidex = "2.0.1"
-navigationFragment = "2.9.3"
-places = "4.4.1"
+navigationFragment = "2.9.5"
+places = "5.0.0"
 playServicesMaps = "19.2.0"
 viewbinding = "8.13.0"
 volley = "1.2.1"

demo-kotlin/app/build.gradle.kts

@@ -27,7 +27,7 @@ android {
 
     defaultConfig {
         applicationId = "com.example.placesdemo"
-        minSdk = 23
+        minSdk = 24
         targetSdk = 36
         versionCode = 1
         versionName = "1.0"
@@ -43,6 +43,7 @@ android {
 
     buildFeatures {
         viewBinding = true
+        buildConfig = true
     }
 }
 

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

@@ -95,7 +95,7 @@ class AutocompleteAddressActivity : BaseActivity(),
         // return after the user has made a selection.
         val fields = listOf(
             Place.Field.ADDRESS_COMPONENTS,
-            Place.Field.LAT_LNG, Place.Field.VIEWPORT
+            Place.Field.LOCATION, Place.Field.VIEWPORT
         )
 
         // Build the autocomplete intent with field, country, and type filters applied
@@ -227,7 +227,7 @@ class AutocompleteAddressActivity : BaseActivity(),
 
     // [START maps_solutions_android_autocomplete_map_add]
     private fun showMap(place: Place) {
-        coordinates = place.latLng as LatLng
+        coordinates = place.location as LatLng
 
         // It isn't possible to set a fragment's id programmatically so we set a tag instead and
         // search for it using that.