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, enlem/boylam koordinatlarını, Google Haritalar bağlantılarını ve atıfları da döndürür.

search_places aracını MCP sunucusu üzerinden veya searchText REST yöntemi olarak çağırabilirsiniz. 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. Şemaların tamamı için search_places MCP referansına ve searchText REST 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 ayarlar. Kendi talimatlarınızla modelin hangi seçenekleri kullanacağını etkileyebilirsiniz. Pro kullanımını kontrol etme başlıklı makaleyi inceleyin.

Aşağıdaki tabloda search_places için istek seçenekleri açıklanmaktadır:

Pro seçenekleri

Maps Grounding Pro SKU'sunu seçmek için iki seçenek vardır. Bunlardan birini veya her ikisini kullanan istekler Pro SKU'su kapsamında faturalandırılır:

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 için nitel analizler, anlık koşullar veya özel özellikler gerektiğ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.
• Özel teklifler: Menü öğeleri, yemekler, özel yemekler, içecekler veya işletmeyle ilgili öne çıkanlar.
• Atmosfer: iç dekor, 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ında 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 MCP isteği, ayrıntılı bilgiler içeren en fazla 8 yer ister. 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
}

Aşağıdaki örnekte, aynı istek searchText REST yöntemine gönderilmektedir:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
  "textQuery": "date night Italian restaurants in Chicago",
  "pageSize": 8,
  "includeExtendedDetails": true
}' \
"https://mapstools.googleapis.com/v1:searchText"

API_KEY kısmını API anahtarınızla değiştirin.

Genişletilmiş ayrıntılar olmadan ö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 aşağıdaki alanlar bulunur:

• 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/boylam koordinatları.
  • 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.
• contentToken: Yanıttaki yerleri ek ücret ödemeden Places UI Kit ile görüntülemenize olanak tanıyan temsilci veri görselleştirme jetonu (Önizleme). Yanıt en az bir yer içerdiğinde döndürülür.

Yanıt, hem SKU'lar hem de MCP ve REST için aynı yapıya sahiptir. Alan ayrıntıları için search_places referansına bakın.

Faturalandırma ve kotalar

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

• Pro seçeneklerini kullanmayan istekler, Maps Grounding Essentials SKU'su kapsamında faturalandırılır.
• Pro seçeneğini kullanan istekler, Maps Grounding Pro SKU'su kapsamında faturalandırılır. Tek bir istekte her iki seçeneği de kullanmak ücreti değiştirmez. Pro fiyatlandırması için Essentials, Pro ve Google Haritalar ile Temellendirme'yi karşılaştırma başlıklı makaleyi inceleyin.

search_places yanıtındaki yerleri Places UI Kit ile gösteriyorsanız bu Places UI Kit isteklerinin faturalandırılmaması için aracı veri görselleştirme jetonunu (Önizleme) kullanabilirsiniz.

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