feat!: migrate android-maps-ktx into android-maps-utils (v6.0.0)

[dkhawk]

Summary

Migrates all Kotlin extensions from android-maps-ktx (maps-ktx and maps-utils-ktx) directly into android-maps-utils, establishing v6.0.0 as the consolidated, single-source release for both Java utilities and Kotlin Coroutine/Flow extensions.

Key Changes

1. Consolidated Kotlin Extensions:
   • Reactive coroutine suspensions (awaitMap(), awaitMapsSdkInitialized(), awaitAnimateCamera()).
   • Reactive Flow event streams (mapClickEvents(), cameraMoveEvents(), markerClickEvents()).
   • DSL option builders (addMarker { ... }, addPolyline { ... }, addPolygon { ... }).
2. Canonical & Compatibility Packages:
   • All extensions and builders live under canonical com.google.maps.android.* packages.
   • Preserves com.google.maps.android.ktx.* with @Deprecated(level = DeprecationLevel.WARNING) forwarding wrappers and typealiases for seamless backward compatibility.
3. Release Please Configuration:
   • Configured release-please-config.json and .release-please-manifest.json for final v6.0.0 stable release.
   • Updated documentation (README.md, MIGRATION.md, llm-integration-prompt.md, .gemini/skills/android-maps-utils/SKILL.md).
4. Rebase & Test Validation:
   • Rebased onto latest main (e8ef093c, Kover migration).
   • 100% unit tests pass across all modules (:library, :clustering, :data, :heatmaps, :ui, :demo).

[googlemaps-bot]

Code Coverage

Overall Project	56.95% -5.89%	🍏
Files changed	69.5%	🍏

Module	Coverage
Kover Gradle Plugin XML report for :library	89.61% -6.77%	🍏
Kover Gradle Plugin XML report for :heatmaps	88.62% -4.12%	🍏
Kover Gradle Plugin XML report for :ui	80.78%	🍏
Kover Gradle Plugin XML report for :data	54.29% -7.82%	❌
Kover Gradle Plugin XML report for :clustering	33.26% -2.19%	🍏

Files

Module	File	Coverage
Kover Gradle Plugin XML report for :library	SupportStreetViewPanoramaFragment.kt	100%	🍏
	MapView.kt	100%	🍏
	MapFragment.kt	100%	🍏
	SupportMapFragment.kt	100%	🍏
	StreetViewPanoramaFragment.kt	100%	🍏
	Polyline.kt	100%	🍏
	LatLng.kt	100%	🍏
	SupportStreetViewPanoramaFragment.kt	100%	🍏
	MapView.kt	100%	🍏
	SupportMapFragment.kt	100%	🍏
	Polyline.kt	100%	🍏
	LatLng.kt	100%	🍏
	StreetViewJavaHelper.kt	100%	🍏
	StreetViewPanoramaView.kt	100%	🍏
	MapFragment.kt	100%	🍏
	MapsInitializer.kt	100%	🍏
	MathUtil.kt	100%	🍏
	StreetViewPanoramaFragment.kt	100%	🍏
	PolylineOptions.kt	100%	🍏
	MarkerOptions.kt	100%	🍏
	PolygonOptions.kt	100%	🍏
	CircleOptions.kt	100%	🍏
	StreetViewPanoramaOrientation.kt	100%	🍏
	CameraPosition.kt	100%	🍏
	GroundOverlayOptions.kt	100%	🍏
	TileOverlayOptions.kt	100%	🍏
	StreetViewPanoramaCamera.kt	100%	🍏
	PolylineOptions.kt	100%	🍏
	MarkerOptions.kt	100%	🍏
	PolygonOptions.kt	100%	🍏
	CircleOptions.kt	100%	🍏
	StreetViewPanoramaOrientation.kt	100%	🍏
	CameraPosition.kt	100%	🍏
	GroundOverlayOptions.kt	100%	🍏
	TileOverlayOptions.kt	100%	🍏
	StreetViewPanoramaCamera.kt	100%	🍏
	SphericalUtil.kt	99.71%	🍏
	PolyUtil.kt	99.37%	🍏
	FlexiblePolyline.kt	97.84%	🍏
	MapObjectManager.kt	94.05% -3.97%	🍏
	MarkerManager.kt	91.98%	🍏
	MarkerManagerFlows.kt	91.2% -8.8%	🍏
	PolygonManager.kt	87.84%	🍏
	CircleManager.kt	87.84%	🍏
	GroundOverlayManager.kt	87.84%	🍏
	PolylineManager.kt	87.84%	🍏
	FusedLocationProvider.kt	84.62% -15.38%	🍏
	LocationManager.kt	84.62% -15.38%	🍏
	GoogleMap.kt	83.83% -16.17%	🍏
	Polygon.kt	80.95% -19.05%	🍏
	PolylineManagerFlows.kt	78% -22%	🍏
	GroundOverlayManagerFlows.kt	78% -22%	🍏
	PolygonManagerFlows.kt	78% -22%	🍏
	CircleManagerFlows.kt	78% -22%	🍏
	Polygon.kt	70.73% -29.27%	🍏
	MapsInitializer.kt	66.67% -33.33%	🍏
	MarkerManager.kt	60% -40%	🍏
	FusedLocationProvider.kt	38.46% -61.54%	❌
	LocationManager.kt	35.71% -64.29%	❌
	StreetViewUtil.kt	34.02% -3.73%	❌
	PolygonManager.kt	33.33% -66.67%	❌
	CircleManager.kt	33.33% -66.67%	❌
	GroundOverlayManager.kt	33.33% -66.67%	❌
	PolylineManager.kt	33.33% -66.67%	❌
	GoogleMap.kt	28.44% -71.56%	❌
	StreetViewPanoramaView.kt	27.27% -72.73%	❌
