Yer arayın

search_places aracı, LLM'nin doğal dildeki bir sorgudan Google Haritalar'da yer bulmasını sağlar. Araç, eşleşen yerlerin yapay zeka tarafından üretilmiş bir özetini döndürür. Özet, alıntı yaptığı her yer için yer kimliğini, koordinatları, Google Haritalar bağlantılarını ve ilişkilendirmeyi de döndürür.

Bu sayfada, Pro seçenekleri dahil olmak üzere istek seçenekleri, yanıtın neleri içerdiği ve isteklerin nasıl faturalandırıldığı açıklanmaktadır. Araç şemasının tamamı için search_places referansına bakın.

İstek seçenekleri

LLM, aracı çağırırken kullanıcının isteğine ve aracın açıklamasına göre bu seçenekleri belirler. Kendi talimatlarınızla modelin hangi seçenekleri kullanacağını etkileyebilirsiniz. Pro kullanımını kontrol etme başlıklı makaleyi inceleyin.

Seçenek Açıklama
text_query Zorunlu. Arama sorgusu (ör. coffee shops near Golden Gate Park). Sorgu, net olması için yeterli konum bilgisi içermeli veya istekte location_bias bulunmalıdır.
location_bias Sonuçların yönlendirileceği bir daire (center ve isteğe bağlı radius_meters, en fazla 50.000 metre). text_query açık bir konum belirtiyorsa bunun yerine o konum kullanılır.
language_code Özetin dili (ör. en veya ja). Varsayılan olarak İngilizceye ayarlanır.
region_code Kullanıcının CLDR bölge kodu (ör. US). Bölgeye özgü yer adlarını etkiler ve geçerli yasaya göre sonuçları etkileyebilir.
page_size Döndürülecek maksimum yer sayısı. Varsayılan değer 5'tir. 6 ile 10 arasındaki değerler Pro seçeneğidir. 10'un üzerindeki değerler INVALID_ARGUMENT hatası döndürür. Hizmet, istenenden daha az yer döndürebilir.
include_extended_details true olduğunda özet, genişletilmiş yer ayrıntılarını içerir. Bu, Pro seçeneğidir. Varsayılan değer: false.

Pro seçenekleri

İki seçenek Pro SKU'yu seçer. Bunlardan birini veya her ikisini kullanan istekler Pro SKU'su kapsamında faturalandırılır:

Pro seçeneği Ne zaman kullanılır?
include_extended_details adresi true olarak ayarlandı Kullanıcının isteği, yorumlardan elde edilen analizler, öne çıkan menü öğeleri, atmosfer veya ziyaretçi ipuçları gibi kapsamlı yer ayrıntıları gerektiriyor.
page_size (6-10 yaş) Kullanıcı 5'ten fazla yeri karşılaştırmak istiyor.

1 ile 5 arasında page_size içeren istekler de dahil olmak üzere her iki seçeneği de kullanmayan istekler Essentials SKU'su kapsamında faturalandırılır.

Genişletilmiş yer ayrıntıları

Kullanıcının isteği nitel analizler, gerçek zamanlı koşullar veya özel özellikler gerektirdiğinde include_extended_details değerini true olarak ayarlayın. Örneğin:

  • Yorumcuların söyledikleri: Yorumlara dayalı analizler, müşteri yaklaşımı ve geri bildirimler.
  • Belirli teklifler: Menü öğeleri, yemekler, özel yemekler, içecekler veya işletmeyle ilgili öne çıkanlar.
  • Atmosfer: iç mekan dekoru, estetik, ambiyans veya ruh hali.
  • Ziyaretçiler için pratik ipuçları: önceden rezervasyon yapılması gerekip gerekmediği, randevusuz giriş politikaları, bekleme süreleri, yerin ne kadar yoğun olduğu, otopark ve tesisler.
  • Yakınlık: Kullanıcı yakınlarda veya en yakın olanın ne olduğunu sorduğunda sorgu konumuna ya da location_bias merkezine olan mesafe veya seyahat süresi.

Özetlerdeki analizler, sorguya ve her yer için mevcut verilere bağlıdır. Her yanıt, her analiz türünü içermez.

Standart aramalar için false (varsayılan) olarak bırakın: mutfaklar veya mağaza türleri, adresler, iletişim bilgileri, çalışma saatleri ve standart olanaklar. Ayrıntılı isteklerin tamamlanması daha uzun sürer.

Genişletilmiş ayrıntılar, yanıtın yapısını değiştirmez. Bu bilgiler yoksa özet, her yeri bir veya iki cümleyle açıklar. Bu sayede her yer, yorumlardan elde edilen analizler de dahil olmak üzere daha fazla Google Haritalar verisinden yararlanan daha uzun bir açıklama alır. Yapılandırılmış places girişleri her iki SKU için de aynıdır.

Örnek

Aşağıdaki istekte, kapsamlı ayrıntılar içeren en fazla 8 yer istenir. Pro SKU'su kapsamında faturalandırılır:

{
  "method": "tools/call",
  "params": {
    "name": "search_places",
    "arguments": {
      "text_query": "date night Italian restaurants in Chicago",
      "page_size": 8,
      "include_extended_details": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

Ayrıntılı bilgi içermeyen özet, her yeri bir veya iki cümleyle açıklar:

Örnek Trattoria [0] (4,6★ (1.250) · 123 W Example St · $$$) A neighborhood trattoria known for handmade pasta and a long wine list.

With extended details, the summary adds what reviewers highlight and practical tips:

Example Trattoria [0] (4.6★ (1,250) · 123 W Example St · $$$) Mum ışığında, samimi bir yemek salonu. Yorumcular burayı romantik ama hafta sonları gürültülü olarak tanımlıyor. Öne çıkan yemekler arasında tagliatelle al ragù, burrata ve tiramisu yer alır. Rezervasyon yaptırılması önerilir. Rezervasyonsuz gelenler cuma ve cumartesi akşamları 30-45 dakika bekleyebilir. Cadde üzeri park yeri sınırlıdır.

Yanıt

Yanıtta şunlar yer alır:

  • summary: Arama sonuçlarının doğal dildeki özeti. places içindeki girişlerle eşlenen [0] gibi sıfır tabanlı alıntılar içerebilir.
  • places[]: Özetlerde bahsedilen yerler. Her yer şunları içerir:
    • place: Yerin kaynak adı (places/{id} biçiminde).
    • id: Yer kimliği. Bu API'yi, yeri haritada göstermek gibi işlemler için diğer Google Haritalar Platformu API'leriyle birlikte kullanabilirsiniz.
    • location: Yerin enlem ve boylamı.
    • googleMapsLinks: Yer (placeUrl), yol tarifi (directionsUrl), yorumlar (reviewsUrl), fotoğraflar (photosUrl) ve yorum yazma (writeAReviewUrl) için Google Haritalar bağlantıları.
    • attribution: Yerle birlikte göstermeniz gereken atıf. İlişkilendirme koşulları bölümünü inceleyin.

Yanıt, her iki SKU için de aynı yapıya sahiptir. Alan ayrıntıları için search_places referansına bakın.

Sınırlı GA sırasında Pro seçenekleri

Kısıtlı GA sırasında Pro seçenekleri yalnızca Pro izin verilenler listesindeki projelerde kullanılabilir. Projeniz henüz izin verilenler listesinde değilse Pro seçenekleri reddedilmek yerine yoksayılır:

  • include_extended_details, false olarak kabul edilir.
  • page_size 10'un üzerindeki değerler de dahil olmak üzere 5'in üzerindeki değerler 5'e düşürülür.

İstek, Essentials SKU'su kapsamında faturalandırılır. Erişim isteğinde bulunmak için Sınıtlanmış GKST sırasında Sağlayıcı seçenekleri başlıklı makaleyi inceleyin.

Faturalandırma ve kotalar

Her search_places isteği, faturalandırılabilir bir etkinliktir:

search_places kotası, her iki SKU tarafından paylaşılan, proje başına dakikada 300 sorgudur. Fiyatlandırma için Ana fiyatlandırma tablosu ve Hindistan fiyatlandırma tablosu'na bakın.