feat(samples): implement additional maker customization samples (#29)

* feat(samples): implement monster tour, long-press, and altitude modes

- Replaced hardcoded markers with dynamic parsing from monsters.json

- Implemented automated sequential tour of all markers in Kotlin and Java

- Added a long-press PopupMenu to the Random Monster button for quick selection

- Configured individual AltitudeModes for markers via JSON

* refactor(java): use formal imports instead of fully qualified class names

* feat(sample): refactor monster data parsing and implement robust test suite

- Extracted JSON parsing logic into dedicated `Monster` and `MonsterParser` classes for both Kotlin and Java apps to clean up activity bloat.
- Refactored `MarkersActivity` in both languages to utilize the new abstractions.
- Fixed a timing bug in the Java `MarkersActivity` by ensuring `setMapMode` and marker placements await `setOnMapReadyListener`, aligning its behavior with the Kotlin implementation.
- Added comprehensive unit tests for the parsing logic.
- Added Robolectric integration tests to validate complex asset parsing in an emulated environment.
- Migrated all test assertions to Google Truth (`com.google.truth:truth`) for better readability.
- Added necessary test dependencies (Robolectric, Truth, JSON) to the relevant Version Catalogs.

* fix(samples): synchronize tour with steady map state and add tour cancellation

- Implement double-wait pattern utilizing OnMapSteadyListener to prevent tour animations from skipping past unrendered terrain.

- Added stopMonsterTour calls to all other navigation buttons.

* feat(samples): port missing popovers and map interaction samples to Java

* test(mainactivity): add tests verifying all samples present in launcher list

* feat(samples): disable auto-panning for Giant Ape popover

* style: minor formatting and UI opacity tweaks

* refactor(samples): introduce Coroutine extensions for Maps 3D callbacks

* docs(samples): add educational comments to Java markers sample

* refactor(samples): convert long literals to Duration inWholeMilliseconds

* refactor(samples): introduce CompletableFuture extensions for Java app

* fix(samples): ensure map steady is awaited after camera flight completes in Java

* docs(samples): add extensive inline comments to Java CompletableFuture chain

* Address review comments: remove FQDN and extract text content descriptions

Author: dkhawk

LOG.md

@@ -0,0 +1,8 @@
+
+### Task: Implement Monster Tour and Long Press popup (Project: Maps3D Samples)
+* **Start:** [Unknown] (Branch: main)
+* **End:** $(date +"%I:%M:%S %p %Z")
+* **Time Spent:** [Unknown]
+* **Purpose:** The user wanted to automate the traversal of the various monster markers in the map, and add a quick-select popup menu to the random button, configuring properties like altitude mode via JSON.
+* **Summary of Work:** Shifted marker definitions to a central `monsters.json` data file. Implemented an asynchronous touring sequence in both Kotlin (Coroutines) and Java (Handlers) to fly to, orbit, and display info popovers for each character. Wired up a standard `android.widget.PopupMenu` for the random button long-press. Adjusted altitude modes in JSON.
+* **Status:** **[IN PROGRESS (Unmerged)]**

Maps3DSamples/ApiDemos/common/build.gradle.kts

@@ -69,6 +69,6 @@ dependencies {
 
     implementation(libs.androidx.material3)
 
-    api(libs.play.services.base)
-    api(libs.play.services.maps3d)
+    api(libs.play.services.base) // "com.google.android.gms:play-services-base:18.10.0"
+    api(libs.play.services.maps3d) // "com.google.android.gms:play-services-maps3d:0.2.0"
 }

Maps3DSamples/ApiDemos/common/src/main/assets/monsters.json

@@ -0,0 +1,130 @@
+[
+  {
+    "id": "alien",
+    "label": "Devil's Tower Alien",
+    "blurb": "They didn't just come to sculpt mashed potatoes.",
+    "drawable": "alien",
+    "latitude": 44.589994,
+    "longitude": -104.715326,
+    "altitude": 1508.9,
+    "markerLatitude": 44.59054845363309,
+    "markerLongitude": -104.715177415273,
+    "markerAltitude": 10.0,
+    "heading": 1.0,
+    "tilt": 75.0,
+    "range": 1635.0,
+    "altitudeMode": "RELATIVE_TO_MESH"
+  },
+  {
+    "id": "bigfoot",
+    "label": "Mt. St. Helens Bigfoot",
+    "blurb": "Leaves some pretty big footprints, very camera shy.",
+    "drawable": "bigfoot",
+    "latitude": 46.199837,
+    "longitude": -122.205541,
+    "altitude": 2272.5,
+    "markerLatitude": 46.199837,
+    "markerLongitude": -122.205541,
+    "markerAltitude": 2272.5,
+    "heading": 318.0,
+    "tilt": 58.0,
+    "range": 6088.0,
+    "altitudeMode": "ABSOLUTE"
+  },
+  {
+    "id": "frank",
+    "label": "Castle Frankenstein",
+    "blurb": "It's alive! Quite misunderstood, honestly.",
+    "drawable": "frank",
+    "latitude": 49.793566,
+    "longitude": 8.669903,
+    "altitude": 380.1,
+    "markerLatitude": 49.793570448322434,
+    "markerLongitude": 8.668253367313627,
+    "markerAltitude": 100.0,
+    "heading": 90.0,
+    "tilt": 45.0,
+    "range": 1246.0,
+    "altitudeMode": "RELATIVE_TO_MESH"
+  },
+  {
+    "id": "godzilla",
+    "label": "Tokyo Bay Godzilla",
+    "blurb": "King of the Monsters. Loves a quick swim in the bay.",
+    "drawable": "godzilla",
+    "latitude": 35.5391,
+    "longitude": 139.8001,
+    "altitude": 100.0,
+    "markerLatitude": 35.5391,
+    "markerLongitude": 139.8001,
+    "markerAltitude": 100.0,
+    "heading": 0.0,
+    "tilt": 60.0,
+    "range": 3000.0,
+    "altitudeMode": "RELATIVE_TO_GROUND"
+  },
+  {
+    "id": "mothra",
+    "label": "Tokyo Tower Mothra",
+    "blurb": "Like a butterfly, but much, much bigger. Attracted to bright lights.",
+    "drawable": "mothra",
+    "latitude": 35.658588,
+    "longitude": 139.745496,
+    "altitude": 247.9,
+    "markerLatitude": 35.658588,
+    "markerLongitude": 139.745496,
+    "markerAltitude": 333.0,
+    "heading": 270.0,
+    "tilt": 48.0,
+    "range": 810.0,
+    "altitudeMode": "RELATIVE_TO_GROUND"
+  },
+  {
+    "id": "mummy",
+    "label": "Giza Mummy",
+    "blurb": "Woke up on the wrong side of the sarcophagus.",
+    "drawable": "mummy",
+    "latitude": 29.9792,
+    "longitude": 31.1342,
+    "altitude": 150.0,
+    "markerLatitude": 29.9792,
+    "markerLongitude": 31.1342,
+    "markerAltitude": 150.0,
+    "heading": 45.0,
+    "tilt": 60.0,
+    "range": 1500.0,
+    "altitudeMode": "ABSOLUTE"
+  },
+  {
+    "id": "nessie",
+    "label": "Loch Ness Monster",
+    "blurb": "The original cryptid. Probably just a log, but we want to believe.",
+    "drawable": "nessie",
+    "latitude": 57.320312,
+    "longitude": -4.43019,
+    "altitude": 14.4,
+    "markerLatitude": 57.320312,
+    "markerLongitude": -4.43019,
+    "markerAltitude": 14.4,
+    "heading": 0.0,
+    "tilt": 45.0,
+    "range": 20303.0,
+    "altitudeMode": "ABSOLUTE"
+  },
+  {
+    "id": "yeti",
+    "label": "Everest Yeti",
+    "blurb": "Abominable? More like adorable if you get to know him.",
+    "drawable": "yeti",
+    "latitude": 27.9881,
+    "longitude": 86.925,
+    "altitude": 8848.0,
+    "markerLatitude": 27.9881,
+    "markerLongitude": 86.925,
+    "markerAltitude": 8848.0,
+    "heading": 0.0,
+    "tilt": 46.0,
+    "range": 5000.0,
+    "altitudeMode": "ABSOLUTE"
+  }
+]