DEPRECATED
Don't use this. The Maps v3 SDK handles markers. That with a few other cool utilities make this library obsolete!
Clusterkraf
A clustering library for the Google Maps Android API v2.
If you're using the Polaris v2 library, check out our pleiades branch.
Features
- Clustering based on pixel proximity, not grid membership
- Animated cluster transitions
- Supports Android v2.2 (Froyo) and higher
Setup
Gradle
If you are using Gradle just add the following to your build.gradle file:
dependencies {
compile 'com.twotoasters.clusterkraf:library:1.0.+'
}
Maven
If you are using maven add the following to your pom file:
<dependency>
<groupId>com.twotoasters.clusterkraf</groupId>
<artifactId>library</artifactId>
<version>1.0.2</version>
</dependency>
Eclipse
It's easy to add Clusterkraf to your app. Add the Clusterkraf library folder as an Android project to your Eclipse/ADT workspace, and reference it from your app as a library project. Also, we assume you have a data object that holds latitude and longitude coordinates of each point you want plotted on the map similar to this:
public class YourMapPointModel {
public LatLng latLng;
public YourMapPointModel(LatLng latLng) {
this.latLng = latLng;
}
// encapsulation omitted for brevity
}
Clusterkraf provides an InputPoint class which holds a LatLng position and an Object tag. You just need to construct an ArrayList<InputPoint> object based on your model objects similar to this example. In this example, we provide the model as the Object tag for the InputPoint so that we can later pass them back to you in callbacks as the ClusterPoint object's pointsInCluster list; see MarkerOptionsChooser, OnInfoWindowClickDownstreamListener, and OnMarkerClickDownstreamListener.
public class YourActivity extends FragmentActivity {
YourMapPointModel[] yourMapPointModels = new YourMapPointModel[] { new YourMapPointModel(new LatLng(0d, 1d) /* etc */ ) };
ArrayList<InputPoint> inputPoints;
private void buildInputPoints() {
this.inputPoints = new ArrayList<InputPoint>(yourMapPointModels.length);
for (YourMapPointModel model : this.yourMapPointModels) {
this.inputPoints.add(new InputPoint(model.latLng, model));
}
}
}
When your GoogleMap is initialized and your ArrayList<InputPoint> is built, you can then initialize Clusterkraf.
// YourActivity
Clusterkraf clusterkraf;
private void initClusterkraf() {
if (this.map != null && this.inputPoints != null && this.inputPoints.size() > 0) {
com.twotoasters.clusterkraf.Options options = new com.twotoasters.clusterkraf.Options();
// customize the options before you construct a Clusterkraf instance
this.clusterkraf = new Clusterkraf(this.map, this.options, this.inputPoints);
}
}
You've added a really sweet clustered map to your Android app.
For a more detailed example, take a look at the included sample app's source code.
Sample App
The sample app demonstrates Activity lifecycle, custom marker icons, click handling, and Clusterkraf's options. You can build it from source, or install it from https://play.google.com/store/apps/details?id=com.twotoasters.clusterkraf.sample.
Building the Sample App
- In your local checkout of the Clusterkraf git repo, do
git submodule initandgit submodule update. - Add sample/ as a new Android project from existing source.
- Add sample/libs/ViewPagerIndicator as a new Android project from existing source.
- Authorize com.twotoasters.clusterkraf.sample built with your key of choice to your Google Maps for Android v2 API account.
- Create a new Values file
private_strings.xmlin sample/res/values/ and create a string namedmaps_api_keywith your Google Maps for Android v2 API key.
License
Copyright 2013 Two Toasters
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.
2.1k Dec 4, 2022
346 Jan 8, 2023
39 Dec 9, 2022
34 Dec 2, 2022
4 Jul 19, 2021
1 Feb 18, 2022
3 Oct 27, 2022
641 Dec 23, 2022
1k Nov 26, 2022
407 Dec 27, 2022
299 Nov 14, 2022
3 Dec 6, 2021
0 Jan 30, 2022
976 Dec 29, 2022
802 Dec 22, 2022
1.2k Dec 29, 2022
648 Dec 23, 2022
659 May 14, 2022