1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi açın.

3. UI Design modülünde, sol kenardaki Elements panelinden Special kategorisi altındaki Maps elementini çalışma alanına sürükleyip bırakın.

Genel Ayarlar

• Datasource: Haritada gösterilecek konumların veri kaynağını belirler. REST API, SQL Actions gibi kaynaklar desteklenir.
• Latitude: Haritanın ilk açılışta odaklanacağı enlem değeridir. Statik (örneğin: 38.4237) veya dinamik olarak atanabilir.
• Longitude: Haritanın ilk açılışta odaklanacağı boylam değeridir. Statik veya dinamik olarak tanımlanabilir.
• Circle Radius In Km: Harita üzerinde belirli bir alanı kilometre cinsinden yarıçapla dairesel olarak vurgular.
• Auto Center: Haritanın açılışta nasıl konumlanacağını belirler.
  
  • True: Harita, veri kaynağında bulunan tüm konumları kapsayacak şekilde otomatik olarak merkezlenir ve uygun zoom seviyesini harita kendisi belirler.
    (Tüm marker’ları içine alacak biçimde konumlanır.
  • False: Harita herhangi bir otomatik merkezleme yapmaz. Açılış konumu Latitude ve Longitude alanlarında belirtilen değerlere göre ayarlanır. Bu alanlar boşsa harita varsayılan başlangıç konumunda açılır.
  • Auto Center = True olduğunda Latitude ve Longitude değerleri kullanılmaz.
• Keep Center On Zoom: Zoom işlemi sırasında harita merkezi sabit kalır.

Görünüm ve Simge Ayarları

• Group Picker Icon: Yakın konumlar, düşük zoom seviyelerinde tek bir simge (cluster) altında gruplanır.
• Group Picker Color: Gruplanan konum simgelerinin arka plan rengini belirler.
• Current Location Icon: Kullanıcının mevcut konumunu gösteren simgeyi tanımlar.
• Current Location Color: Kullanıcının konumunu belirten simgenin rengini ayarlamak için kullanılır.
• Selected Location Icon: Kullanıcının seçtiği (tıklanan) konumu göstermek için kullanılan simge.
• Marker Popup Width: Marker (konum) tıklamasında açılan bilgi balonunun genişliğini piksel cinsinden ayarlamanı sağlar.

Harita Tipi

• Map Type: Haritanın genel görünüm tarzını belirler:
  
  • Roadmap: Standart yol haritası.
  • Terrain: Arazi yapısını gösteren topoğrafik harita.
  • Satellite: Uydu görüntüleri ile gerçek dünya görselleri.
  • Hybrid: Uydu görüntülerine ek olarak yol ve şehir isimleri içerir.
• HideTransitLayer: Harita üzerindeki toplu taşıma rotalarının (tren, metro, tramvay vb.) gösterilip gösterilmeyeceğini kontrol eder. Varsayılan değeri false’tur.
• HideTrafficLayer: Harita üzerindeki trafik yoğunluğu katmanının (yolların doluluk durumu) gösterilip gösterilmeyeceğini kontrol eder. Varsayılan değeri false’tur.

Latitude ve Longitude değerleri Decimal formatında olmalıdır (örneğin: 38.4237, 27.1428).

Latitude ve Longitude değerleri boş (null) olsa bile harita yüklenir ve varsa diğer konumlar gösterilir.

Konum Alma İpucu

Google Maps üzerinden bir konumun enlem ve boylam değerini almak için:

1. Harita üzerinde konuma sağ tıklayın.
2. Açılan menüden koordinatları kopyalayın.
3. Bu değerleri Latitude ve Longitude alanlarına yapıştırın.
   
   

Events (Olaylar)

• On Location Click: Kullanıcı haritada bir konuma tıkladığında tetiklenir.
• On Map Load: Harita yüklendiğinde çalışır.
• On Zoom Change: Kullanıcı haritada yakınlaştırma veya uzaklaştırma yaptığında çalışır.

Authorization (Yetkilendirme)

Element düzeyindeki erişim kontrolünü yönetmek için, Properties panelindeki Authorization bölümünü kullanabilirsiniz.

Erişim Tipleri

Anonymous

Elementin tüm kullanıcılar tarafından, giriş yapmadan görüntülenmesine izin verir.

Restricted

Erişimin yalnızca doğrulanmış kullanıcılara veya belirli rollere göre sınırlandırılmasını sağlar.

• Everyone: Aktif edildiğinde, giriş yapmış tüm kullanıcılar elemente erişebilir.
• Roles: Elemente erişmesine izin verilen roller buradan seçilir. Rol listesini düzenlemek için Roles alanının yanındaki dişli (⚙️) ikonuna tıklayarak Role Management penceresini açabilirsiniz. Bu pencereden yeni rol ekleyebilir, klasör oluşturabilir veya mevcut rolleri yönetebilirsiniz.

Unauthorized Behavior (Hide / Disable)

Kullanıcı gerekli role sahip değilse, elementin nasıl davranacağını Choose alanından belirleyebilirsiniz:

• Hide: Kullanıcı yetkili değilse element tamamen gizlenir ve ekranda görünmez.
• Disable: Element görünür kalır ancak tıklanamaz / kullanılamaz hâle gelir.

Bu ayar, yetkisiz kullanıcıların elementle nasıl karşılaşacağını yönetmeniz için kullanılır.

Visibility (Görünürlük)

• Always Visible: Element her zaman görünür.
• Hidden: Element gizlenir.
• Sometimes Visible: Element, belirli bir koşula bağlı olarak görünür.

Ayarı yapılandırmak için:

1. Ekrandaki elementi seçin.
2. Sağ kenardaki Properties panelini açın.
3. Visibility alanında ihtiyacınıza göre bir seçenek belirleyin.

Editability (Düzenlenebilirlik)

• Enabled: Element düzenlenebilir.
• Disabled: Element düzenlenemez.
• Sometimes Enabled: Element, belirli koşullara göre düzenlenebilir veya düzenlenemez.

Style Panel ile Arayüz Tasarımı

Elementlerinizi Styling Panel ile özelleştirerek, web ve mobil uygulamalarınız için etkileyici arayüzler oluşturabilirsiniz. Bu bölümde, aşağıdaki ayarları yapılandırabilirsiniz:

• Layout (Düzen): Boyutlandırma, hizalama ve iç boşluk (padding) ayarları. Ayarlar arasında Size, Min Size ve Align bulunur.
• Text (Metin): Yazı tipi, stil, renk, boyut ve aralık ayarları.
• Fill (Dolgu): Arka planı renk veya görsellerle özelleştirme.
• Border (Kenarlık): Kenarlık ekleme ve köşe yarıçapı ayarları.
• Shadow (Gölge): Elementlere derinlik katmak için gölge efekti ekleme.