Brave Local Search aksiyonu, Brave arama motorunun yerel arama özelliğini kullanarak konum bazlı sorgular yapmayı sağlar. Kullanıcıların bulundukları şehirde veya belirli bir bölgede işletmeler, mağazalar, restoranlar ya da hizmet sağlayıcılar hakkında bilgi almasına imkân tanır. Özellikle şehir rehberi, turizm, e-ticaret veya hizmet arama uygulamalarında tercih edilir.

Teknik Özellikler

Arama İşlemi (Search Paneli): Brave Local Search aksiyonu, verilen sorgu kelimesine (ör. “coffee shop”, “vet clinic”) uygun olarak yerel sonuçları döner. Dönen sonuçlar genellikle birden fazla kayıt içerir ve liste halinde kullanılabilir.

Parametreler:

• settings (Object – zorunlu): Brave API için gerekli ayarlardır. Configuration Manager üzerinden tanımlanmış Brave ayarları bu alanda seçilmelidir.
• query (String – zorunlu): Arama yapılacak anahtar kelime veya ifade. (Ör. “pizza restaurant”, “hospital near me”).
• count (Int32 – zorunlu): Döndürülecek sonuç sayısını belirtir. Varsayılan 0 girildiğinde sonuç dönmez.

Veri Kaynağı Uyumluluğu: Tüm parametreler sabit (Fixed) değerler olarak tanımlanabileceği gibi, Symbol Picker aracılığıyla Form Input, Current, Action Result, Method Input gibi dinamik kaynaklardan da bağlanabilir.

Web & Mobil Destek: Brave Local Search aksiyonu hem web hem de mobil uygulamalarda kullanılabilir.

Brave Local Search Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Kuika projenizi açın.
• UI Design modülüne geçin ve yerel arama yapılacak ekranı seçin.
• Bir Text Input (arama kutusu) ve Button (ör. “Yakındaki Yerleri Ara”) elementi ekleyin.
• Butona tıklayın ve + ADD ACTION menüsünden OnClick → Brave Search →  Brave Local Search aksiyonunu seçin.

2. Parametreleri Yapılandırma

• settings: Configuration Manager’da oluşturduğunuz Brave API ayarını seçin.
• query: Text Input alanından alınacak değeri bağlayın (örn. kullanıcı “kuaför” yazarsa, sonuçlarda yakın kuaförler listelenecektir).
• count: Sonuç sayısını belirleyin (örn. 10).

Kullanım Senaryosu: Yakındaki Restoranları Bulma

Bir şehir rehberi uygulamasında, kullanıcı bulunduğu şehirde restoran aramak ister.

Adımlar:

1. Bir Text Input elementi ekleyin (“Restoran Ara”).
2. “Ara” butonuna OnClick → Brave Local Search aksiyonu ekleyin.
3. Query parametresini Text Input’a bağlayın.
4. Count parametresini 10 olarak girin.
5. Dönen sonuçları Table elementi ile ekranda gösterin.

Brave Local Search İleri Seviye Özelleştirmeler

• Dinamik Sorgu: Kullanıcının bulunduğu konuma göre otomatik “near me” aramaları yapılabilir.
• Filtreleme: Sonuçlardan yalnızca belirli kategoriler (ör. restoran, otel, eczane) filtrelenebilir.
• Sonuçların Harita Üzerinde Gösterimi: Brave Local Search sonuçları, Maps elementi ile eşleştirilip görselleştirilebilir.
• Sonuçların Kaydedilmesi: Kullanıcı favorilerine ekleyebilir veya veritabanına kaydedebilir.

Teknik Riskler ve Kontroller

• query boş olmamalıdır. Zorunlu parametre olduğu için boş bırakıldığında sonuç dönmez.
• count = 0 verilirse sonuç alınamaz. Minimum 1 veya daha yüksek bir değer girilmelidir.
• settings ayarı doğru yapılmalıdır. Configuration Manager’da Brave ayarları yapılmazsa aksiyon çalışmaz.
• Sonuçların Formatı: Dönen sonuçlar JSON formatındadır; işletme adı, adres, puan gibi alanların doğru bağlanması gerekir.