Kover Gradle Plugin XML report for :heatmaps	WeightedLatLng.kt	100%	🍏
	HeatmapTileProvider.kt	92.61% -0.27%	🍏
	Gradient.kt	88.4% -1.9%	🍏
	Heatmap.kt	15.15% -84.85%	❌
	Heatmap.kt	13.73% -86.27%	❌
Kover Gradle Plugin XML report for :ui	AnimationUtil.kt	92.7%	🍏
	IconGenerator.kt	90.34%	🍏
	RotationLayout.kt	88.97%	🍏
	SquareTextView.kt	0%	🍏
Kover Gradle Plugin XML report for :data	GroundOverlay.kt	100%	🍏
	Point.kt	100%	🍏
	Style.kt	100%	🍏
	Feature.kt	100%	🍏
	GroundOverlayStyle.kt	100%	🍏
	Geometry.kt	100%	🍏
	GeoJsonObjects.kt	96.92%	🍏
	LatLngAlt.kt	91.67%	🍏
	KmlParser.kt	90.53% -5.33%	❌
	GeoJsonParser.kt	89.39% -1.4%	❌
	GpxParser.kt	88.68% -8.49%	❌
	KmzParser.kt	87.85% -0.4%	🍏
	KmlMapper.kt	87.53%	🍏
	DataLayer.kt	87.35%	🍏
	Layer.kt	86.05%	🍏
	MapViewRenderer.kt	76.13% -16.55%	🍏
	GpxMapper.kt	69.05% -3.4%	❌
	GeoJsonMapper.kt	56.42%	🍏
	GeoJsonPolygon.kt	56.25% -2.5%	🍏
	GeoJsonLayer.kt	55.37% -10.74%	🍏
	KmlModel.kt	53.36% -0.6%	🍏
	GpxModel.kt	52.22% -1.37%	🍏
	DataScene.kt	52.22% -17.78%	❌
	KmlLayer.kt	51.35% -17.09%	❌
	Style.kt	51.22%	🍏
	UrlIconProvider.kt	48.9%	🍏
	GeoJsonPointStyle.kt	35.52%	🍏
	KmlPolygon.kt	32.22% -3.33%	🍏
	GeoJsonLineStringStyle.kt	22.51%	🍏
	GeoJsonPolygonStyle.kt	21.43%	🍏
	KmlStyle.kt	8.48%	🍏
	GoogleMapRenderer.kt	0.76% -0.96%	❌
	DataLayerLoader.kt	0%	🍏
	GeoJson.kt	0%	❌
	GeoJson.kt	0%	❌
	Kml.kt	0%	❌
	Kml.kt	0%	❌
	Model.kt	0%	❌
	MapObject.kt	0%	🍏
	Polyline.kt	0% -99.13%	❌
	Layer.kt	0% -18.75%	❌
	Marker.kt	0% -99.16%	❌
	Circle.kt	0% -98.85%	❌
	Polygon.kt	0% -94.87%	❌
Kover Gradle Plugin XML report for :clustering	ClusterManagerFlows.kt	100%	🍏
	ClusterManager.kt	100%	🍏
	SphericalMercatorProjection.kt	100%	🍏
	CentroidNonHierarchicalDistanceBasedAlgorithm.kt	100%	🍏
	NonHierarchicalViewBasedAlgorithm.kt	100%	🍏
	AbstractAlgorithm.kt	100%	🍏
	ScreenBasedAlgorithmAdapter.kt	100%	🍏
	GridBasedAlgorithm.kt	100%	🍏
	PreCachingAlgorithmDecorator.kt	100%	🍏
	StaticCluster.kt	100%	🍏
	Point.kt	100%	🍏
	PointExtensions.kt	100%	🍏
	Bounds.kt	100%	🍏
	ContinuousZoomEuclideanCentroidAlgorithm.kt	99.63%	🍏
	NonHierarchicalDistanceBasedAlgorithm.kt	99.48%	🍏
	Point.kt	94.87%	🍏
	PointQuadTree.kt	94.71%	🍏
	ClusterManager.kt	71.59%	🍏
	DefaultClusterRenderer.kt	17.25% -2.17%	❌
	ClusterRendererMultipleItems.kt	0.15% -3.29%	❌
	DefaultAdvancedMarkersClusterRenderer.kt	0% -4.12%	❌

[LoyalAbbas]

Falling back to PASSIVE_PROVIDER here will throw a SecurityException if the caller only holds ACCESS_COARSE_LOCATION, since Android's LocationManagerService strictly requires ACCESS_FINE_LOCATION for passive updates. Also, we should check allProviders.contains(...) before calling requestLocationUpdates in both coarseLocationEvents and fineLocationEvents (and close() the flow if missing) so this doesn't crash with IllegalArgumentException: provider doesn't exist on devices without GPS/network hardware.

[dkhawk]

Great catch! Fixed in 7429314c — removed the PASSIVE_PROVIDER fallback in coarseLocationEvents and added an upfront if (!allProviders.contains(...)) { close(); return@callbackFlow } check in both coarseLocationEvents (NETWORK_PROVIDER) and fineLocationEvents (GPS_PROVIDER), along with unit tests in LocationManagerTest verifying that missing providers complete the flow cleanly without invoking requestLocationUpdates.

[kikoso]

LGTM!