chore: Implement edge-to-edge UI (#1574)

* Rename .java to .kt

* refactor(library): Convert projection.Point to Kotlin and add tests

The `@Deprecated` annotation has been updated to the Kotlin syntax and now includes a `ReplaceWith` expression to provide IDE quick-fix support.

Additionally, new unit tests using Google Truth have been added for the `Point` class to verify its construction and inheritance.

* refactor(heatmaps): Port Gradient and WeightedLatLng to Kotlin

This commit migrates the `Gradient` and `WeightedLatLng` classes and their corresponding tests from Java to idiomatic Kotlin.

This conversion is part of the larger effort to modernize the library and prepare it for Kotlin Multiplatform (KMP) compatibility.

Key changes include:
- `WeightedLatLng` is now a `data class` with a private primary constructor to ensure correct instantiation while providing the benefits of auto-generated methods. The `@ExposedCopyVisibility` annotation has been added to maintain binary compatibility for the `copy()` method.
- `Gradient` has been converted to a Kotlin class, using `@JvmOverloads` for constructor compatibility and a `companion object` for its static helper method.
- The `internal` visibility of a method in `Gradient` was changed to `public` to ensure visibility to Java classes during the mixed-language phase of the migration.
- Unit tests for both classes have been ported to Kotlin, using the Truth assertion framework.

* feat(heatmaps): Port HeatmapTileProvider to Kotlin

This commit completes the migration of the `heatmaps` package to Kotlin by porting the final and most complex class, `HeatmapTileProvider`.

This conversion modernizes the class by introducing several idiomatic Kotlin features and improves its design by refactoring a key data structure.

Key changes include:
- The `HeatmapTileProvider` and its `Builder` are now written in Kotlin.
- The `getMaxValue()` method was refactored to use a `Map` with a type-safe `Vector` key instead of the Android-specific `LongSparseArray`, improving readability and moving closer to KMP compatibility.
- A new test suite was created from scratch for the provider, as none existed previously. This improves the code coverage and reliability of the module.
- Necessary adjustments were made to the demo application to support the newly ported Kotlin class.

* fix(tests): Correct copyright headers in new test files

Updates the copyright headers in the test files that were created
during the Kotlin porting process.

- Corrects the copyright year to 2025.
- Corrects the company name from "Google Inc." to "Google LLC".

* chore: Add PLACES_API_KEY to local.defaults.properties

* fix(heatmaps): Correct copyright headers

Updates the copyright headers in the `heatmaps` package source and test files.

- Corrects the copyright year to 2025.
- Corrects the company name from "Google Inc." to "Google LLC".

* feat: Implement edge-to-edge UI

This commit implements edge-to-edge UI for the demo application.

Changes include:
- Updating the app theme to be edge-to-edge.
- Applying window insets to the base and main activities.
- Adding a separate styles.xml for API 27+ to handle display cutouts.

* fix: Update copyright headers

This commit updates the copyright headers in the following files:
- demo/build.gradle.kts
- demo/src/main/java/com/google/maps/android/utils/demo/BaseDemoActivity.java
- demo/src/main/java/com/google/maps/android/utils/demo/MainActivity.java
- demo/src/main/res/values/styles.xml
- demo/src/main/res/values-v27/styles.xml

* chore: fix copyright headers

* Fix copyright year

* Fix copyright header in main.xml

* refactor(heatmaps): Replace check with require in HeatmapTileProvider.Builder

This commit replaces the `check` function with `require` for validating input data in the `HeatmapTileProvider.Builder`.

Using `require` is more idiomatic for precondition checks, throwing an `IllegalArgumentException` which is more appropriate in this context than the `IllegalStateException` thrown by `check`.

* chore(heatmaps): Correct expected exception in HeatmapTileProviderTest

This commit updates `HeatmapTileProviderTest` to expect an `IllegalArgumentException` instead of `IllegalStateException` when building a provider with no data. It also cleans up unused exception variables in catch blocks.

Author: dkhawk

demo/build.gradle.kts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Google Inc.
+ * Copyright 2025 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -65,6 +65,7 @@ dependencies {
     implementation(libs.kotlinx.coroutines.android)
     implementation(libs.kotlinx.coroutines.core)
     implementation(libs.material)
+    implementation(libs.core.ktx)
 
     testImplementation(libs.junit)
     testImplementation(libs.truth)

demo/src/main/AndroidManifest.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8" standalone="no"?><!--
- Copyright 2024 Google LLC
+ Copyright 2025 Google LLC
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.

demo/src/main/java/com/google/maps/android/utils/demo/BaseDemoActivity.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2013 Google Inc.
+ * Copyright 2025 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,6 +19,7 @@
 import static com.google.maps.android.utils.demo.ApiKeyValidatorKt.hasMapsApiKey;
 
 import android.os.Bundle;
+import android.view.View;
 import android.widget.Toast;
 
 import androidx.annotation.NonNull;
@@ -30,6 +31,11 @@
 
 import java.util.Objects;
 
+import androidx.core.graphics.Insets;
+import androidx.core.view.ViewCompat;
+import androidx.core.view.WindowCompat;
+import androidx.core.view.WindowInsetsCompat;
+
 public abstract class BaseDemoActivity extends FragmentActivity implements OnMapReadyCallback {
     private GoogleMap mMap;
     private boolean mIsRestore;
@@ -49,6 +55,30 @@ public void onCreate(Bundle savedInstanceState) {
 
         mIsRestore = savedInstanceState != null;
         setContentView(getLayoutId());
+        // This tells the system that the app will handle drawing behind the system bars.
+        WindowCompat.setDecorFitsSystemWindows(getWindow(), false);
+
+        // This is the root view of my layout.
+        // Make sure to replace R.id.root_layout with the actual ID of your root view.
+        final View rootView = findViewById(android.R.id.content);
+
+        // Add a listener to handle window insets.
+        ViewCompat.setOnApplyWindowInsetsListener(rootView, (view, windowInsets) -> {
+            final Insets insets = windowInsets.getInsets(WindowInsetsCompat.Type.systemBars());
+
+            // Apply the insets as padding to the view.
+            // This will push the content down from behind the status bar and up from
+            // behind the navigation bar.
+            view.setPadding(
+                insets.left,
+                insets.top,
+                insets.right,
+                insets.bottom
+            );
+
+            // Return CONSUMED to signal that we've handled the insets.
+            return WindowInsetsCompat.CONSUMED;
+        });
         setUpMap();
     }
 
@@ -73,4 +103,4 @@ private void setUpMap() {
     protected GoogleMap getMap() {
         return mMap;
     }
-}
+}

demo/src/main/java/com/google/maps/android/utils/demo/MainActivity.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Google Inc.
+ * Copyright 2025 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -25,6 +25,11 @@
 
 import androidx.appcompat.app.AppCompatActivity;
 
+import androidx.core.graphics.Insets;
+import androidx.core.view.ViewCompat;
+import androidx.core.view.WindowCompat;
+import androidx.core.view.WindowInsetsCompat;
+
 public class MainActivity extends AppCompatActivity implements View.OnClickListener {
     private ViewGroup mListView;
 
@@ -34,6 +39,31 @@ protected void onCreate(Bundle savedInstanceState) {
 
         setContentView(R.layout.main);
 
+        // This tells the system that the app will handle drawing behind the system bars.
+        WindowCompat.setDecorFitsSystemWindows(getWindow(), false);
+
+        // This is the root view of my layout.
+        // Make sure to replace R.id.root_layout with the actual ID of your root view.
+        final View rootView = findViewById(android.R.id.content);
+
+        // Add a listener to handle window insets.
+        ViewCompat.setOnApplyWindowInsetsListener(rootView, (view, windowInsets) -> {
+            final Insets insets = windowInsets.getInsets(WindowInsetsCompat.Type.systemBars());
+
+            // Apply the insets as padding to the view.
+            // This will push the content down from behind the status bar and up from
+            // behind the navigation bar.
+            view.setPadding(
+                insets.left,
+                insets.top,
+                insets.right,
+                insets.bottom
+            );
+
+            // Return CONSUMED to signal that we've handled the insets.
+            return WindowInsetsCompat.CONSUMED;
+        });
+
         mListView = findViewById(R.id.list);
 
         addDemo("Advanced Markers Clustering Example", CustomAdvancedMarkerClusteringDemoActivity.class);

demo/src/main/res/layout/main.xml

@@ -1,18 +1,18 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
-  ~ Copyright 2020 Google Inc.
-  ~
-  ~ Licensed under the Apache License, Version 2.0 (the "License");
-  ~ you may not use this file except in compliance with the License.
-  ~ You may obtain a copy of the License at
-  ~
-  ~      http://www.apache.org/licenses/LICENSE-2.0
-  ~
-  ~ Unless required by applicable law or agreed to in writing, software
-  ~ distributed under the License is distributed on an "AS IS" BASIS,
-  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  ~ See the License for the specific language governing permissions and
-  ~ limitations under the License.
+  Copyright 2025 Google LLC
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
 -->
 
 <ScrollView xmlns:android="http://schemas.android.com/apk/res/android"

demo/src/main/res/values-v27/styles.xml

@@ -0,0 +1,40 @@
+<!--
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<resources>
+
+    <!-- Base application theme. -->
+    <style name="AppTheme" parent="Theme.Material3.DayNight.NoActionBar">
+        <!-- Other theme attributes -->
+
+        <!-- Make status and navigation bars transparent -->
+        <item name="android:statusBarColor">@android:color/transparent</item>
+        <item name="android:navigationBarColor">@android:color/transparent</item>
+
+        <!--
+          Required for edge-to-edge display. This allows the app to draw behind
+          the system bars.
+        -->
+        <item name="android:windowDrawsSystemBarBackgrounds">true</item>
+
+        <!--
+          On API 27+, this allows the app to render in the display cutout area.
+          'shortEdges' is a good default.
+        -->
+        <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
+    </style>
+
+</resources>

demo/src/main/res/values/styles.xml

@@ -1,26 +1,34 @@
 <!--
-  ~ Copyright 2020 Google Inc.
-  ~
-  ~ Licensed under the Apache License, Version 2.0 (the "License");
-  ~ you may not use this file except in compliance with the License.
-  ~ You may obtain a copy of the License at
-  ~
-  ~      http://www.apache.org/licenses/LICENSE-2.0
-  ~
-  ~ Unless required by applicable law or agreed to in writing, software
-  ~ distributed under the License is distributed on an "AS IS" BASIS,
-  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  ~ See the License for the specific language governing permissions and
-  ~ limitations under the License.
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
 -->
+
 <resources>
 
     <!-- Base application theme. -->
-    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
-        <!-- Customize your theme here. -->
-        <item name="colorPrimary">@color/colorPrimary</item>
-        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
-        <item name="colorAccent">@color/colorAccent</item>
+    <style name="AppTheme" parent="Theme.Material3.DayNight.NoActionBar">
+        <!-- Other theme attributes -->
+
+        <!-- Make status and navigation bars transparent -->
+        <item name="android:statusBarColor">@android:color/transparent</item>
+        <item name="android:navigationBarColor">@android:color/transparent</item>
+
+        <!--
+          Required for edge-to-edge display. This allows the app to draw behind
+          the system bars.
+        -->
+        <item name="android:windowDrawsSystemBarBackgrounds">true</item>
     </style>
 
 </resources>

library/src/main/java/com/google/maps/android/heatmaps/HeatmapTileProvider.kt

@@ -138,7 +138,7 @@ class HeatmapTileProvider private constructor(builder: Builder) : TileProvider {
          * @return A new HeatmapTileProvider.
          */
         fun build(): HeatmapTileProvider {
-            check(this.weightedData?.isNotEmpty() == true) { "No input data: you must use either .data or .weightedData before building." }
+            require(this.weightedData?.isNotEmpty() == true) { "No input data: you must use either .data or .weightedData before building." }
             return HeatmapTileProvider(this)
         }
     }
@@ -423,4 +423,4 @@ class HeatmapTileProvider private constructor(builder: Builder) : TileProvider {
             return buckets.values.maxOrNull() ?: 0.0
         }
     }
-}
+}

library/src/test/java/com/google/maps/android/heatmaps/HeatmapTileProviderTest.kt

@@ -46,7 +46,7 @@ class HeatmapTileProviderTest {
         try {
             HeatmapTileProvider.Builder().build()
             fail("Should have thrown IllegalStateException")
-        } catch (e: IllegalStateException) {
+        } catch (_: IllegalArgumentException) {
             // success
         }
     }
@@ -56,7 +56,7 @@ class HeatmapTileProviderTest {
         try {
             HeatmapTileProvider.Builder().data(emptyList())
             fail("Should have thrown IllegalArgumentException")
-        } catch (e: IllegalArgumentException) {
+        } catch (_: IllegalArgumentException) {
             // success
         }
     }
@@ -74,13 +74,13 @@ class HeatmapTileProviderTest {
         try {
             HeatmapTileProvider.Builder().data(data).radius(0)
             fail("Should have thrown IllegalArgumentException")
-        } catch (e: IllegalArgumentException) {
+        } catch (_: IllegalArgumentException) {
             // success
         }
         try {
             HeatmapTileProvider.Builder().data(data).radius(100)
             fail("Should have thrown IllegalArgumentException")
-        } catch (e: IllegalArgumentException) {
+        } catch (_: IllegalArgumentException) {
             // success
         }
     }
@@ -98,13 +98,13 @@ class HeatmapTileProviderTest {
         try {
             HeatmapTileProvider.Builder().data(data).opacity(-1.0)
             fail("Should have thrown IllegalArgumentException")
-        } catch (e: IllegalArgumentException) {
+        } catch (_: IllegalArgumentException) {
             // success
         }
         try {
             HeatmapTileProvider.Builder().data(data).opacity(2.0)
             fail("Should have thrown IllegalArgumentException")
-        } catch (e: IllegalArgumentException) {
+        } catch (_: IllegalArgumentException) {
             // success
         }
     }