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.

• Datasource: Haritada gösterilecek konumların veri kaynağını belirler. REST API ve SQL Actions gibi kaynaklar desteklenir.
• Latitude: Haritanın ilk açılışta odaklanacağı enlem değeridir. Statik veya dinamik olarak atanabilir.
• Longitude: Haritanın ilk açılışta odaklanacağı boylam değeridir.
• Circle Radius In Km: Harita üzerinde belirli bir alanı dairesel bir sınır içinde 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.
• Group Picker Icon: Yakın konumların zoom-out sırasında tek bir simge altında gruplandırılmasını sağlar.
• Current Location Icon: Kullanıcının mevcut konumunu gösterir.
• Selected Location Icon: Kullanıcının seçtiği konumu işaretler.
• Keep Center On Zoom: Zoom işlemi sırasında harita merkezi sabit kalır.
• Map Type: Haritanın görünüm tarzını belirler. Desteklenen harita türleri şunlardır:
  
  • Roadmap: Standart yol haritasıdır. Karayolları, sokaklar ve şehir detayları net bir şekilde gösterilir.
  • Terrain: Yükselti farklarını ve doğal arazi özelliklerini gösteren bir harita türüdür. Dağlar, tepeler ve vadiler belirgin hale gelir.
  • Satellite: Uydu görüntülerini kullanarak haritayı gerçek dünya görselleriyle gösterir. Binalar, doğa alanları ve su kaynakları net bir şekilde görülür.
  • Hybrid: Uydu görüntüleri ile yol ve yerleşim bilgilerini birleştiren bir harita modudur. Uydu görüntülerinin üzerine yol ve şehir isimleri eklenerek daha kapsamlı bir görünüm sunar.
• 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.
• 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.
• Waypoints: Girilen lokasyonlara, kullanıcının mevcut konumundan otomatik rota çizilmesini sağlar.
• FullScreenControl: Haritanın tam ekran moduna alınıp alınamayacağını kontrol eder.
• StreetViewControl (Web): Sokak görünümüne geçiş yapılabilmesini sağlar.
• ScaleControl (Web): Harita üzerinde mesafe ölçeğinin gösterilip gösterilmeyeceğini belirler.
• Zoom: Haritanın ilk yüklendiğinde hangi yakınlık seviyesinde açılacağını belirler.
  
  • Harita, ekran ilk açıldığında bu değer üzerinden render edilir.
  • Kullanıcı sonradan zoom yapabilir; bu ayar yalnızca başlangıç görünümünü etkiler.
  • Geçerli değer aralığı:
    
    • 0: En uzak görünüm
    • 22: En yakın görünüm
  • Çok düşük veya çok yüksek bir zoom değeri seçilmesi, kullanıcının haritayı ilk açılışta anlamasını zorlaştırabilir.
• ZoomControl (Web): Harita yakınlaştırma ve uzaklaştırma butonlarının gösterilip gösterilmeyeceğini belirler.
• CameraControl (Web): Harita perspektifini ve kamera açısını kontrol etmeyi sağlar.
• EnableLocationTracking (Web + Mobil): Kullanıcının anlık konumunun harita üzerinde gerçek zamanlı izlenmesini sağlar.

Latitude ve Longitude değerleri “Decimal” formatında olmalıdır.

Maps elementi, latitude ve longitude değerleri Null (boş) olduğunda bile harita ekranını açar ve diğer konumları görüntüler. 

Konum Alma

• Google Maps üzerinden bir konumun enlem ve boylam değerlerini almak için haritada sağ tıklayıp çıkan menüden koordinatları kopyalayabilirsiniz. Bu değerleri Maps elementinin Latitude ve Longitude alanlarına ekleyin.

Events

• 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ı yakınlaştırma veya uzaklaştırma yaptığında etkinleşir.

Maps elementi, farklı veri kaynaklarından gelen bilgileri harita üzerinde dinamik olarak gösterir. Böylece uygulamanız, konum tabanlı hizmetleri daha kullanıcı dostu ve etkileşimli bir şekilde sunabilir.

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 koşullara bağlı olarak görünür.

Sometimes Visible seçeneği kullanıldığında AND / OR grupları doğrudan eklenebilir ve görünürlük kuralları birlikte gruplandırılarak daha karmaşık senaryolar rahatlıkla yönetilebilir.

Ayarı yapılandırmak için:

• Ekrandaki elementi seçin.
• Sağ kenardaki Properties panelini açın.
• 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.