MCP Tools Reference: mapstools.googleapis.com

Araç: search_places

Kullanıcı yer, işletme, adres, konum, önemli yer veya Google Haritalar ile ilgili başka bir arama yapmak istediğinde bu aracı çağırın.

Giriş Şartları (KRİTİK):

1. text_query (dize - ZORUNLU): Birincil arama sorgusu. Bu, kullanıcının ne aradığını net bir şekilde tanımlamalıdır.

   • Örnekler: 'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'.
   • Belirli yer ayrıntıları için: İstenen özelliği (ör. 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address') ekleyin.

2. location_bias (nesne - İSTEĞE BAĞLI): Belirli bir coğrafi bölgenin yakınındaki sonuçlara öncelik vermek için bunu kullanın.

   • Biçim: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
   • Kullanım:
     • 5 km'lik bir yarıçapa yönlendirmek için: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
     • Merkez noktaya güçlü bir şekilde yönlendirmek için: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (radius_meters hariç).

3. language_code (dize - İSTEĞE BAĞLI): Arama sonuçları özetinin gösterileceği dil.

   • Biçim: İki harfli bir dil kodu (ISO 639-1) ve isteğe bağlı olarak ardından bir alt çizgi ve iki harfli bir ülke kodu (ISO 3166-1 alfa-2) gelir (ör. en, ja, en_US, zh_CN, es_MX). Dil kodu sağlanmazsa sonuçlar İngilizce olur.

4. region_code (dize - İSTEĞE BAĞLI): Kullanıcının Unicode CLDR bölge kodu. Bu parametre, varsa bölgeye özgü yer adı gibi yer ayrıntılarını görüntülemek için kullanılır. Parametre, geçerli yasaya göre sonuçları etkileyebilir.

   • Biçim: İki harfli ülke kodu (ISO 3166-1 alfa-2), ör. US, CA.

5. page_size (tam sayı - İSTEĞE BAĞLI): Döndürülecek maksimum yer sayısı (1 ile 10 arasında). Varsayılan değer 5'dir. Yalnızca kullanıcı 5'ten fazla yeri karşılaştırmak istediğinde 5 değerinin üzerine ayarlayın. 6 ile 10 arasındaki değerler daha yüksek maliyet ve daha yüksek gecikmeye neden olur.

6. include_extended_details (Boole - İSTEĞE BAĞLI): Kullanıcı isteği zengin niteliksel analizler, gerçek zamanlı dinamikler veya özel varlık özellikleri gerektirdiğinde bu alanı true olarak ayarlayın. Varsayılan değer false'dir. Bu ayarın true olarak belirlenmesi daha yüksek maliyet ve gecikmeye neden olur.

Araç Çağrısı Talimatları:

• Konum Bilgisi (KRİTİK): Aramada yeterli konum bilgisi bulunmalıdır. Konum belirsizse (ör. yalnızca "pizzacılar") text_query parametresinde konumu belirtmeniz (ör. "New York'taki pizzacılar") veya location_bias parametresini kullanmanız gerekir. Anlam belirsizliğini gidermek için gerekirse şehir, eyalet/il ve bölge/ülke adını ekleyin.

• Her zaman mümkün olan en spesifik ve bağlam açısından en zengin text_query sağlayın.

• location_bias aracını yalnızca koordinatlar açıkça belirtilmişse veya kullanıcının bilinen bağlamından konum çıkarımı yapmak uygunsa ve daha iyi sonuçlar için gerekliyse kullanın.

• Temellendirilmiş çıkış, mümkün olduğunda attribution alanındaki bilgiler kullanılarak kaynağa atfedilmelidir.

Aşağıdaki kod örneğinde, search_places MCP aracını çağırmak için curl öğesinin nasıl kullanılacağı gösterilmektedir.

Giriş şeması

{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,

  // Union field _location_bias can be only one of the following:
  "locationBias": {
    object (LocationBias)
  }
  // End of list of possible types for union field _location_bias.
}

{
  "circle": {
    object (Circle)
  }
}

{
  "center": {
    object (LatLng)
  },

  // Union field _radius_meters can be only one of the following:
  "radiusMeters": number
  // End of list of possible types for union field _radius_meters.
}

{
  "latitude": number,
  "longitude": number
}

Çıkış şeması

{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string,
  "contentToken": string
}

{
  "place": string,
  "id": string,
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _location can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field _location.
}

{
  "latitude": number,
  "longitude": number
}

{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}

{
  "title": string,
  "url": string
}

Araç Notları

Araç ek açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilir olarak değerlendirmez ancak kullanıcıya ne zaman onay istemi gönderileceğine karar vermek için kullanılabilir.

Başlık dizesiyle birlikte aşağıdaki boole ipuçları şu şekilde tanımlanır:

• readOnlyHint: Doğru ise araç, ortamını değiştirmez. Varsayılan: false.
• destructiveHint: Doğru ise araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
• idempotentHint: Doğru ise aracın aynı bağımsız değişkenlerle tekrar tekrar çağrılması, ortamı üzerinde ek bir etki yaratmaz. Varsayılan: false.
• openWorldHint: Doğru ise araç, harici varlıkların "açık dünyası" ile etkileşim kurabilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya olurken bellek aracı açık dünya olmaz.

Yıkıcı İpucu: ❌ | Aynı Sonucu Veren İpucu: ❌ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