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 bir alt çizgi ve iki harfli bir ülke kodu (ISO 3166-1 alfa-2) (ö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östermek 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.

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 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 zengin text_query kullanı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ç notları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilir olmayan olarak değerlendirir 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şime girebilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya iken bellek aracı açık dünya değildir.

Yıkıcı İpucu: ❌ | Eşgüçlü İpucu: ❌ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