googlemaps/android-maps-utils
60.2
Adequate · 14 November 2026
28k
lines of production code
Kotlin
with Java
5
measurements over time
What this system is
Features
Added Android emulator readiness check script
A new shell script, tools/android-wait-for-emulator.sh, has been added to the project. This utility allows developers and CI pipelines to reliably wait for an Android emulator to finish booting before executing subsequent commands, polling the emulator's boot animation status with a configurable timeout to prevent indefinite hangs.
tools · high confidence
Introduce Gemini-powered visual testing helper
The visual-testing module now includes a new GeminiVisualTestHelper class that enables natural language-driven UI automation. By integrating with the Gemini API, this helper can analyze the current Android UI hierarchy and execute actions such as clicks, long clicks, and text input based on user prompts. This capability is supported by the addition of an AndroidManifest.xml, ProGuard rules, and a placeholder test to establish the module's structure.
visual-testing · high confidence
Introduce unified data module with legacy bridge classes
The data module now provides a new platform-agnostic architecture for parsing and rendering KML, GeoJSON, and GPX, featuring a clean separation of parsers, mappers, and a MapViewRenderer that supports advanced markers and async icon loading. To ensure backward compatibility, the module also includes a set of deprecated legacy bridge classes (such as GeoJsonLayer, Feature, and Style) that wrap the new renderer and model, allowing existing code to continue functioning while encouraging migration to the new unified API.
data · high confidence
Library rewritten in Kotlin with new collection managers and Street View support
The library has been rewritten in Kotlin, introducing a new object-oriented collection management system (MarkerManager, PolylineManager, PolygonManager, CircleManager, GroundOverlayManager) that simplifies adding and tracking map objects. New utility classes (MathUtil, PolyUtil, SphericalUtil) provide geometric calculations, while StreetViewUtil and StreetViewJavaHelper add support for fetching Street View data, including a Java-compatible callback interface. The AndroidManifest now registers an androidx.startup.Initializer for attribution tracking, and ProGuard rules are standardized.
library · high confidence
New lint rule warns about potential behavior overrides in Google Maps integration
A new custom lint check has been added to the \lint-checks\ module that detects calls to \GoogleMap\ methods such as \setInfoWindowAdapter\, \setOnMarkerClickListener\, and \setOnMarkerDragListener\. When these methods are used directly on the \GoogleMap\ instance while also utilizing utility features like clustering, GeoJson, or KML, the lint tool will emit a warning. This alerts developers that their custom listeners may be overridden by the utility library's internal implementations, guiding them to use the alternative APIs provided by the utility library (e.g., setting listeners on \MarkerManager.Collection\) to ensure expected behavior.
lint-checks · high confidence
Repository scaffolding for v5.2.0 modular Kotlin rewrite
This change establishes the foundational structure for the Maps SDK for Android Utility Library v5.2.0, introducing a multi-module architecture (core, clustering, data, heatmaps, ui) and a complete rewrite in Kotlin. It adds essential project configuration files including \.editorconfig\ for consistent code formatting, \.gitignore\ and \.geminiignore\ for build artifacts, and \AGENTS.md\ to guide AI coding agents. The entry also includes the \MIGRATION.md\ guide detailing breaking changes for v4.x to v5.x upgrades, such as the shift to Kotlin property syntax and modular imports, alongside standard repository documentation like \CONTRIBUTING.md\, \CODE\_OF\_CONDUCT.md\, and \SECURITY.md\.
(repo-wide) · high confidence
Rewritten UI module with Kotlin implementation and new marker animation utilities
The \ui\ module has been rewritten in Kotlin, introducing \AnimationUtil\ to animate map markers to new positions with configurable duration and interpolation, and \IconGenerator\ to create styled, rotatable bitmap icons for map markers and info windows. The module now includes supporting components like \RotationLayout\ and \SquareTextView\, along with updated resource layouts and styles, and is accompanied by comprehensive Robolectric unit tests for the new animation and icon generation logic.
ui · high confidence
Removals
Removal of SphericalUtil class
The \SphericalUtil\ class, which provided static methods for geographic calculations such as computing headings, distances, areas, and offsets between \LatLng\ points, has been removed from the codebase. Users relying on these utility functions for spherical geometry operations will no longer have access to this implementation.
src/com · high confidence
Behavioural changes
1 commit (0 fixes) modifying .claude, .gemini
A change to existing behaviour in .claude, .gemini — 1 commit, 2 files: “chore: tool-neutral agent setup, AGENTS.md PR rules and agent leftovers check (\#1838)” (refs \#1838).
.claude, .gemini, baselineprofile · low confidence · unverified
Android module configuration and manifest updates
The collections and maps-utils modules now include explicit AndroidManifest.xml files and ProGuard configuration files (consumer-rules.pro and proguard-rules.pro). The maps-utils manifest defines the package com.google.maps.android.utils, while the collections module includes a minimal manifest. These changes ensure proper Android packaging and allow for configurable code shrinking and obfuscation rules for these utility libraries.
collections, maps-utils · high confidence
Clustering module rewritten in Kotlin with new algorithms and open API
The clustering module has been rewritten in Kotlin, introducing new clustering algorithms such as CentroidNonHierarchicalDistanceBasedAlgorithm, GridBasedAlgorithm, and ContinuousZoomEuclideanCentroidAlgorithm, alongside a new ScreenBasedAlgorithm interface for view-based clustering. The ClusterManager class is now open and uses JvmSuppressWildcards to improve Java interoperability, and the module includes a PreCachingAlgorithmDecorator for performance optimization. This change also adds a new AndroidManifest.xml and ProGuard rules, and updates the ClusterItem interface to include zIndex support. Also in this area: New SuperClusterAlgorithm for high-performance, mega-scale marker clustering; ClusterManager now supports configurable coroutine contexts for clustering.
clustering · high confidence
Demo app configuration updates for Maps SDK v3 and build standardization
The demo application now includes a dedicated .gitignore file to exclude build artifacts and secure properties, a V3\_FILE\_HEADER to clarify that generated code originates from the gms source directory, and updated ProGuard rules. Specifically, the ProGuard configuration now preserves the com.google.android.libraries.maps package to prevent crashes in minified release builds when using Maps SDK v3.1 beta, addressing a known issue tracked in Google's issue tracker.
demo · high confidence
Heatmaps module rewritten in Kotlin with new builder API and extension functions
The heatmaps module has been rewritten in Kotlin, introducing a new \HeatmapTileProvider.Builder\ for configuring heatmap layers (radius, gradient, opacity, intensity) and providing Kotlin extension functions like \toWeightedLatLng\ and \heatmapTileProviderWithData\ for easier usage. The \Gradient\ class now supports configurable color maps and opacity, and the \WeightedLatLng\ data class simplifies defining point intensity. Deprecated methods from the previous Java implementation are retained in a separate ktx package for backward compatibility.
heatmaps · high confidence
Migrate publishing infrastructure to vanniktech Maven publish plugin
The build-logic/convention module now uses the vanniktech Maven publish plugin for publishing artifacts to Maven Central. This change introduces new convention plugins (BomPublishingConventionPlugin and PublishingConventionPlugin) that configure the publishing extension, handle signing based on available keys, and set up artifact coordinates and POM metadata. The PublishingConventionPlugin also integrates Kover for test coverage reporting and Dokka for documentation generation, replacing previous publishing and coverage configurations.
build-logic/convention · high confidence
Test coverage
AI-assisted visual regression testing for demo app
The demo app now includes a suite of Android instrumented tests that use Google Gemini to verify map rendering. These tests capture screenshots of features like clustering, KML overlays, and z-index layering, then use natural language prompts to confirm visual correctness, falling back to AI verification when static golden images do not match.
demo/src · high confidence
Dependencies
Migrate build system to Gradle Kotlin DSL and version catalogs
The project build has been rewritten from Groovy to Kotlin DSL (build.gradle.kts) and now uses a centralized version catalog (gradle/libs.versions.toml) to manage dependencies. This change introduces a new build-logic convention plugin module to standardize configuration across modules, establishes a BOM (Bill of Materials) module to enforce consistent dependency versions, and sets the project minimum SDK to 23 and Java/Kotlin toolchain to 17. The demo app now requires a secrets.properties file for API keys and includes a new 'navigation' product flavor.
(dependencies) · high confidence
Updated Gradle wrapper to version 9.7.1
The project's Gradle wrapper has been updated to version 9.7.1. This ensures that builds use a consistent, specific version of the Gradle build tool, improving reproducibility and potentially bringing in new features or performance improvements from the 9.7.1 release.
gradle · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 57 → 60 (+3.4)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 82 → 80 (-1.7)
- Architecture 85 → 88 (+2.7)
- Maturity 66 → 66 (+0.6)
- Readiness 68 → 72 (+4.7)
- Security 73 → 75 (+2.2)
- Accessibility 41 → 46 (+5.1)
- Performance 86 → 94 (+8.6)
Resolved (42)
- Duplicated block (10 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (10 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (11 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (12 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (12 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (12 lines × 2) (demo/src/main/java/com/google/maps/android/utils/demo/ZIndexDemoActivity.kt)
- Duplicated block (12 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (12 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (13 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/algo/ContinuousZoomEuclideanCentroidAlgorithm.kt)
- Duplicated block (14 lines × 2) (visual-testing/src/main/java/com/google/maps/android/visualtesting/GeminiVisualTestHelper.kt)
- Duplicated block (14 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (14 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (18 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (20–21 lines × 2) (data/src/main/java/com/google/maps/android/data/renderer/mapview/MapViewRenderer.kt)
- Duplicated block (24 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (24 lines × 2) (library/src/main/java/com/google/maps/android/location/LocationManager.kt)
- Duplicated block (25 lines × 2) (data/src/main/java/com/google/maps/android/data/geojson/GeoJsonLayer.kt)
- Duplicated block (26 lines × 2) (data/src/main/java/com/google/maps/android/data/geojson/GeoJsonLayer.kt)
- Duplicated block (26 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (30 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- …and 22 more
New (98)
- Duplicated block (10 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (10 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (10–11 lines × 2) (data/src/main/java/com/google/maps/android/data/geojson/GeoJsonLayer.kt)
- Duplicated block (11 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (12 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/algo/CentroidNonHierarchicalDistanceBasedAlgorithm.kt)
- Duplicated block (12 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (12 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (12 lines × 2) (data/src/main/java/com/google/maps/android/data/kml/KmlLayer.kt)
- Duplicated block (12 lines × 2) (demo/src/main/java/com/google/maps/android/utils/demo/ZIndexDemoActivity.kt)
- Duplicated block (12 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (12 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (13 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/algo/ContinuousZoomEuclideanCentroidAlgorithm.kt)
- Duplicated block (14 lines × 2) (visual-testing/src/main/java/com/google/maps/android/visualtesting/GeminiVisualTestHelper.kt)
- Duplicated block (14 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (14 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (14–16 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (18 lines × 3) (clustering/src/main/java/com/google/maps/android/clustering/view/ClusterRendererMultipleItems.kt)
- Duplicated block (20–21 lines × 2) (data/src/main/java/com/google/maps/android/data/renderer/mapview/MapViewRenderer.kt)
- Duplicated block (24 lines × 2) (clustering/src/main/java/com/google/maps/android/clustering/view/DefaultAdvancedMarkersClusterRenderer.kt)
- Duplicated block (24 lines × 2) (library/src/main/java/com/google/maps/android/location/LocationManager.kt)
- …and 78 more
Changes since last survey
- 14 commits — 13 feature/other, 1 fixes
By area
- .github/workflows — 4 commits
- (root) — 3 commits
- .github/CODEOWNERS — 1 commit
- build-logic/convention — 1 commit
- data/src — 1 commit
- demo/src — 1 commit
- gradle/libs.versions.toml — 1 commit
- gradle/wrapper — 1 commit
- library/src — 1 commit
Notable commits
- fix: fix: publish Kotlin 2.2 compatible metadata so AGP's bundled Kotlin can consume the library (#1847)
- change: build(deps): bump the github-actions-minor-and-patch group across 1 directory with 3 updates (#1853)
- change: build(deps): bump the github-actions-minor-and-patch group with 2 updates (#1837)
- change: build(deps): bump the github-actions-minor-and-patch group with 2 updates (#1843)
- change: build(deps): bump the gradle-minor-and-patch group across 1 directory with 3 updates (#1850)
- change: build(deps): bump the gradle-minor-and-patch group with 2 updates (#1836)
- change: build(deps): bump the gradle-minor-and-patch group with 4 updates (#1842)
- change: chore(deps): bump Gradle wrapper to 9.9.1 (#1852)
- change: chore(main): release 7.0.0 (#1830)
- change: chore: add maintainer as code owner of workflow files (#1839)
- change: chore: tool-neutral agent setup, AGENTS.md PR rules and agent leftovers check (#1838)
- change: ci: regenerate Baseline Profiles before each release (#1841)
- change: feat: add Units API for distance and elevation conversion and formatting (#1832)
- change: perf: ship Baseline Profiles in the library modules (#1840)
Architecture
- Unchanged — 0 containers · 5 contexts · 3 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
googlemaps/android-maps-utils was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 4df2704aba8db4fd005ccd517f99174e7158de52 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-e1a3b69fc8ee.