.NET MAUI 11 Harita Pin Kümeleme: Sahadan Rehber
Bir harita üstüne 50 pin atıyorsun, ekran bir anda okunmaz hâle geliyor. 200 pin olunca iş iyice dağılıyor. Bunu hepimiz yaşadık. Ben geçen yıl bir lojistik firmasının araç takip uygulamasında tam olarak bununla uğraştım — İstanbul haritasında 400+ araç pini üst üste binmişti ve müşteri “bu ne biçim uygulama” dedi, haklıydı da (yanlış duymadınız). Neyse, artık.NET MAUI 11 Preview 3 ile pin clustering özelliği kutudan çıkıyor. Tek satır kod. Ciddi ciddi.
Küme Tıklama Olayını Yönetmek
Şöyle ki, Kullanıcı bir kümeye tıklayınca ne olacak? Varsayılan davranış haritayı o kümeye zoom etmek.
Ama bazen bunu kendin yönetmek istersin; mesela liste göstermek istersin, bottom sheet açarsın ya da direkt başka ekrana geçersin.
İşte burada olay biraz şekil değiştiriyor.
map.ClusterClicked += async (sender, e) =>
{
string isimler = string.Join("
", e.Pins.Select(p => p.Label));
await DisplayAlert(
$"Kume ({e.Pins.Count} pin)",
isimler,
"Tamam");
// Varsayılan zoom davranışını iptal etmek için:
// e.Handled = true;
};
ClusterClickedEventArgs içinde şunlar var:
| Özellik | Tip | Açıklama |
|---|---|---|
Pins |
IReadOnlyList<Pin> |
Kumedeki tüm pinlerin listesi |
Location |
Location |
Kümenin coğrafi merkez noktası |
Handled |
bool |
true yaparsanız varsayılan zoom davranışı iptal olur |
Hmm… e.Handled = true kısmı önemli.
Bunu true yapmazsanız harita otomatik zoom ediyor.
Ama bazen — özellikle kullanıcıya seçenek listesi göstermek istediğinizde — zoom’u kapatıp kendi UI’ınızı açmak çok daha iyi hissettiriyor.
Peki neden?
Çünkü kullanıcıya karar alanını sız veriyorsunuz.
ClusterClicked olayı sadece kümelere tıklandığında tetikleniyor.
Bireysel pin tıklamaları için hâlâ MapClicked veya Pin.MarkerClicked kullanmanız gerekiyor.
Bunu karıştıran çok oluyor; dikkat edin.
Platform Farklılıkları: Android vs iOS
İtiraf edeyim, Bak şimdi, bu bölüm önemli çünkü iki platform aynı şeyi aynı şekilde yapmıyor.
Aynı API var diye aynı davranış beklemeyin; o kadar temiz değil işte (ciddiyim)
Ve işler burada ilginçleşiyor.
Android tarafı: Özel bir grid-based algoritma kullanıyor. Zoom seviyesi değişince kümeleri yeniden hesaplıyor.
Harici kütüphane gerekmemesi güzel ama animasyonlar iOS’a kıyasla biraz sert kalabiliyor.
Kümelerin açılıp kapanması sırasında o akıcılık hissi Android’de azıcık eksik dürüyor.
Preview aşaması tabi; belki sonraki sürümde toparlanır.
iOS ve Maç Catalyst tarafı:
Native MKClusterAnnotation
desteğini kullanıyor.
MapKit’in clustering mekanizması zaten oturmuş durumda ve animasyonlar daha pürüzsüz gidiyor.
Bu tarafta ben pek sorun görmedim açıkçası.
Bazı testlerde ilginç şeylerle karşılaştık.
Logosoft’ta bir müşteri projesinde iOS ve Android harita performansını kıyaslarken şunu fark ettik: 500+ pin olduğunda Android’de ilk render süresi iOS’a göre yaklaşık %30 daha yavaştı.
Clustering açılınca fark biraz kapanıyor çünkü ekranda çizilen öğe sayısı azalıyor ama yine de akılda tutmak lazım; özellikle yoğun veri varsa lazy loading düşünmek kötü fikir değil.
Türkiye’deki Ekipler Için Pratik Değerlendirme
Neyse uzatmayayım; Türkiye’deki mobil ekiplerin çoğu hâlâ Xamarin’den.NET MAUI’ye geçişle uğraşıyor.
Hele bir de İstanbul ve Ankara’daki yazılım evlerinde bu geçiş bazen düz gitmiyor.
Harita bileşeni de genelde en sancılı parçalardan biri oluyor.
Üçüncü parti bağımlılıklar, sürüm uyuşmazlıkları, platform-specific workaround’lar derken iş büyüyor.
Clustering’in native gelmesi bu geçişi biraz daha cazip hâle getiriyor.
Itirazım yok buna.
Bunu biraz açayım.
Vallahi, “Bir de lokasyon bazlı uygulamalar Türkiye’de oldukça yaygın. Kurye takip var,
araç filo yönetimi var,
emlak var,
market bulma var… Hepsinde harita kullanılıyor ve hepsinde pin yoğunluğu sorunu çıkıyor. O yüzden bu özellik Türkiye pazarı için baya değerli.”
dotnet workload updatekomutuyla halledebilirsiniz.
Preview olduğunu unutmayın — production’a direkt atmayın.
Küçük Ekip vs Büyük Kurumsal: Farklı Yaklaşımlar
“
Eğer
3-5 kişilik
bir startup ekibiyseniz ve hızlı hareket etmeniz gerekiyorsa,
clustering’i açın,
identifier’larla kategorileri ayırın,
varsayılan davranışla gidin.
Ozellestirmeyle vakit kaybetmeyin;
önce ürünü çıkarın.
Ama enterprise seviyede
bir filo yönetim uygulaması yapıyorsanız,
işler değişir.
Custom cluster renderer gerekebilir.
Küme ikonlarinin renk kodlu olmasını,
üstünde kategori bilgisi gostermesini isteyebilirsiniz.
Su anki API buna tam cevap vermiyor;
platform-specific handler yazmanız gerekebilir.
Bu da.NET MAUI’nın handler mimarisiyle mümkün. Kolay değil.
Kısa bir not düşeyim buraya.
Ha bu arada,
.NET ekosistemindeki güncel gelişmeleri takip ediyorsanız,
.NET ve.NET Framework Nisan 2026 Güvenlik Yamaları
yazıma da göz atmanızı tavsiye ederim — güvenlik güncellemelerini kaçırmamak önemli.
Eksik Bulduğum Noktalar ve Beklentilerim
“
Açik konuşayım:
bu özellik fena değil,
hatta bayağı iş görüyor.
Ama preview aşamasında birkaç şey eksik kalmış:
- Küme görünümünü özelleştirme (renk,
ikon,
boyut) için henüz resmî API yok — platform handler’larıyla ugrasmAnIz lazım - windows desteği yok.
Sadece Android. IOS/Mac Catalyst.
Windows’ta Maps kullanıyorsanız clustering calismayacak - Ccluster animasyonları Android’de iOS kadar akıcı değil
- DinamIc pin ekleme/cIkartma durumunda kümelerin ne kadar hızlı güncellendiği benim test ettiğim kadarıyla biraz değişken — bazen bir zoom in/out gerekiyor güncelleme için
- .NET 11 Preview 3 SDK’yI indirip kurun
dOTnet workload install maui
veyadOTnet workload update
çalıştırın- Mevcut MAUI projenizde Maps NuGet paketini güncelleyin
- XAML’de
IscLustEringEnabled=\"True\"
ekleyin - PIn’lerinize uygun
ClusteringIdentifier
değerleri atayın - EEmulatorde veya fiziksel cihazda test edin — emulatorde bazen küme animasyonları düzgün gözükmüyor,
fiziksel cihaz daha güvenilir
/ul>
“
Beklediğim kadar esnek değil henüz.
Ama ilk adım olarak sağlam.
Kağıt üstünde süper dursa da pratikte GA (General Availability) sürümünde asıl performansı göreceğiz.
DevOps süreçlerinizi bu tarz preview SDK’larla test ederken CI/CD pipeline’larınızı da gözden gecirmenizde fayda var.
Bu konuda
azd update Komutu:
Paket Yöneticisi Derdine Son
yazım işinize yarayabilir.
İhemen Başlamak Isteyenler Için Adımlar
“
Denemek istiyorsanız,
su sırayı takip edin:
İlk denememde Android emulatorde kümelerin bazen takıldığını gördüm.
Fiziksel cihaza geçince sorun yoktu.
Yanı emulatorde garip davranişlar gorurseniz hemen panik yapmayın — önce gerçek cihazda test edin.
Ayrıca Microsoft’un maui-samples
reposundaki Clustering sayfası güzel bir başlangıç noktası.
Oradan kod kopyalayıp kendi projenize adapte edebilirsiniz.
>
Sıkça Sorulan Sorular
Pin clustering hangi platformlarda çalışıyor?
Şu an sadece Android ve iOS/Mac Catalyst’te çalışıyor. Windows tarafında henüz destek yok. iOS native MapKit MKClusterAnnotation kullanıyor, Android işe custom grid-based bir algoritmayla hallediyor.
Her pin kategorisini ayrı kümeleyebilir mıyım?
Yanı, Evet, yanı bu oldukça kullanışlı bir özellik. Pin nesnesindeki ClusteringIdentifier property’sine farklı değerler vermeniz yeterli. Kısacası, aynı identifier’a sahip pinler kendi aralarında bir düşüneyim… kümeleniyor, farklı olanlar işe ayrı ayrı. Mesela “restoran” ve “otel” pinlerini bağımsız olarak kümeleyebilirsiniz.
Küme görünümünü özelleştirebilir mıyım?
İtiraf edeyim, Açıkçası, Preview 3 itibarıyla resmî API ile doğrudan özelleştirme oldukça kısıtlı. Platform-specific handler yazarak native tarafta küme görünümünü değiştirebilirsiniz, ama bence bu biraz can sıkıcı (evet, doğru duydunuz). GA sürümünde bu konuda daha fazla seçenek geleceğini umuyorum.
Çok sayıda pinle performans nasıl?
Kısacası, i̇lginç olan şu ki, 500-1000 pin arasında gayet akıcı çalışıyor. 2000’in üzerine çıkınca Android’de ilk yükleme süresi biraz uzayabiliyor. Tecrübeme göre bu noktada viewport-based lazy loading stratejisi işleri ciddi ölçüde düzeltiyor (en azından benim deneyimim böyle). iOS işe native altyapısı sayesinde genelde daha pürüzsüz.
.NET MAUI 11 Preview 3’ü production’da kullanabilir mıyım?
Bence tavsiye etmem. Preview sürümler hani test ve değerlendirme içindir; API’ler değişebilir, buglar çıkabilir. Production için GA’yı bekleyin. Ama aslında şimdiden test ortamınızda deneyip geri bildirım verirseniz hem kendiniz hazır olursunuz hem de Microsoft’a katkı sağlamış olursunuz.
Kaynaklar ve İleri Okuma
Pin Clustering in.NET MAUI Maps —.NET Blog
20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.
4 comments