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 hizmeti kullanan uygulama 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.

Sunucu Kurulumu

Kullanmadan önce MCP sunucularını etkinleştirmeniz ve kimlik doğrulamayı ayarlamanız gerekir. Google ve Google Cloud uzaktan MCP sunucularını kullanma hakkında daha fazla bilgi için Google Cloud MCP sunucularına genel bakış başlıklı makaleyi inceleyin.

Bu, Maps Grounding Lite API'si 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ı oluşturmak için kullandığı MCP sunucusunun ağ adresi ve iletişim arayüzüdür (genellikle bir URL). LLM'nin bağlam istemek, bir aracı çağırmak veya bir kaynağa erişmek için kullandığı iletişim noktasıdır. Google MCP uç noktaları küresel veya bölgesel olabilir.

mapstools.googleapis.com MCP sunucusunda aşağıdaki MCP uç noktası bulunur:

https://mapstools.googleapis.com/mcp

MCP Araçları

MCP aracı, bir MCP sunucusunun gerçek dünyada işlem yapmak için bir 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ı

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): `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. `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). `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. `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.
lookup_weather	Mevcut koşullar, saatlik ve günlük tahminler dahil olmak üzere kapsamlı hava durumu verilerini alır. 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. Konum ve Konum Kuralları (KRİTİK): Hava durumu verilerinin istendiği konum, "location" alanı kullanılarak belirtilir. Bu alan bir "oneof" yapısıdır. Bu nedenle, doğru hava durumu verisi araması için aşağıdaki üç konum alt alanından YALNIZCA BİRİNE değer sağlamanız GEREKİR. Coğrafi Koordinatlar (lat_lng) Tam enlem/boylam koordinatları verildiğinde kullanın. Örnek: `"lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // Los Angeles` Yer kimliği (place_id) Net bir dize tanımlayıcısı (Google Haritalar yer kimliği). place_id, search_places aracından alınabilir. Örnek: `"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // Eiffel Tower` Adres Dizesi (adres) Coğrafi kodlama için belirli bir biçimde olması gereken serbest biçimli bir dize. Şehir ve Bölge: Bölge/ülke her zaman dahil edilmelidir (ör. "Londra, Birleşik Krallık", "Londra" değil). Posta Adresi: Tam adresi girin (ör. "1600 Pennsylvania Ave NW, Washington, DC"). Posta kodları: Ülke adıyla birlikte verilmelidir (ör. "90210, ABD", "90210" DEĞİL). Kullanım Modları: Mevcut Hava Durumu: Yalnızca `location` bilgisini ver. `date` ve `hour` özelliklerini belirtmeyin. Saatlik Hava Durumu Tahmini: `location`, `date` ve `hour` (0-23) bilgilerini sağlayın. Belirli zamanlar (ör. "saat 17:00'da") veya "önümüzdeki birkaç saat" ya da "bugün ilerleyen saatlerde" gibi ifadeler için kullanılır. Kullanıcı dakika belirtirse en yakın saate yuvarlayın. 120 saatten sonraki saatlik hava durumu tahmini desteklenmez. Geçmiş saatlik hava durumu, 24 saate kadar desteklenir. Günlük Tahmin: `location` ve `date` bilgilerini ver. `hour` özelliğini belirtmeyin. Genel gün istekleri için kullanılır (ör. "yarının hava durumu", "cuma gününün hava durumu", "25.12'nin hava durumu"). Bugünün tarihi bağlamda yer almıyorsa kullanıcıya bu durumu açıklamanız gerekir. Bugün de dahil olmak üzere 10 günü aşan günlük tahmin desteklenmez. Geçmiş hava durumu desteklenmez. Parametre Kısıtlamaları: Saat dilimleri: Tüm `date` ve `hour` girişleri, kullanıcının saat dilimine göre değil, konumun yerel saat dilimine göre olmalıdır. Tarih Biçimi: Girişler `{year, month, day}` tam sayıya ayrılmalıdır. Birimler: Varsayılan olarak `METRIC` değerine ayarlanır. Kullanıcı ABD standartlarını ima ediyorsa veya açıkça talep ediyorsa Fahrenheit/Mil için `units_system` değerini `IMPERIAL` olarak ayarlayın.
compute_routes	Belirtilen bir başlangıç ve 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, ilgili alanın içine yerleştirilmiş olarak aşağıdaki yöntemlerden biri kullanılarak sağlanmalıdır: address: (dize, örneğin "Eyfel Kulesi, Paris"). Not: Giriş adresi ne kadar ayrıntılı veya belirli olursa sonuçlar 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. adrese göre kaynak, lat_lng'ye göre 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"}

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):

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.
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).
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.
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.

lookup_weather

Mevcut koşullar, saatlik ve günlük tahminler dahil olmak üzere kapsamlı hava durumu verilerini alır.

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.

Konum ve Konum Kuralları (KRİTİK):

Hava durumu verilerinin istendiği konum, "location" alanı kullanılarak belirtilir. Bu alan bir "oneof" yapısıdır. Bu nedenle, doğru hava durumu verisi araması için aşağıdaki üç konum alt alanından YALNIZCA BİRİNE değer sağlamanız GEREKİR.

Coğrafi Koordinatlar (lat_lng)
- Tam enlem/boylam koordinatları verildiğinde kullanın.
- Örnek: "lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // Los Angeles
Yer kimliği (place_id)
- Net bir dize tanımlayıcısı (Google Haritalar yer kimliği).
- place_id, search_places aracından alınabilir.
- Örnek: "place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // Eiffel Tower
Adres Dizesi (adres)
- Coğrafi kodlama için belirli bir biçimde olması gereken serbest biçimli bir dize.
- Şehir ve Bölge: Bölge/ülke her zaman dahil edilmelidir (ör. "Londra, Birleşik Krallık", "Londra" değil).
- Posta Adresi: Tam adresi girin (ör. "1600 Pennsylvania Ave NW, Washington, DC").
- Posta kodları: Ülke adıyla birlikte verilmelidir (ör. "90210, ABD", "90210" DEĞİL).

Kullanım Modları:

Mevcut Hava Durumu: Yalnızca location bilgisini ver. date ve hour özelliklerini belirtmeyin.
Saatlik Hava Durumu Tahmini: location, date ve hour (0-23) bilgilerini sağlayın. Belirli zamanlar (ör. "saat 17:00'da") veya "önümüzdeki birkaç saat" ya da "bugün ilerleyen saatlerde" gibi ifadeler için kullanılır. Kullanıcı dakika belirtirse en yakın saate yuvarlayın. 120 saatten sonraki saatlik hava durumu tahmini desteklenmez. Geçmiş saatlik hava durumu, 24 saate kadar desteklenir.
Günlük Tahmin: location ve date bilgilerini ver. hour özelliğini belirtmeyin. Genel gün istekleri için kullanılır (ör. "yarının hava durumu", "cuma gününün hava durumu", "25.12'nin hava durumu"). Bugünün tarihi bağlamda yer almıyorsa kullanıcıya bu durumu açıklamanız gerekir. Bugün de dahil olmak üzere 10 günü aşan günlük tahmin desteklenmez. Geçmiş hava durumu desteklenmez.

Parametre Kısıtlamaları:

Saat dilimleri: Tüm date ve hour girişleri, kullanıcının saat dilimine göre değil, konumun yerel saat dilimine göre olmalıdır.
Tarih Biçimi: Girişler {year, month, day} tam sayıya ayrılmalıdır.
Birimler: Varsayılan olarak METRIC değerine ayarlanır. Kullanıcı ABD standartlarını ima ediyorsa veya açıkça talep ediyorsa Fahrenheit/Mil için units_system değerini IMPERIAL olarak ayarlayın.

compute_routes

Belirtilen bir başlangıç ve 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, ilgili alanın içine yerleştirilmiş olarak aşağıdaki yöntemlerden biri kullanılarak sağlanmalıdır:

address: (dize, örneğin "Eyfel Kulesi, Paris"). Not: Giriş adresi ne kadar ayrıntılı veya belirli olursa sonuçlar 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. adrese göre kaynak, lat_lng'ye göre 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"}

MCP aracı özelliklerini alma

Bir MCP sunucusundaki tüm araçlar için MCP aracı özelliklerini almak üzere 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 }'

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
}'

MCP Reference: mapstools.googleapis.com Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Sunucu Kurulumu

Sunucu uç noktaları

MCP Araçları

MCP aracı özelliklerini alma

MCP Reference: mapstools.googleapis.com