feat: Integrates Places UI Kit 3D Sample

Maps3DSamples/ApiDemos/gradle/wrapper/gradle-wrapper.properties

@@ -1,7 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionSha256Sum=a17ddd85a26b6a7f5ddb71ff8b05fc5104c0202c6e64782429790c933686c806
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.4.1-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

Maps3DSamples/ApiDemos/java-app/build.gradle.kts

@@ -145,7 +145,7 @@ dependencies {
     androidTestImplementation(libs.androidx.espresso.core)
     androidTestImplementation(platform(libs.androidx.compose.bom))
     androidTestImplementation(libs.androidx.ui.test.junit4)
-    androidTestImplementation(libs.truth)
+    androidTestImplementation(libs.google.truth)
     debugImplementation(libs.androidx.ui.tooling)
     debugImplementation(libs.androidx.ui.test.manifest)
 }

Maps3DSamples/ApiDemos/kotlin-app/build.gradle.kts

@@ -150,7 +150,7 @@ dependencies {
     androidTestImplementation(libs.androidx.espresso.core)
     androidTestImplementation(platform(libs.androidx.compose.bom))
     androidTestImplementation(libs.androidx.ui.test.junit4)
-    androidTestImplementation(libs.truth)
+    androidTestImplementation(libs.google.truth)
     debugImplementation(libs.androidx.ui.tooling)
     debugImplementation(libs.androidx.ui.test.manifest)
 

Maps3DSamples/advanced/app/build.gradle.kts

@@ -180,3 +180,5 @@ tasks.register<Exec>("installAndLaunch") {
     dependsOn("installDebug")
     commandLine("adb", "shell", "am", "start", "-n", "com.example.advancedmaps3dsamples/.MainActivity")
 }
+
+tasks.register("prepareKotlinBuildScriptModel"){} 

Maps3DSamples/advanced/app/src/main/java/com/example/advancedmaps3dsamples/common/Map3dViewModel.kt

@@ -348,7 +348,7 @@ abstract class Map3dViewModel : ViewModel() {
 
   open fun setCameraTilt(tilt: Number) {
     updateCameraAndMove {
-      copy(heading = tilt.toTilt())
+      copy(tilt = tilt.toTilt())
     }
   }
 

Maps3DSamples/advanced/gradle/wrapper/gradle-wrapper.properties

@@ -1,7 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionSha256Sum=a17ddd85a26b6a7f5ddb71ff8b05fc5104c0202c6e64782429790c933686c806
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
+distributionUrl=https://services.gradle.org/distributions/gradle-9.4.1-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

PlacesUIKit3D/build.gradle.kts

@@ -0,0 +1,179 @@
+/*
+ * 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.
+ */
+
+// The `plugins` block is where we apply Gradle plugins to this module.
+// Plugins add new tasks and configurations to our build process.
+plugins {
+    // The core plugin for building an Android application. It provides tasks like `assembleDebug`, `installDebug`, etc.
+    alias(libs.plugins.android.application)
+    // This plugin enables Kotlin support in the Android project, allowing us to write code in Kotlin.
+    alias(libs.plugins.kotlin.android)
+    // This plugin from Google helps manage API keys and other secrets by reading them from a `secrets.properties`
+    // file (which should be in .gitignore) and exposing them in the `BuildConfig` file at compile time.
+    // This is crucial for keeping sensitive data out of version control.
+    alias(libs.plugins.secrets.gradle.plugin)
+    // This plugin provides the necessary integration for using Jetpack Compose with the Kotlin compiler.
+    alias(libs.plugins.kotlin.compose)
+    // KSP (Kotlin Symbol Processing) is used for annotation processing. Hilt uses it to generate code.
+    alias(libs.plugins.ksp)
+    // The Hilt plugin integrates Dagger Hilt for dependency injection.
+    alias(libs.plugins.hilt.android)
+    // The parcelize plugin provides a @Parcelize annotation to automatically generate Parcelable implementations.
+    alias(libs.plugins.jetbrains.kotlin.parcelize)
+}
+
+// The `android` block is where we configure all the Android-specific build options.
+android {
+    // The `namespace` is a unique identifier for the app's generated R class. It's also used
+    // as the default `applicationId` if not specified in `defaultConfig`.
+    namespace = "com.example.placesuikit3d"
+    // `compileSdk` specifies the Android API level the app is compiled against.
+    // Using a recent version allows us to use the latest Android features.
+    compileSdk = 36
+
+    defaultConfig {
+        // `applicationId` is the unique identifier for the app on the Google Play Store and on the device.
+        applicationId = "com.example.placesuikit3d"
+        // `minSdk` is the minimum API level required to run the app. Devices below this level cannot install it.
+        minSdk = 29
+        // `targetSdk` indicates the API level the app was tested against. Android may enable
+        // compatibility behaviors on newer OS versions if the target is lower.
+        targetSdk = 36
+        versionCode = 1
+        versionName = "1.0"
+
+        // Specifies the instrumentation runner for running Android tests.
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        // The `release` block configures settings for the release build of the app.
+        release {
+            // `isMinifyEnabled` enables code shrinking with R8 to reduce the app's size.
+            // It's disabled here for simplicity in a sample app, but highly recommended for production.
+            isMinifyEnabled = false
+            // `proguardFiles` specifies the files that define the R8 shrinking and obfuscation rules.
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+    compileOptions {
+        // Sets the Java language compatibility for the source code and compiled bytecode.
+        // Using Java 17 is required for modern Android development.
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+
+    kotlin {
+        jvmToolchain(17)
+    }
+
+    buildFeatures {
+        // `viewBinding` generates a binding class for each XML layout file, providing a type-safe
+        // way to access views without `findViewById`. This is used in the XML-based activities.
+        viewBinding = true
+        // `compose` enables Jetpack Compose for the project.
+        compose = true
+        // `buildConfig` generates a `BuildConfig` class that contains constants from the build configuration,
+        // such as the API key from the secrets plugin.
+        buildConfig = true
+    }
+
+    java {
+        // Specifies the Java language version for the project's toolchain.
+        toolchain {
+            languageVersion.set(JavaLanguageVersion.of(17))
+        }
+    }
+    composeOptions {
+        // Sets the version of the Kotlin compiler extension for Compose. This version must be
+        // compatible with the Kotlin version used in the project.
+        kotlinCompilerExtensionVersion = "1.5.1"
+    }
+}
+
+// The `dependencies` block is where we declare all the external libraries the app needs.
+// These are fetched from repositories like Maven Central and Google's Maven repository.
+dependencies {
+    // --- Core AndroidX & UI Libraries ---
+    // These are foundational libraries for building modern Android apps.
+    implementation(libs.androidx.core.ktx)
+    implementation(libs.androidx.lifecycle.runtime.ktx)
+    implementation(libs.androidx.fragment.ktx)
+    implementation(libs.material) // For Material Design components (used in XML layouts).
+
+    // --- Jetpack Compose ---
+    // These libraries are for building UIs with Jetpack Compose.
+    implementation(libs.androidx.activity.compose) // Integration between Activity and Compose.
+    implementation(platform(libs.androidx.compose.bom)) // The Compose Bill of Materials (BOM) ensures all Compose libraries use compatible versions.
+    implementation(libs.androidx.ui)
+    implementation(libs.androidx.ui.graphics)
+    implementation(libs.androidx.ui.tooling.preview) // For displaying @Preview composables in Android Studio.
+    implementation(libs.androidx.material3) // The latest Material Design components for Compose.
+    implementation(libs.androidx.fragment.compose)
+    implementation(libs.androidx.material.icons.extended)
+    debugImplementation(libs.androidx.ui.tooling) // Provides tools for inspecting Compose UIs.
+
+    // --- Google Play Services ---
+    // These are the essential libraries for this sample, providing Maps and Places functionality.
+    implementation(libs.play.services.maps3d) // The core SDK for embedding 3D Google Maps.
+    implementation(libs.places) // The SDK for the Places UI Kit (PlaceDetails fragments).
+    implementation(libs.maps.utils.ktx) // Google Maps Utils for polyline decoding and other utilities.
+
+    // --- Dependency Injection ---
+    // Hilt is used for managing dependencies and object lifecycles.
+    implementation(libs.dagger)
+    ksp(libs.hilt.android.compiler)
+    implementation(libs.hilt.android)
+
+    // --- Miscellaneous ---
+    implementation(libs.kotlinx.datetime)
+
+    // --- Testing Libraries ---
+    // These libraries are for writing and running tests.
+    // `testImplementation` is for local unit tests (running on the JVM).
+    testImplementation(libs.junit)
+    testImplementation(libs.google.truth)
+    testImplementation(libs.robolectric)
+    // `androidTestImplementation` is for instrumented tests (running on an Android device or emulator).
+    androidTestImplementation(libs.androidx.junit)
+    androidTestImplementation(libs.androidx.espresso.core) // For UI testing with the View system.
+
+    // --- Compose Testing ---
+    // These are specific to testing Jetpack Compose UIs.
+    androidTestImplementation(platform(libs.androidx.compose.bom)) // BOM for testing libraries.
+    androidTestImplementation(libs.androidx.ui.test.junit4) // The main library for Compose UI tests.
+    debugImplementation(libs.androidx.ui.test.manifest) // Provides a manifest for UI tests.
+}
+
+// This block configures the Secrets Gradle Plugin.
+secrets {
+    // Specifies a default properties file. This is useful for CI/CD environments where
+    // you might not have a local `secrets.properties` file.
+    defaultPropertiesFileName = "local.defaults.properties"
+    // Specifies the local properties file where secret keys (like the Places API key) are stored.
+    // This file should be added to .gitignore to prevent it from being committed to version control.
+    propertiesFileName = "secrets.properties"
+}
+
+tasks.register<Exec>("installAndLaunch") {
+    description = "Installs the debug APK and launches the main activity."
+    group = "application"
+    dependsOn("installDebug")
+    commandLine("adb", "shell", "am", "start", "-n", "com.example.placesuikit3d/com.example.placesuikit3d.MainActivity")
+}

PlacesUIKit3D/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

PlacesUIKit3D/src/main/AndroidManifest.xml

@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+ 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.
+-->
+
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+
+
+    <application
+        android:name=".Maps3DPlacesApplication"
+        android:allowBackup="true"
+        android:dataExtractionRules="@xml/data_extraction_rules"
+        android:fullBackupContent="@xml/backup_rules"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.PlacesUIKit3D"
+        tools:targetApi="31">
+
+        <meta-data
+            android:name="com.google.android.geo.maps3d.API_KEY"
+            android:value="${MAPS3D_API_KEY}"
+            />
+
+        <activity
+            android:name=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name"
+            android:theme="@style/Theme.PlacesUIKit3D">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

PlacesUIKit3D/src/main/java/com/example/placesuikit3d/Landmark.kt

@@ -0,0 +1,30 @@
+// Copyright 2026 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.
+
+package com.example.placesuikit3d
+
+import com.google.android.gms.maps3d.model.LatLngAltitude
+
+/**
+ * A data class representing a landmark in the demo.
+ *
+ * @property id The unique Place ID for this landmark.
+ * @property name The human-readable name of the landmark.
+ * @property location The coordinates on the 3D map where the camera should point.
+ */
+data class Landmark(
+    val id: String,
+    val name: String,
+    val location: LatLngAltitude
+)