MCP Tools Reference: mapstools.googleapis.com

Araç: search_places

Kullanıcının isteği yerleri, işletmeleri, adresleri, konumları, ilgi çekici noktaları veya Google Haritalar ile ilgili başka bir aramayı bulmak olduğunda bu aracı çağırın.

Giriş Koşulları (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 (object - İSTEĞE BAĞLI): Belirli bir coğrafi bölgenin yakınındaki sonuçlara öncelik vermek için kullanılır.

    • Biçim: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • Kullanım:
      • 5 km yarıçaplı bir alana öncelik vermek için: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • Odak noktasına güçlü bir şekilde ağırlık vermek için: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (radius_meters atlanarak).

  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), isteğe bağlı olarak bir alt çizgi ve iki harfli bir ülke kodu (ISO 3166-1 alfa-2) ile birlikte, örneğin en, ja, en_US, zh_CN, es_MX. Dil kodu sağlanmazsa sonuçlar İngilizce olarak gösterilir.

  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), örneğin US, CA.

Instructions for Tool Call:

  • Konum bilgileri (KRİTİK): Arama, yeterli konum bilgisi içermelidir. Konum belirsizse (ör. yalnızca "pizza yerleri"), text_query içinde belirtmeniz (ör. "New York'taki pizza yerleri") veya location_bias parametresini kullanmanız gerekir. Belirsizliği gidermek için gerekirse şehir, eyalet/il ve bölge/ülke adını ekleyin.

  • Mümkün olduğunca spesifik ve bağlam açısından zengin text_query yanıtlar verin.

  • Yalnızca koordinatlar açıkça sağlanıyorsa veya kullanıcının bilinen bağlamından konum çıkarımı yapmak daha iyi sonuçlar için uygun ve gerekliyse location_bias kullanın.

  • Temellendirilmiş çıktı, varsa attribution alanındaki bilgiler kullanılarak kaynağa atfedilmelidir.

Aşağıdaki örnekte, curl kullanılarak search_places MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği 
                  
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_places",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

SearchText için istek mesajı.

SearchTextRequest

JSON gösterimi 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "pageToken": string,

  // 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.
}
Alanlar
textQuery

string

Zorunlu. Metin sorgusu.
languageCode

string

İsteğe bağlı. Özetin döndürülmesini istediğiniz dil. Dil kodu belirtilmemişse veya tanınmıyorsa İngilizce tercihli özet döndürülür.

Örneğin, İngilizce için "en".

Desteklenen dillerin güncel listesi: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

İsteğe bağlı. İsteğin gönderildiği konumun Unicode ülke/bölge kodu (CLDR). 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.

Örneğin, "US" (ABD)

Daha fazla bilgi için https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html adresine bakın.

3 haneli bölge kodlarının şu anda desteklenmediğini unutmayın.
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum yer sayısı. Hizmet, bu değerden daha az sonuç döndürebilir.
pageToken

string

İsteğe bağlı. Önceki bir SearchText çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

_location_bias birleşik alanı.

_location_bias aşağıdakilerden yalnızca biri olabilir:
locationBias

object (LocationBias)

Arama sonuçlarını yönlendirmek için isteğe bağlı bir bölge. text_query içinde açık bir konum varsa bu alan yerine arama sonuçlarını etkilemek için kullanılır.

LocationBias

JSON gösterimi 
{
  "circle": {
    object (Circle)
  }
}
Alanlar
circle

object (Circle)

İsteğe bağlı. Merkez noktası ve yarıçap ile tanımlanan bir daire. radius_meters isteğe bağlıdır. Ayarlanmazsa sonuçlar odak noktasına doğru eğilim gösterir.

Daire

JSON gösterimi 
{
  "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.
}
Alanlar
center

object (LatLng)

Zorunlu. Dairenin odak noktası.

_radius_meters birleşik alanı.

_radius_meters aşağıdakilerden yalnızca biri olabilir:
radiusMeters

number

Çemberin metre cinsinden yarıçapı. Yarıçap 50.000 metre içinde olmalıdır.

LatLng

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Boylam (derece cinsinden). [-180.0, +180.0] aralığında olmalıdır.

Çıkış şeması

SearchText için yanıt mesajı.

SearchTextResponse

JSON gösterimi 
{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string,
  "nextPageToken": string
}
Alanlar
places[]

object (PlaceView)

Yalnızca çıkış. Özette bahsedilen yerlerin listesi.
summary

string

Yalnızca çıkış. Arama sonuçlarının doğal dilde özeti. Özette "[0]", "[1]", "[2]" gibi sıfır tabanlı alıntılar yer alabilir. Bu alıntılar, places alanındaki ilgili yerlerle eşlenir.
nextPageToken

string

İsteğe bağlı. Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton.

PlaceView

JSON gösterimi 
{
  "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.
}
Alanlar
place

string

Temel yerin kaynak adı "places/{id}" biçimindedir.
id

string

Temel yerin yer kimliği.
googleMapsLinks

object (GoogleMapsLinks)

Farklı Google Haritalar işlemlerini tetikleyen bağlantılar.
attribution

object (Attribution)

Yerle birlikte gösterilmesi için atıfta bulunulması gerekir.

_location birleşik alanı.

_location aşağıdakilerden yalnızca biri olabilir:
location

object (LatLng)

Bu yerin konumu.

LatLng

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Boylam (derece cinsinden). [-180.0, +180.0] aralığında olmalıdır.
JSON gösterimi 
{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}
Alanlar
directionsUrl

string

Yere yol tarifini gösteren bir bağlantı. Bağlantı yalnızca hedef konumu doldurur ve varsayılan seyahat modunu DRIVE kullanır.
placeUrl

string

Bu yeri gösterme bağlantısı.
writeAReviewUrl

string

Google Haritalar'da bu yerle ilgili yorum yazabileceğiniz bir bağlantı.
reviewsUrl

string

Bu yerle ilgili yorumları Google Haritalar'da gösterme bağlantısı.
photosUrl

string

Bu yerin fotoğraflarını Google Haritalar'da gösterme bağlantısı.

İlişkilendirme

JSON gösterimi 
{
  "title": string,
  "url": string
}
Alanlar
title

string

İlişkilendirme için gösterilecek başlık.
url

string

İlişkilendirme için bağlantı verilecek URL.

Araç Ek Açıklamaları

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