Grounding Lite

Google Maps Platform Grounding Lite to usługa obsługująca protokół Model Context Protocol (MCP), która ułatwia osadzanie aplikacji AI w zaufanych danych geoprzestrzennych z Map Google. Serwer MCP udostępnia narzędzia, które umożliwiają LLM dostęp do funkcji dotyczących miejsc, pogody i tras. Możesz wypróbować Grounding Lite, włączając ją 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: żądanie informacji 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**: żądanie informacji o pogodzie i zwracanie aktualnych warunków, prognoz godzinowych i prognoz dziennych.
Obliczanie tras: żądanie informacji o trasach samochodowych lub pieszych między 2 lokalizacjami i zwracanie informacji o odległości i czasie trwania trasy.

Uwaga: Grounding Lite nie udostępnia informacji o trasach krok po kroku, wskazówek dojazdu, informacji o ruchu drogowym w czasie rzeczywistym ani informacji o nawigacji

Włączenie serwera MCP Grounding Lite w Mapach Google umożliwia LLM wywoływanie nowych narzędzi udostępnianych przez serwer w celu zwracania dodatkowych informacji o osadzaniu w przypadku wymienionych powyżej typów danych. Chociaż LLM może używać tych dodatkowych informacji w kontekście, odpowiedź generowana przez LLM może nie zawierać dokładnych informacji zwróconych przez serwer MCP. Należy sprawdzić dokładność wygenerowanej odpowiedzi.

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

Płatności i limity

Potencjalne ceny

Korzystanie z Grounding Lite w fazie eksperymentalnej jest bezpłatne.

W tabelach poniżej znajdziesz potencjalny cennik Grounding Lite w Mapach Google, jeśli usługa ta zostanie udostępniona ogólnie. Więcej informacji znajdziesz w opisach etapu uruchamiania.

Grounding Lite może być też oferowana w ramach pakietów Essentials i Pro Subscribe to save.

Koszty podane za 1000 zdarzeń. Wszystkie ceny podano w USD. Zakresy dotyczą liczby zdarzeń miesięcznie.

Kategoria	Nazwa SKU	Limit bezpłatnego wykorzystania	Limit – 100 tys.	100 001–500 000	500 001–1 000 000	1 000 001–5 000 000	Ponad 5 000 000
Essentials	Grounding Lite	10 000	7,00 USD	5,95 USD	4,90 USD	3,85 USD	2,80 USD

Kategoria	Nazwa SKU	Limit bezpłatnego wykorzystania	Limit – 5 000 000	Ponad 5 000 000
Essentials	Grounding Lite (Indie)	70 000	3,85 USD	2,80 USD

Limity

Narzędzia udostępniane przez Grounding Lite są objęte tymi limitami:

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

Grounding Lite podlega Warunkom korzystania z usługi Google Maps Platform, w tym dodatkowym warunkom korzystania z tej usługi. W tej sekcji opisujemy wymagania dotyczące korzystania z usługi dodatkowej Grounding Lite, w tym wymagania dotyczące zgodnych LLM i wymagania dotyczące podania źródła.

Wymagania dotyczące zgodnych LLM

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

Odpowiadasz na przykład za to, aby treści z Map Google nie były buforowane, przechowywane ani używane do ulepszania wybranej przez Ciebie LLM. 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 żadnymi modelami, które wykorzystują dane wprowadzane do modelu do trenowania lub ulepszania modelu. Odpowiadasz za to, aby korzystanie z modelu było w pełni zgodne z ograniczeniami dotyczącymi treści z Map Google określonymi w Warunkach korzystania z usługi Google Maps Platform, w tym w dodatkowych warunkach korzystania z usługi.

Wymagania dotyczące podania źródła dla źródeł z Map Google

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

Źródła z Map Google muszą znajdować się bezpośrednio po wygenerowanej treści, którą obsługują. Ta wygenerowana treść jest też nazywana osadzoną treścią wyjściową.
Źródła z Map Google muszą być widoczne w ramach jednej interakcji użytkownika.

Źródła narzędzia do wyszukiwania miejsc

Pole places narzędzia search_places zawiera źródła, które obsługują 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 wytycznymi dotyczącymi atrybucji tekstowej Grounding Lite.
Połącz się ze źródłem za pomocą places.googleMapsLinks.placeUrl z odpowiedzi.

Konfigurowanie LLM do korzystania z serwera MCP

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

Włączanie usługi Maps Grounding Lite w projekcie Google Cloud

Aby włączyć interfejs API w projekcie:

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

Uwierzytelnianie za pomocą klucza interfejsu API

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

Aby uwierzytelnić się za pomocą klucza interfejsu API:

Utwórz lub skonfiguruj klucz interfejsu API, wykonując czynności opisane w artykule Pierwsze kroki z Google Maps Platform.
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.

Uwierzytelnianie przy użyciu OAuth

Możesz uwierzytelnić się przy użyciu OAuth, tworząc dane logowania OAuth i przekazując je do hosta MCP lub aplikacji serwera MCP.

Aby uwierzytelnić się przy użyciu OAuth:

W konsoli Google Cloud, wybierz projekt, którego chcesz używać w Grounding Lite.
W menu Interfejsy API i usługi kliknij Dane logowania.
W menu u góry kliknij Utwórz dane logowania > Identyfikator klienta OAuth.
Jeśli projekt nie ma skonfigurowanego ekranu zgody, kliknij Skonfiguruj ekran zgody i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.
W sekcji Dane kliknij Utwórz klienta OAuth.
Na ekranie Utwórz identyfikator klienta OAuth wybierz typ aplikacji i wpisz nazwę identyfikatora klienta.
Określ dodatkowe szczegóły, które są istotne dla typu aplikacji. Jeśli na przykład tworzysz aplikację internetową, dodaj autoryzowane identyfikatory URI na potrzeby żądań przeglądarki i serwera.
Po utworzeniu klienta zapisz identyfikator klienta i tajny klucz.
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 Używanie OAuth 2.0 do korzystania z interfejsów API Google.

Konfigurowanie LLM do uzyskiwania dostępu do serwera MCP Grounding Lite

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

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

Konfigurowanie Grounding Lite za pomocą interfejsu wiersza poleceń Gemini

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

Po zainstalowaniu interfejsu wiersza poleceń Gemini możesz użyć polecenia add, aby skonfigurować serwer MCP Grounding Lite w Mapach Google:
```
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ę uda, zobaczysz potwierdzenie, że serwer został dodany do ustawień użytkownika.

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

> /mcp list

Configured MCP servers:

maps-grounding-lite-mcp - Ready (3 tools)
Tools:
-   compute_routes
-   lookup_weather
-   search_places

Zacznij zadawać pytania dotyczące Map Google za pomocą interfejsu wiersza poleceń. Na przykład spróbuj wpisać „Poleć mi jakieś restauracje w Mountain View”. Powinno to spowodować wywołanie narzędzia search_places w Twoim imieniu.

Przesyłanie opinii

Aby przesłać opinię o Grounding Lite, użyj tych formularzy: