# choefele/CCHMapClusterController

High-performance map clustering with MapKit for iOS and OS X. Integrate with 4 lines of code.

Repository: https://github.com/choefele/CCHMapClusterController
Canonical: https://ross.abutalabs.com/products/cchmapclustercontroller
Language: Objective-C
License: MIT
License Family: permissive
Last push: 2018-09-04T12:12:40+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4667, "days_push": 2920, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1362, forks 150 (observed 2026-08-28T04:04:30.229690+00:00)

## What it is
CCHMapClusterController is an Objective-C library that clusters large numbers of annotations on an MKMapView for iOS and OS X, with integration in about four lines of code. It automatically regroups clusters as the map changes and supports custom annotation views, callouts, positioning, and animations.

## Use cases
- display thousands of map annotations without performance problems
- cluster pins on an MKMapView in an iOS app
- add map clustering to an existing MapKit project with minimal code
- customize cluster annotation views and callout titles
- dynamically enable or disable clustering based on zoom level

## When to avoid
- you target iOS 11+ only and built-in MapKit clustering suffices
- you need a Swift-native or actively developed solution
- you need clustering for non-Apple map SDKs like Google Maps

## Facets
- artifact type: library
- maturity: maintenance
- function: graphics, ui-components
- domain: mobile-development
- platform: -
- tags: mapkit, map-clustering, objective-c, annotations, cocoapods, maps, ios, macos

## Member repositories
- choefele/CCHMapClusterController (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:30.229690+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:41:29.551858+00:00, confidence not recorded.
  - readme: https://github.com/choefele/CCHMapClusterController (fetched 2026-08-28T04:04:30.229690+00:00, sha e494f2dfb5ea)
- Data as of 2026-08-30T08:39:29.467469+00:00.
