Grounding Lite

Deneysel: Grounding Lite, deneysel (genel kullanıma sunulmadan önceki) aşamadadır. GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST öncesi Teklifler, Google Haritalar Platformu Hizmetine Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin. Grounding Lite deneysel aşamadayken kullanımı ücretsizdir.

Google Haritalar Platformu Grounding Lite, Model Context Protocol (MCP) desteği sunan bir hizmettir. Bu hizmet, Google Haritalar'daki güvenilir coğrafi verilerle yapay zeka uygulamalarınızı temellendirmenizi kolaylaştırır. MCP sunucusu, LLM'lerin yerler, hava durumu ve rotalarla ilgili özelliklere erişmesine olanak tanıyan araçlar sağlar. MCP sunucularını destekleyen herhangi bir araçta etkinleştirerek Grounding Lite'ı deneyebilirsiniz.

Araçlar

Grounding Lite, LLM'lerin aşağıdaki Google Haritalar özelliklerine erişmesine olanak tanıyan araçlar sağlar:

• Yerleri arama: Yerlerle ilgili bilgi isteyin ve yapay zeka tarafından oluşturulan yer verileri özetlerinin yanı sıra özetin kapsamındaki her yer için yer kimlikleri, enlem ve boylam koordinatları ile Google Haritalar bağlantılarını alın. Yerleri haritada göstermek için döndürülen yer kimliklerini ve enlem ile boylam koordinatlarını diğer Google Haritalar Platformu API'leriyle birlikte kullanabilirsiniz.
• Hava durumunu arama: Hava durumu hakkında bilgi isteyin ve mevcut koşulları, saatlik tahminleri ve günlük tahminleri döndürün.

• Rotaları hesaplama: İki konum arasındaki araba veya yaya rotaları hakkında bilgi isteyin ve rota mesafesi ile süresi bilgilerini döndürün.

  Not: Grounding Lite; adım adım rota, yol tarifi, anlık trafik veya navigasyon bilgisi sağlamaz
  .

Maps Grounding Lite MCP sunucusunun etkinleştirilmesi, LLM'lerin yukarıda listelenen veri türleri için ek temellendirme bilgileri döndürmek üzere sunucu tarafından kullanıma sunulan yeni araçları çağırmasına olanak tanır. LLM bu ek bilgileri bağlam için kullanabilse de LLM'nin nihai olarak oluşturduğu yanıt, MCP sunucusu tarafından döndürülen bilgilerin aynısını içermeyebilir. Oluşturulan yanıtın doğruluğunu doğrulamanız gerekir.

Grounding Lite örnek uygulamasını deneyin (Yeni sekmede açılır).

Faturalandırma ve kotalar

Grounding Lite deneysel aşamadayken kullanımı ücretsizdir. Ancak, Grounding Lite tarafından sağlanan araçlar için aşağıdaki kotalar geçerlidir:

• Yer arama: Proje başına dakikada 100 sorgu. Proje başına günlük 1.000 sorgu.
• Hava durumunu arama: Proje başına dakikada 300 sorgu.
• Compute rotaları: Proje başına dakikada 300 sorgu.

Politikalar ve hizmet şartları

Grounding Lite, bu hizmete ilişkin hizmete özel şartlar da dahil olmak üzere Google Haritalar Platformu Hizmet Şartları'na tabidir. Bu bölümde, uyumlu LLM'ler ve kaynak ilişkilendirme şartları da dahil olmak üzere Grounding Lite için ek hizmet kullanımı şartları açıklanmaktadır.

Uyumlu LLM'lerle ilgili koşullar

Grounding Lite'ı yalnızca Google Haritalar Platformu Hizmet Şartları'na uygun bir LLM ile kullanabilirsiniz.

