Google Map Search Places aksiyonu, belirli bir konum (latitude, longitude) ve yarıçap (radius) çerçevesinde, girilen sorgu (query) ifadesine uygun mekanları bulmak için kullanılır. Restoran, kafe, otel, banka veya herhangi bir işletme gibi yerleri aramak için idealdir. Kullanıcıya yakın noktaları listeleyerek uygulamalarda konum tabanlı arama deneyimi sağlar.

Teknik Özellikler

• İşlev: Belirlenen konum ve yarıçap içinde mekan arama.
• Parametreler:
  
  • settings (Object – zorunlu): Google Maps ayarları.
  • query (String – zorunlu): Aranacak mekan türü/ismi (ör. "restaurant", "ATM", "hotel").
  • latitude (Double – zorunlu): Aramanın merkez noktası için enlem.
  • longitude (Double – zorunlu): Aramanın merkez noktası için boylam.
  • radius (Double – zorunlu): Arama yarıçapı (metre cinsinden).
• Sonuç: Tekil (One) → Arama sonuçlarını içeren yanıt nesnesi döner (içinde mekan listesi olur).
• Değer Bağlama:
  
  • Sabit değer (Fixed Value).
  • Dinamik olarak kullanıcı konumundan veya harita seçiminden alınabilir.

Google Map Search Places Uygulama Adımları

1. Aksiyon Ekleme

• Projede arama yapılacak ekrana gidin.
• UI Design → + ADD ACTION → Google → Google Map Search Places seçin.

2. Parametreleri Yapılandırma

• settings: Google Maps bağlantı ayarlarını seçin.
• query: "restaurant", "pharmacy", "supermarket" gibi değer girin.
• latitude / longitude: Kullanıcının mevcut konumu ya da haritada seçilen nokta.
• radius: Örn. 1000 → 1 km yarıçapında arama.
• Enable Audit Log: Aktif edildiğinde, aktif delegasyonların sorgulanması işlemi audit log kayıtlarına eklenir. Bu sayede hangi kullanıcının delegasyon bilgilerinin, ne zaman ve hangi aksiyon aracılığıyla görüntülendiği izlenebilir.

Kullanım Senaryosu: "Yakındaki Restoranları Listeleme"

Bir yemek sipariş uygulamasında, kullanıcı “yakınımdaki restoranlar” butonuna tıkladığında:

1. Cihaz konumu alınır: latitude = 41.0082, longitude = 28.9784.
2. query = "restaurant", radius = 1500 (1.5 km).
3. Aksiyon çalışır → Dönen sonuçta restoran listesi gelir.
4. Uygulama bu listeyi harita üzerinde veya kart görünümünde gösterir.

Google Map Search Places İleri Seviye Özelleştirmeler

• Kategori Bazlı Arama: Query parametresi kullanıcı seçiminden alınabilir (ör. "Kafe", "Market").
• Dinamik Radius: Kullanıcı farklı mesafe filtreleri seçebilir (örn. 500 m – 2 km).
• Adresle Kombine Kullanım: Önce Geocode aksiyonu ile adres koordinatlara çevrilir, sonra bu koordinatlar ile Search Places yapılır.

Teknik Riskler ve Kontroller

• Çok geniş radius değerleri (ör. 50 km) API performansını düşürebilir.
• Query boş bırakılırsa Google en yakın popüler yerleri dönebilir.
• API kota limitlerine dikkat edilmeli.