MCP Tools Reference: mapstools.googleapis.com

MCP Araçları Referansı:

Bu belgede, Google Uzak Model Bağlamı Protokolü (MCP) Araçları'nı çağırmak için kullanılan, harici kullanıma yönelik REST API uç noktaları açıklanmaktadır. Bu API, harici bir HTTP istemcisi (ör. curl veya bir web hizmeti) ile dahili MCP sunucusu arasında güvenli bir proxy görevi görür.

MCP aracı özelliklerini edinme

Bir MCP sunucusundaki tüm araçların MCP aracı spesifikasyonlarını almak için `tools/list` yöntemini kullanın. Aşağıdaki örnekte, MCP sunucusunda şu anda kullanılabilen tüm araçları ve özelliklerini listelemek için curl komutunun nasıl kullanı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/list",
    "jsonrpc": "2.0",
    "id": 1
}'

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 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) gelir. Ö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"), 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.

  • Her zaman mümkün olan en spesifik ve bağlamsal olarak 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 örneklerde, search_places MCP aracını çağırmak için curl simgesinin nasıl kullanı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: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Araç: lookup_weather

Herhangi bir konum için mevcut koşulları, saatlik ve günlük tahminleri sağlar. Hava durumuyla ilgili tüm sorularınız için bu aracı kullanın.

Kullanılabilir Veriler: Sıcaklık (Anlık, Hissedilen, Maksimum/Minimum, Isı İndeksi), Rüzgar (Hız, Esme, Yön), Gök Olayları (Gündoğumu/Günbatımı, Ay Evresi), Yağış (Tür, Olasılık, Miktar/QPF), Atmosferik Koşullar (UV İndeksi, Nem, Bulut Örtüsü, Fırtına Olasılığı) ve Coğrafi Kodlu Konum Adresi.

Giriş Koşulları (KRİTİK):

  • Mevcut koşullar: Yalnızca bir konum (ör. şehir veya adres) gerekir. Tarih veya saat belirtmeyin.

  • Saatlik Hava Durumu Tahminleri: Konum ve saat (0-23) gerektirir. Kullanıcı belirli bir saatteki hava durumunu veya "önümüzdeki birkaç saat" ya da "bugün ilerleyen saatlerde" gibi terimleri kullanarak hava durumunu soruyorsa kullanın.

  • Günlük Tahminler: Konum ve tam tarih gerekir.

Tarih İşleme (KRİTİK): Kullanıcı tarafından sağlanan tarihler ve saatler, istenen konumun yerel saat diliminde sağlanmalıdır. Tarihler YIL, AY ve GÜN olmak üzere ayrı tam sayı parametrelerine ayrılmalıdır. Bu parametreler için gerekli biçim şöyledir: {"year": , "month": , "day": }

Aşağıdaki örneklerde, lookup_weather MCP aracını çağırmak için curl nasıl kullanı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": lookup_weather,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Araç: compute_routes

Belirtilen bir başlangıç noktası ile varış noktası arasındaki seyahat rotasını hesaplar. Desteklenen ulaşım şekilleri: ARABA (varsayılan), YÜRÜME.

Giriş Koşulları (KRİTİK): Hem kalkış hem de varış noktası gerekir. Her biri, kendi alanına yerleştirilmiş olarak aşağıdaki yöntemlerden biri kullanılarak sağlanmalıdır:

  • address: (dize, ör. "Eyfel Kulesi, Paris"). Not: Giriş adresi ne kadar ayrıntılı veya belirli olursa sonuçlar da o kadar iyi olur.

  • lat_lng: (object, {"latitude": number, "longitude": number})

  • place_id: (dize, ör. "ChIJOwE_Id1w5EAR4Q27FkL6T_0") Not: Bu kimlik, search_places aracından alınabilir. Giriş türlerinin herhangi bir kombinasyonuna izin verilir (ör. adresle başlangıç noktası, enlem/boylam ile hedef). Kaynak veya hedef eksikse aracı çağırmadan önce KULLANICIDAN AÇIKLAMA İSTEMENİZ GEREKİR.

Örnek Araç Çağrısı: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

Aşağıdaki örneklerde, compute_routes MCP aracını çağırmak için curl simgesinin nasıl kullanı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": compute_routes,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'