Grounding Lite

Eksperymentalna: Grounding Lite jest w fazie eksperymentalnej (przed udostępnieniem ogólnym). Usługi i funkcje przed GA mogą mieć ograniczoną obsługę, a zmiany w takich usługach i funkcjach mogą być niezgodne z ich innymi wersjami. Oferty przed GA są objęte szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania. Korzystanie z Grounding Lite w wersji eksperymentalnej jest bezpłatne.

Google Maps Platform Grounding Lite to usługa z obsługą protokołu Model Context Protocol (MCP), która ułatwia oparcie aplikacji AI na wiarygodnych danych geoprzestrzennych z Map Google. Serwer MCP udostępnia narzędzia, które umożliwiają LLM dostęp do funkcji związanych z miejscami, pogodą i trasami. Możesz wypróbować Grounding Lite, włączając tę funkcję w dowolnym narzędziu obsługującym serwery MCP.

Narzędzia

Grounding Lite udostępnia narzędzia, które umożliwiają LLM dostęp do tych funkcji Map Google:

• Wyszukiwanie miejsc: prośba o informacje o miejscach i uzyskiwanie wygenerowanych przez AI podsumowań danych o miejscach, a także identyfikatorów miejsc, współrzędnych geograficznych oraz linków do Map Google dla każdego miejsca uwzględnionego w podsumowaniu. Zwrócone identyfikatory miejsc oraz współrzędne geograficzne możesz wykorzystać w innych interfejsach API Google Maps Platform, aby wyświetlać miejsca na mapie.
• Sprawdzanie pogody: wysyłanie prośby o informacje o pogodzie i zwracanie aktualnych warunków, prognoz godzinowych i prognoz dziennych.

• Obliczanie tras: wysyłanie prośby o informacje o trasach samochodowych lub pieszych między 2 lokalizacjami i zwracanie informacji o odległości i czasie trwania trasy.

  Uwaga: Grounding Lite nie zawiera szczegółowych wskazówek dojazdu, informacji o ruchu drogowym w czasie rzeczywistym ani informacji nawigacyjnych.

Włączenie serwera MCP Maps Grounding Lite umożliwia dużym modelom językowym wywoływanie nowych narzędzi udostępnianych przez serwer w celu zwracania dodatkowych informacji o podstawach dla wymienionych powyżej typów danych. Chociaż LLM może używać tych dodatkowych informacji jako kontekstu, wygenerowana przez niego odpowiedź może nie zawierać dokładnych informacji zwróconych przez serwer MCP. Sprawdź poprawność wygenerowanej odpowiedzi.

Wypróbuj przykładową aplikację Grounding Lite (otwiera się w nowej karcie)

Rozliczenia i limity

Korzystanie z Grounding Lite w fazie eksperymentalnej jest bezpłatne. Jednak w przypadku narzędzi udostępnianych przez Grounding Lite obowiązują te limity:

• Wyszukiwanie miejsc: 100 zapytań na minutę na projekt. 1000 zapytań dziennie na projekt.
• Sprawdzanie pogody: 300 zapytań na minutę na projekt.
• Obliczanie tras: 300 zapytań na minutę na projekt.

Zasady i warunki korzystania z usługi

Usługa Grounding Lite podlega Warunkom korzystania z usługi Google Maps Platform, w tym szczegółowym warunkom korzystania z tej usługi. Ta sekcja zawiera opis dodatkowych wymagań dotyczących korzystania z usługi Grounding Lite, w tym zgodnych dużych modeli językowych i wymagań dotyczących atrybucji źródła.

Wymagania dotyczące zgodnych dużych modeli językowych

Usługi Grounding Lite możesz używać tylko z LLM, który jest zgodny z Warunkami korzystania z usługi Google Maps Platform.

Na przykład ponosisz odpowiedzialność za to, aby treści z Map Google nie były buforowane, przechowywane ani wykorzystywane do ulepszania wybranego przez Ciebie dużego modelu językowego. Zanim zaczniesz korzystać z Grounding Lite, musisz zapoznać się z Warunkami korzystania z usługi dotyczącymi każdego modelu, którego zamierzasz używać z Grounding Lite. Nie możesz używać Grounding Lite z modelami, które wykorzystują dane wejściowe do trenowania lub ulepszania modeli. Ponosisz odpowiedzialność za zapewnienie, że korzystanie z modelu jest w pełni zgodne z ograniczeniami dotyczącymi treści w Mapach Google określonymi w Warunkach korzystania z usługi Google Maps Platform, w tym z warunkami korzystania z konkretnych usług.

Wymagania dotyczące atrybucji w przypadku źródeł Map Google

Każda odpowiedź narzędzia w wersji Grounding Lite zawiera źródła. Podczas prezentowania wyników korzystających z narzędzi udostępnianych przez Grounding Lite musisz uwzględnić powiązane źródła Map Google w sposób spełniający te wymagania:

• Źródła Map Google muszą znajdować się bezpośrednio po wygenerowanych treściach, które obsługują. Wygenerowane treści są też nazywane odpowiedzią opartą na źródłach.
• Źródła w Mapach Google muszą być widoczne w ramach jednej interakcji użytkownika.

Źródła narzędzia Wyszukaj miejsca

Pole search_places narzędzia places zawiera źródła potwierdzające summary. W przypadku places zwracane są te metadane:

• place (nazwa zasobu)
• id
• location
• googleMapsLinks

W przypadku każdego miejsca musisz wygenerować podgląd linku, który spełnia te wymagania:

• Przypisz każde źródło do Map Google, postępując zgodnie z wskazówkami dotyczącymi przypisywania atrybucji do tekstu Grounding Lite.
• Połącz się ze źródłem za pomocą parametru places.googleMapsLinks.placeUrl z odpowiedzi.

Konfigurowanie dużych modeli językowych do korzystania z serwera MCP

Aby korzystać z interfejsu Grounding Lite, musisz najpierw mieć projekt Google Cloud z włączoną usługą interfejsu API Maps Grounding Lite oraz klucz interfejsu API lub identyfikator klienta OAuth. Następnie możesz skonfigurować duże modele językowe, aby miały dostęp do serwera MCP. Serwer Grounding Lite MCP korzysta z transportu HTTP z możliwością przesyłania strumieniowego.

Włącz usługę Maps Grounding Lite w projekcie Google Cloud.

Uwaga: po 17 marca 2026 r. zdalny serwer MCP usługi Maps Grounding Lite jest automatycznie włączany, gdy włączysz usługę Maps Grounding Lite.

Aby włączyć interfejs API w projekcie:

1. W konsoli Google Cloud wybierz projekt, którego chcesz użyć w przypadku Grounding Lite.
2. Włącz rozliczenia w projekcie w konsoli Google Cloud.
3. Włącz Grounding Lite w Bibliotece API konsoli Google Cloud.

Uwaga: interfejs Maps Grounding Lite API nie pobiera opłat w okresie eksperymentalnym, ale w projekcie musi być włączone rozliczanie.

Uwierzytelnianie za pomocą klucza interfejsu API

Możesz użyć istniejącego klucza interfejsu API z interfejsem Maps Grounding Lite lub utworzyć nowy, o ile włączysz usługę interfejsu API Maps Grounding Lite w projekcie Google Cloud i na kluczu.

Aby przeprowadzić uwierzytelnianie za pomocą klucza interfejsu API:

1. Utwórz lub skonfiguruj klucz interfejsu API, wykonując czynności opisane w artykule Wprowadzenie do Google Maps Platform.
2. Przekaż klucz do serwera MCP za pomocą nagłówka X-Goog-Api-Key. Musisz określić go jako niestandardowy nagłówek HTTP w konfiguracji narzędzia MCP LLM.

Uwaga: podczas tworzenia lub konfigurowania klucza interfejsu API pamiętaj, aby ograniczyć jego użycie, stosując odpowiednie ograniczenia. Więcej informacji znajdziesz w artykule Ograniczanie kluczy interfejsu API.

Uwierzytelnianie przy użyciu OAuth

Do uwierzytelniania możesz używać protokołu OAuth, tworząc dane uwierzytelniające OAuth i przekazując je do hosta MCP lub aplikacji serwera MCP.

Aby uwierzytelnić się za pomocą protokołu OAuth:

1. W konsoli Google Cloud wybierz projekt, którego chcesz użyć w przypadku Grounding Lite.
2. W menu Interfejsy API i usługi wybierz Dane logowania.
3. W menu u góry kliknij Utwórz dane logowania > Identyfikator klienta OAuth.
4. Jeśli projekt nie ma skonfigurowanego ekranu zgody, kliknij Skonfiguruj ekran zgody i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.
5. W sekcji Dane kliknij Utwórz klienta OAuth.
6. Na ekranie Tworzenie identyfikatora klienta OAuth wybierz typ aplikacji i wpisz nazwę identyfikatora klienta.
7. Podaj dodatkowe informacje, które są istotne w przypadku Twojego typu zgłoszenia. Jeśli na przykład tworzysz aplikację internetową, dodaj autoryzowane identyfikatory URI dla żądań przeglądarki i serwera.
8. Po utworzeniu klienta zapisz jego identyfikator i klucz tajny.
9. Podczas konfigurowania hosta MCP lub aplikacji serwera MCP w celu uzyskania dostępu do Grounding Lite przekaż identyfikator klienta OAuth i tajny klucz.

Więcej informacji znajdziesz w artykule o używaniu OAuth 2.0 do korzystania z interfejsów API Google.

Konfigurowanie dużych modeli językowych w celu uzyskania dostępu do serwera MCP Grounding Lite

Gdy masz już projekt Google Cloud z włączoną usługą Maps Grounding Lite API i prawidłowe dane logowania, takie jak klucz interfejsu API lub identyfikator klienta OAuth i klucz tajny, możesz skonfigurować duże modele językowe, aby uzyskiwać dostęp do serwera MCP. W tym celu postępuj zgodnie z odpowiednią dokumentacją konfiguracji MCP i użyj adresu URL serwera Grounding Lite MCP:https://mapstools.googleapis.com/mcp

Więcej informacji znajdziesz w artykule Konfigurowanie MCP w aplikacji AI.

Konfigurowanie Grounding Lite za pomocą interfejsu wiersza poleceń Gemini

W tej sekcji znajdziesz przykład konfigurowania serwera Grounding Lite MCP za pomocą interfejsu wiersza poleceń Gemini. Więcej informacji znajdziesz w artykule Serwery MCP z interfejsem wiersza poleceń Gemini.

1. Po zainstalowaniu interfejsu wiersza poleceń Gemini możesz użyć polecenia add, aby skonfigurować serwer MCP Maps Grounding Lite:

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

   Jeśli konfiguracja się powiodła, zobaczysz potwierdzenie, że serwer został dodany do ustawień użytkownika.

2. Aby sprawdzić, czy serwer działa prawidłowo, uruchom to polecenie:/mcp list

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

3. Zacznij zadawać pytania dotyczące Map za pomocą interfejsu wiersza poleceń. Na przykład spróbuj wpisać „Poleć mi restauracje w Warszawie”, co powinno spowodować wywołanie narzędzia search_places w Twoim imieniu.

Uwaga: informacje o konfigurowaniu rozszerzenia interfejsu Gemini CLI w celu uzyskiwania dostępu do Grounding Lite za pomocą OAuth znajdziesz w sekcji Gemini CLI w dokumentacji MCP w Google Cloud.

Przesyłanie opinii

Aby przesłać opinię o usłudze Grounding Lite, skorzystaj z tych formularzy:

• Zgłoś błąd
• Przesyłanie prośby o dodanie funkcji
• Przesyłanie opinii