Kuika’nın Location Search elementi, kullanıcıların harita üzerinde belirli bir konumu arayarak bulmalarını sağlar. Kullanıcı, aramak istediği yerin adını yazar ve sistem o konumu harita üzerinde işaretler. Özellikle mekan arama, rota belirleme veya konum tabanlı listeleme gibi senaryolarda kullanılır. 

Location Search elementi hem web hem de mobil uygulamalarda kullanılabilir.

Kullanım Alanları

• Harita tabanlı uygulamalarda adres veya mekan arama
• Rota oluşturma ve hedef konum belirleme
• Yakındaki işletmeleri, kafeleri veya otelleri bulma
• Konum bazlı veri filtreleme

Kullanım Senaryosu – Kafe Arama

Bir mobil uygulamada kullanıcı, bulunduğu konuma yakın kafeleri bulmak için Location Search elementini kullanır.

Senaryoda:

• Kullanıcı ekranın üst kısmında “Location Search” başlıklı bir arama çubuğu görür.
• “Café” kelimesini yazdığında, harita üzerinde en yakın kafeler listelenir.
• Harita üzerinde kırmızı bir pin (konum işareti) belirir.
• Arama sonuçları alt kısımda liste halinde gösterilir:
  
  • “Vanilla Cafe #1” → 144 Street, Paris
  • “Vanilla Cafe #2” → 5002 Street, Versailles
• Kullanıcı bir sonuca tıklayarak detay sayfasına yönlendirilebilir.

UI Design Modülü İşlemleri

1. UI Design modülüne gidin.
2. Sol kenardaki Elements > Select Input kategorisinden Location Search elementini sürükleyip bırakın.
3. Properties panelinde şu ayarları yapın:

• Placeholder: “Search location or address”
• Allow Clear: Aktif (kullanıcı tek tıklamayla metni temizleyebilir)
• Value: Statik olarak “Café” veya dinamik olarak Symbol Picker’dan bir değişkene bağlanabilir.

4. İsteğe bağlı olarak Map View elementi ekleyip Location Search ile senkronize edin:
   
   • Arama sonuçları harita üzerinde işaretlenir.
   • Seçilen sonuç harita merkezine alınır.

Özelliklerin Senaryo Bağlamında Kullanılması

• Placeholder: Kullanıcıya hangi bilgiyi yazması gerektiğini gösterir (ör. “Search location or address”).
• Allow Clear: Girilen metni hızlıca temizleme işlevi ekler.
• Value: Kullanıcının yazdığı veya dinamik olarak gelen arama terimini gösterir.

Senaryo Tamamlandığında

• Kullanıcı “Café” yazarak yakın kafeleri arar.
• Haritada arama sonucu pin ile gösterilir.
• Alt bölümde kafe listesi dinamik olarak güncellenir.
• Kullanıcı bir kafeye tıklayarak detay sayfasına geçiş yapabilir.

Kısıtlamalar

• Location Search, internet bağlantısı ve Google Maps API anahtarı gerektirir.
• Harita ile birlikte kullanılmadığında yalnızca metin tabanlı sonuç gösterir.
• Mobil cihazlarda GPS izinleri verilmezse arama sonuçları sınırlı olabilir.

İpuçları ve Best Practices

• Kullanıcıya açık yönlendirme için açıklayıcı placeholder kullanın (“Search nearby cafés, hotels or shops”).
• Harita üzerinde konum pin’ini vurgulu renklerle gösterin.
• Arama sonuçlarını liste formatında göstermek kullanıcı deneyimini artırır.
• Allow Clear özelliğini aktif tutarak hızlı tekrar arama imkânı sağlayın.