Örneğin, Google Haritalar İçeriği'nin, kullanmayı seçtiğiniz LLM tarafından önbelleğe alınmamasını, depolanmamasını veya bu LLM'yi iyileştirmek için kullanılmamasını sağlamak sizin sorumluluğunuzdadır. Grounding Lite'ı kullanmadan önce, Grounding Lite ile kullanmayı planladığınız tüm modellerin Hizmet Şartları'nı incelemeniz gerekir. Grounding Lite'ı, model eğitimi veya iyileştirme için modele girilen verileri kullanan modellerle birlikte kullanmamalısınız. Modeli kullanımınızın, hizmete özgü şartlar da dahil olmak üzere Google Haritalar Platformu Hizmet Şartları'ndaki Google Haritalar İçeriği ile ilgili kısıtlamalara tamamen uygun olmasını sağlamak sizin sorumluluğunuzdadır.

Google Haritalar kaynakları için atıf şartları

Grounding Lite'ın her araç yanıtında kaynaklar yer alır. Grounding Lite tarafından sağlanan araçları kullanan sonuçlar sunarken, ilişkili Google Haritalar kaynaklarını aşağıdaki koşulları karşılayacak şekilde eklemeniz gerekir:

• Google Haritalar kaynakları, kaynakların desteklediği oluşturulmuş içeriği hemen takip etmelidir. Bu üretilmiş içerik, Temellendirilmiş Çıkış olarak da adlandırılır.
• Google Haritalar kaynakları, tek bir kullanıcı etkileşimi içinde görüntülenebilmelidir.

Yer arama aracı için kaynaklar

search_places aracı places alanı, summary destekleyen kaynaklar sağlar. places için aşağıdaki meta veriler döndürülür:

• place (kaynak adı)
• id
• location
• googleMapsLinks

Her yer için aşağıdaki koşulları karşılayan bir bağlantı önizlemesi oluşturmanız gerekir:

• Grounding Lite metin ilişkilendirme yönergelerini uygulayarak her kaynağı Google Haritalar ile ilişkilendirin.
• Yanıtın places.googleMapsLinks.placeUrl simgesini kullanarak kaynağa bağlantı verin.

LLM'leri MCP sunucusunu kullanacak şekilde yapılandırma

Grounding Lite'ı kullanmak için öncelikle Maps Grounding Lite API hizmetinin etkin olduğu bir Google Cloud projenizin yanı sıra bir API anahtarı veya OAuth istemci kimliğinizin olması gerekir. Ardından, LLM'leri MCP sunucusuna erişecek şekilde yapılandırabilirsiniz. Grounding Lite MCP sunucusu, Streamable HTTP aktarımını kullanır.

Google Cloud projenizde Maps Grounding Lite hizmetini etkinleştirin.

Projenizde API'yi etkinleştirmek için:

1. Google Cloud Console'da, Grounding Lite için kullanmak istediğiniz projeyi seçin.
2. Google Cloud Console'da proje için faturalandırmayı etkinleştirin.
3. Üst gezinme çubuğundan Cloud Shell terminalini açın.

4. Hizmeti ve MCP uç noktasını etkinleştirmek için aşağıdaki komutları çalıştırın:

   gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
   gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID
   

Not: Maps Grounding Lite API, deneysel kullanım sırasında ücret almaz ancak projede faturalandırma etkinleştirilmelidir.

API anahtarı kullanarak kimlik doğrulama

Google Cloud projesinde ve anahtarda Maps Grounding Lite API hizmetini etkinleştirdiğiniz sürece Maps Grounding Lite ile mevcut bir API anahtarını kullanabilir veya yeni bir anahtar oluşturabilirsiniz.

API anahtarı kullanarak kimlik doğrulamak için:

1. Google Maps Platform'u kullanmaya başlama bölümündeki adımları uygulayarak bir API anahtarı oluşturun veya yapılandırın.
2. X-Goog-Api-Key üstbilgisini kullanarak anahtarı MCP sunucusuna iletin. Bunu, LLM'nin MCP aracı yapılandırmasında özel bir HTTP üst bilgisi olarak belirtmeniz gerekir.

Not: API anahtarı oluştururken veya yapılandırırken uygun kısıtlamaları uygulayarak anahtarın kullanımını sınırladığınızdan emin olun. Daha fazla bilgi için API anahtarlarınızı kısıtlama başlıklı makaleyi inceleyin.

