Kullanıcı Kılavuzu

Maps

30/6/25
Maps

Kuika'nın Maps elementi, uygulamanızda coğrafi verileri görsel olarak sunar. Kullanıcılar, harita üzerinde konumları görüntüleyebilir, yakınlaştırabilir ve belirli alanları inceleyebilir. Maps elementi, mağaza konumlarını belirtmek, rota çizmek veya konum tabanlı hizmetler sunmak için idealdir. Bu eğitim içeriğinde, Maps elementini nasıl kullanacağınızı ve ayarlarını nasıl yapılandıracağınızı öğreneceksiniz.

Maps elementi, birbirine çok yakın olan pinleri otomatik olarak gruplandırarak daha düzenli bir harita görünümü sunar. Bu sayede yoğun konum bulunan bölgelerde kullanıcı deneyimi iyileştirilir ve harita okunabilirliği artar.

Bu eğitim içeriği aşağıdaki başlıklardan oluşur: 

  • Maps Elementi Ekleme
  • Maps Elementi Özellikleri
  • Element ayarları ve özelleştirme

Maps Elementi Ekleyin

  1. Kuika platformuna giriş yapın.
  2. Apps ekranından çalışacağınız projeyi açın.
  1. 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.

Maps Elementi Özellikleri

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.

Element Ayarları ve Özelleştirme

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar