Bu sayfa, Cloud Translation API ile çevrilmiştir.

Grounding Lite

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 verisi özetlerinin yanı sıra özetin kapsamındaki her yer için yer kimlikleri, enlem ve boylam koordinatları ve Google Haritalar bağlantıları alın. Döndürülen yer kimliklerini ve enlem ile boylam koordinatlarını, yerleri haritada göstermek için diğer Google Maps Platform 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.

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 özgü ş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'ı, modele girilen verileri model eğitimi veya iyileştirme için 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ğin hemen ardından gelmelidir. 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ıtla birlikte sağlanan googleMapsLinks içindeki Open Graph meta verilerinden og:title kaynak sayfa başlığını göster.
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 etkinleştirildiği bir API anahtarına ihtiyacınız vardır. Ardından, LLM'leri MCP sunucusuna erişecek şekilde yapılandırabilirsiniz. Grounding Lite MCP sunucusu, Streamable HTTP aktarımını kullanır.

API anahtarı oluşturma veya yapılandırma

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. Maps Grounding Lite API, deneysel dönemde ücret almaz ancak projede faturalandırma etkinleştirilmelidir.

API'yi etkinleştirmek için:

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

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

API anahtarı oluşturmak veya yapılandırmak için Google Haritalar Platformu'nu kullanmaya başlama bölümündeki adımları uygulayın.

API anahtarı, X-Goog-Api-Key üstbilgisi kullanılarak MCP sunucusuna iletilmelidir. Bunu, LLM'nin MCP aracı yapılandırmasında özel bir HTTP başlığı olarak belirtmeniz gerekir.

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

Maps Grounding Lite API hizmetinin etkin olduğu bir API anahtarına sahip olduğunuzda, ilgili MCP yapılandırma belgelerini izleyerek ve Grounding Lite MCP sunucu URL'sini kullanarak LLM'leri MCP sunucusuna erişecek şekilde yapılandırabilirsiniz: https://mapstools.googleapis.com/mcp

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

Bu bölümde, Gemini KSA'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.

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.

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

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.

Geri bildirim paylaşma

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