feat: added ContinuousZoomEuclideanCentroidAlgorithm

[kikoso]

This PR adds the ContinuousZoomEuclideanCentroidAlgorithm , a new clustering algorithm to fix some issues present in the NonHierarchicalDistanceBasedAlgorithm (namely, aggresivevity while clustering). It avoids the limitations of NonHierarchicalDistanceBasedAlgorithm, like abrupt clustering changes when zoom crosses integer levels and the square-based proximity check.

The algorithm works with continuous zoom, computing the clustering radius using the fractional zoom level, so the threshold changes smoothly as you zoom in or out. This makes clustering more natural and visually consistent.

It also uses Euclidean distance to decide cluster membership. The quadtree search still uses a square for performance, but items are only added to a cluster if they fall within a circular radius, avoiding the diagonal over-merging problem.

This comes as a separate algorithm instead of changing NonHierarchicalDistanceBasedAlgorithm, so we don’t introduce any behavior changes for existing users.

[kikoso]

@stefano-maggiolo, I can't add you as a reviewer, but feel free to take a look. I have added a test, but while doing it I am thinking if it could make sense to add a sample activity that showcase the behavior for the algorithms.

[googlemaps-bot]

Code Coverage

Overall Project	35.75%	🍏
Files changed	100%	🍏

File	Coverage
ContinuousZoomEuclideanCentroidAlgorithm.java	100%	🍏
NonHierarchicalDistanceBasedAlgorithm.java	93.91%	🍏

[stefano-maggiolo]

Looks good to me, but can we have a version that combine this and the Centroid version?

[googlemaps-bot]

🎉 This PR is included in version 3.15.0 🎉

The release is available on:

• v3.15.0
• GitHub release

Your semantic-release bot 📦🚀

[ColtonIdle]

Can we add some high level docs on when to use what? For example, it's pretty well discussed in this repo issues/prs that NonHierarchicalDistanceBasedAlgorithm is the goto when you have a ton of items, but maybe the readme can include a pros cons list or something? Thank you!

[kikoso]

@ColtonIdle , we were talking last week about adding an activity showcasing how all the algorithm works. We will work on this next - either a new sample, and/or documentation to showcase them.

[ColtonIdle]

Love it! thank you! im a maps noob, but have to use it in a few KMP apps now so I'm trying my best to provide a good UX for everyone!

[kikoso]

@ColtonIdle , this will be reviewed soon, but as a reference:

#1567