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ı (ÇOK ÖNEMLİ):

  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 ekleyin (ör. 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').

  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}}}
      • Merkez noktaya güçlü bir şekilde önyargılı olmak 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 dil kodu (ISO 639-1), isteğe bağlı olarak ardından alt çizgi ve iki harfli ülke kodu (ISO 3166-1 alfa-2), ör. 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"), bunu text_query içinde belirtmeniz text_query gerekir (ör. "New York'taki pizzacılar") veya location_bias parametresini kullanın. Belirsizliği gidermek için gerekirse şehir, eyalet/il ve bölge/ülke adını ekleyin.

  • Mümkün olduğunca en ayrıntılı ve bağlam açısından zengin text_query yanıtı 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.

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ıdır. Ö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ıdır. İ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ır. Döndürülecek maksimum yer sayısı. Hizmet, bu değerden daha az sonuç döndürebilir.
pageToken

string

İsteğe bağlıdır. Ö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ıdır. Merkez noktası ve yarıçap ile tanımlanan bir daire. radius_meters isteğe bağlıdır. Ayarlanmazsa sonuçlar merkez noktasına doğru eğilim gösterir.

Daire

JSON gösterimi 
{
  "center": {
    object (google.type.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 (google.type.LatLng)

Zorunlu. Dairenin merkez 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ıdır. Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton.

PlaceView

JSON gösterimi 
{
  "place": string,
  "id": string,
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },

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

string

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

string

Temel yerin yer kimliği.
googleMapsLinks

object (GoogleMapsLinks)

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

_location birleşik alanı.

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

object (google.type.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 yazma bağlantısı.
reviewsUrl

string

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

string

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

Araç Ek Açıklamaları

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