Grounding Lite

Google Maps Platform Grounding Lite to usługa z obsługą protokołu kontekstu modelu (MCP), która ułatwia grounding aplikacji AI za pomocą wiarygodnych danych geoprzestrzennych z Map Google. Serwer MCP udostępnia narzędzia, które umożliwiają dużym modelom językowym 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: możesz prosić o informacje o miejscach i otrzymywać wygenerowane przez AI podsumowania danych o miejscach, a także identyfikatory miejsc, współrzędne geograficzne i linki do Map Google dla każdego miejsca uwzględnionego w podsumowaniu. Zwrócone identyfikatory miejsc oraz współrzędne szerokości i długości geograficznej możesz wykorzystać w innych interfejsach API Google Maps Platform, aby wyświetlać miejsca na mapie.
  • Sprawdzanie pogody: prośba o informacje o pogodzie i zwracanie aktualnych warunków, prognoz godzinowych i prognoz dziennych.

  • Obliczanie tras: żądanie informacji o trasach przejazdu lub przejścia między 2 lokalizacjami i zwracanie informacji o długości i czasie trwania trasy.

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ź dokładność wygenerowanej odpowiedzi.

Rozliczenia i limity

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

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

Zasady i warunki korzystania z usługi

Usługa Grounding Lite podlega Warunkom korzystania z 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

Z funkcji Grounding Lite możesz korzystać tylko w przypadku dużego modelu językowego, 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 modelu. 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ł z Map Google

Każda odpowiedź narzędzia w przypadku Grounding Lite zawiera źródła. Podczas prezentowania wyników wykorzystujących narzędzia udostępniane 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 wynikami opartymi na faktach.
  • Źródła Map 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:

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

Aby korzystać z Grounding Lite, musisz najpierw mieć klucz interfejsu API z włączoną usługą Maps Grounding Lite. Następnie możesz skonfigurować dostęp dużych modeli językowych do serwera MCP. Serwer Grounding Lite MCP korzysta z transportu HTTP z możliwością przesyłania strumieniowego.

Tworzenie lub konfigurowanie klucza interfejsu API

Możesz użyć istniejącego klucza interfejsu API z interfejsem Maps Grounding Lite lub utworzyć nowy, o ile włączysz w nim usługę interfejsu API Maps Grounding Lite. Interfejs Maps Grounding Lite API nie pobiera opłat w okresie eksperymentalnym, ale w projekcie musi być włączone rozliczanie.

Aby włączyć interfejs API:

  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 górnym pasku nawigacyjnym otwórz terminal Cloud Shell.

  4. Aby włączyć usługę i punkt końcowy MCP, uruchom te polecenia:

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

  5. Aby utworzyć lub skonfigurować klucz interfejsu API, wykonaj czynności opisane w sekcji Wprowadzenie do Google Maps Platform.

Klucz interfejsu API należy przekazać na serwer MCP za pomocą nagłówka X-Goog-Api-Key. Musisz określić go jako niestandardowy nagłówek HTTP w konfiguracji narzędzia MCP modelu LLM.

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

Gdy uzyskasz klucz API z włączoną usługą Maps Grounding Lite API, 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

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 sekcji Serwery MCP z interfejsem wiersza poleceń Gemini.

  1. Po zainstalowaniu 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 Mountain View”, co powinno spowodować wywołanie narzędzia search_places w Twoim imieniu.

Przesyłanie opinii

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