MCP Reference: mapstools.googleapis.com

Model Context Protocol (MCP) sunucusu, Büyük Dil Modeli'ne (LLM) veya yapay zeka uygulamasına bağlam, veri ya da özellikler sağlayan harici bir hizmet ile bu hizmet arasında proxy görevi görür. MCP sunucuları, yapay zeka uygulamalarını veritabanları ve web hizmetleri gibi harici sistemlere bağlar ve yanıtlarını yapay zeka uygulamasının anlayabileceği bir biçime çevirir.

Bu, Maps Grounding Lite API tarafından sağlanan bir MCP sunucusudur. Sunucu, geliştiricilerin Google Haritalar Platformu üzerinde LLM uygulamaları oluşturması için araçlar sağlar.

Sunucu uç noktaları

MCP hizmeti uç noktası, bir yapay zeka uygulamasının (MCP istemcisinin ana makinesi) güvenli ve standartlaştırılmış bir bağlantı kurmak için kullandığı MCP sunucusunun ağ adresi ve iletişim arayüzüdür (genellikle bir URL). Bağlam istemek, bir aracı çağırmak veya bir kaynağa erişmek için LLM'nin iletişim noktasıdır. Google MCP uç noktaları küresel veya bölgesel olabilir.

mapstools.googleapis.com MCP sunucusunun aşağıdaki MCP uç noktası vardır:

MCP Araçları

MCP Aracı, MCP Sunucusu'nun gerçek dünyada bir işlem gerçekleştirmek için LLM'ye veya yapay zeka uygulamasına sunduğu bir işlev ya da yürütülebilir özelliktir.

mapstools.googleapis.com MCP sunucusunda aşağıdaki araçlar bulunur:

MCP Araçları
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.
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": }
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"}