OAuth kullanarak kimlik doğrulaması yapma

OAuth kimlik bilgileri oluşturup bunları MCP ana makinesine veya MCP sunucu uygulamasına ileterek OAuth kullanarak kimlik doğrulaması yapabilirsiniz.

OAuth kullanarak kimlik doğrulaması yapmak için:

1. Google Cloud Console'da, Grounding Lite için kullanmak istediğiniz projeyi seçin.
2. API ve Hizmetler menüsünde Kimlik Bilgileri'ni seçin.
3. Üst menüde Kimlik bilgileri oluştur > OAuth istemci kimliği'ni seçin.
4. Projenin yapılandırılmış bir izin ekranı yoksa İzin ekranını yapılandır'ı tıklayın ve ekrandaki talimatları uygulayın.
5. Metrikler bölümünde OAuth istemcisi oluştur'u tıklayın.
6. OAuth istemci kimliği oluşturun ekranında bir uygulama türü seçin ve istemci kimliği için bir ad girin.
7. Uygulama türünüzle ilgili ek ayrıntıları belirtin. Örneğin, bir web uygulaması oluşturuyorsanız tarayıcı ve sunucu istekleri için yetkili URI'ler ekleyin.
8. İstemciniz oluşturulduktan sonra istemci kimliğini ve gizli anahtarını kaydedin.
9. MCP ana makinenizi veya MCP sunucu uygulamanızı GroundingLite'a erişecek şekilde yapılandırırken OAuth istemci kimliğinizi ve gizli anahtarınızı iletin.

Daha fazla bilgi için Google API'lerine Erişmek için OAuth 2.0'ı Kullanma başlıklı makaleyi inceleyin.

LLM'leri Grounding Lite MCP sunucusuna erişecek şekilde yapılandırma

Maps Grounding Lite API hizmetinin etkinleştirildiği bir Google Cloud projeniz ve API anahtarı veya OAuth istemci kimliği ve gizli anahtarı gibi geçerli kimlik bilgileriniz olduğunda, ilgili MCP yapılandırma belgelerini inceleyerek ve Grounding Lite MCP sunucu URL'sini kullanarak LLM'leri MCP sunucusuna erişecek şekilde yapılandırabilirsiniz: https://mapstools.googleapis.com/mcp

Daha fazla bilgi için Yapay zeka uygulamasında MCP'yi yapılandırma başlıklı makaleyi inceleyin.

Gemini CLI ile Grounding Lite'ı yapılandırma

Bu bölümde, Gemini CLI'yı kullanarak Grounding Lite MCP sunucusunun nasıl yapılandırılacağına dair bir örnek verilmektedir. Daha fazla bilgi için Gemini CLI ile MCP sunucuları başlıklı makaleyi inceleyin.

1. Gemini CLI'yı yükledikten sonra, Maps Grounding Lite MCP sunucusunu yapılandırmak için add komutunu kullanabilirsiniz:

   gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp
   

   Yapılandırma başarılı olduysa sunucunun kullanıcı ayarlarınıza eklendiğini onaylayan bir mesaj görürsünüz.

2. Sunucunun doğru şekilde çalıştığını doğrulamak için /mcp list komutunu çalıştırın:

   > /mcp list
   
   Configured MCP servers:
   
   maps-grounding-lite-mcp - Ready (3 tools)
   Tools:
   -   compute_routes
   -   lookup_weather
   -   search_places
   

3. KSA ile Haritalar ile ilgili sorular sormaya başlayın. Örneğin, "Mountain View'da restoran öner" istemini deneyin. Bu istem, sizin adınıza search_places aracını çağırır.

Not: OAuth kullanarak Grounding Lite'a erişmek için Gemini CLI uzantısını yapılandırma hakkında bilgi edinmek istiyorsanız Google Cloud belgelerindeki MCP'de Gemini CLI bölümüne bakın

Geri bildirim paylaşma

Grounding Lite hakkında geri bildirim paylaşmak için aşağıdaki formları kullanın:

• Hata bildirme
• Özellik isteği gönderme
• Geri bildirim gönderin