Эта страница переведена с помощью Cloud Translation API.

Заземление Lite

Экспериментальная версия: Grounding Lite находится на экспериментальной стадии (pre-GA). Продукты и функции на стадии pre-GA могут иметь ограниченную поддержку, а изменения в продуктах и функциях на стадии pre-GA могут быть несовместимы с другими версиями pre-GA. На предложения на стадии pre-GA распространяются Специальные условия использования сервиса платформы Google Карт . Подробнее см. в описаниях этапа запуска . Использование Grounding Lite на этапе экспериментальной версии бесплатно.

Grounding Lite платформы Google Карт — это сервис с поддержкой протокола контекста модели (MCP), который упрощает использование доверенных геопространственных данных Google Карт для ваших приложений ИИ. Сервер MCP предоставляет инструменты, позволяющие магистрам уровня владения языком (LLM) получать доступ к данным о местах, погоде и маршрутах. Вы можете попробовать Grounding Lite, включив его в любом инструменте, поддерживающем серверы MCP.

Инструменты

Grounding Lite предоставляет инструменты, позволяющие LLM получить доступ к следующим возможностям Google Maps:

Поиск мест : запрашивайте информацию о местах и получайте сводки данных, созданные искусственным интеллектом, а также идентификаторы мест, координаты широты и долготы и ссылки на Google Карты для каждого места, включённого в сводку. Вы можете использовать возвращаемые идентификаторы мест, координаты широты и долготы с другими API платформы Google Карт для отображения мест на карте.
Поиск погоды : запрос информации о погоде и возврат текущих условий, почасовых и ежедневных прогнозов.
Вычисление маршрутов : запрос информации о маршрутах для автомобиля или пешехода между двумя точками, а также информация о расстоянии и продолжительности обратного маршрута.
Примечание: Grounding Lite не предоставляет пошаговые инструкции по маршруту, указания, информацию о дорожной обстановке в режиме реального времени или навигационную информацию.

Включение сервера Maps Grounding Lite MCP позволяет LLM вызывать новые инструменты, предоставляемые сервером, для возврата дополнительной информации о заземлении для перечисленных выше типов данных. Хотя LLM может использовать эту дополнительную информацию для контекста, генерируемый им ответ может не содержать точной информации, возвращаемой сервером MCP. Вам следует проверить точность сгенерированного ответа.

Биллинг и квоты

Использование Grounding Lite в экспериментальном режиме бесплатно. Однако на инструменты, предоставляемые Grounding Lite, действуют следующие квоты:

Поиск мест : 100 запросов в минуту на проект. 1000 запросов в день на проект.
Поиск погоды : 300 запросов в минуту на проект.
Вычислительные маршруты : 300 запросов в минуту на проект.

Политики и условия обслуживания

На Grounding Lite распространяются Условия использования платформы Google Карт , включая условия, специфичные для данного сервиса. В этом разделе описаны дополнительные требования к использованию Grounding Lite, включая совместимые программы LLM и требования к указанию источника.

Требования к совместимым LLM

Вы можете использовать Grounding Lite только при наличии степени магистра права, соответствующей Условиям обслуживания платформы Google Карт.

Например, вы несёте ответственность за то, чтобы контент Google Карт не кэшировался, не сохранялся и не использовался для улучшения выбранной вами модели обучения на платформе Google Карт. Перед использованием Grounding Lite вам необходимо ознакомиться с Условиями использования для любой модели, которую вы планируете использовать с Grounding Lite. Запрещается использовать Grounding Lite с моделями, которые используют входные данные для обучения или улучшения модели. Вы несёте ответственность за полное соответствие использования модели ограничениям на контент Google Карт, установленным в Условиях использования платформы Google Карт, включая условия, специфичные для данного сервиса.

Требования к атрибуции для источников Google Maps

Каждый ответ, касающийся инструментов Grounding Lite, включает источники. При представлении результатов, использующих инструменты Grounding Lite, необходимо указать соответствующие источники Google Карт, соблюдая следующие требования:

Источники Google Карт должны следовать непосредственно за сгенерированным контентом, поддерживаемым этими источниками. Этот сгенерированный контент также называется «заземлённым выходом» .
Источники Google Maps должны быть доступны для просмотра в течение одного взаимодействия пользователя.

Источники для инструмента поиска мест

Поле places инструмента search_places предоставляет источники, поддерживающие summary . Для places возвращаются следующие метаданные:

place (название ресурса)
id
location
googleMapsLinks

Для каждого места необходимо создать предварительный просмотр ссылки, соответствующий следующим требованиям:

Укажите каждый источник в Google Maps, следуя рекомендациям по указанию источника текста Grounding Lite .
Отобразить заголовок исходной страницы из метаданных Open Graph og:title из googleMapsLinks , предоставленных в ответе.
Ссылка на источник, используя places.googleMapsLinks.placeUrl из ответа.

Настройте LLM для использования сервера MCP

Для использования Grounding Lite вам сначала потребуется ключ API с включенным сервисом Maps Grounding Lite API. Затем вы можете настроить LLM для доступа к серверу MCP. Сервер Grounding Lite MCP использует потоковый HTTP-транспорт.

Создайте или настройте ключ API

Вы можете использовать существующий ключ API с Maps Grounding Lite или создать новый, если для него включена служба API Maps Grounding Lite . Использование API Maps Grounding Lite не требует оплаты в течение экспериментального периода, но для проекта необходимо включить тарификацию.

Чтобы включить API:

В Google Cloud Console выберите проект, который вы хотите использовать для Grounding Lite.
Включите выставление счетов за проект в Google Cloud Console .
В верхней навигационной панели откройте терминал Cloud Shell.

Выполните следующие команды, чтобы включить службу и конечную точку MCP:

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

Следуйте инструкциям в разделе Начало работы с платформой Google Карт, чтобы создать или настроить ключ API.

Ключ API должен быть передан на сервер MCP с помощью заголовка X-Goog-Api-Key . Его необходимо указать как пользовательский HTTP-заголовок в конфигурации инструмента MCP LLM.

Настройте LLM для доступа к серверу Grounding Lite MCP

Получив ключ API с включенной службой API Maps Grounding Lite , вы можете настроить LLM для доступа к серверу MCP, следуя соответствующей документации по настройке MCP и используя URL-адрес сервера Grounding Lite MCP: https://mapstools.googleapis.com/mcp

Настройка Grounding Lite с помощью Gemini CLI

В этом разделе представлен пример настройки сервера Grounding Lite MCP с помощью Gemini CLI . Подробнее см. в разделе «Серверы MCP с Gemini CLI» .

После установки Gemini CLI вы можете использовать команду add для настройки сервера Maps Grounding Lite MCP:
```
gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp
```
Если настройка прошла успешно, вы должны увидеть подтверждение того, что сервер добавлен в ваши настройки пользователя.

Чтобы убедиться, что сервер работает правильно, выполните команду /mcp list :

> /mcp list

Configured MCP servers:

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

Начните задавать вопросы, связанные с Картами, с помощью интерфейса командной строки. Например, попробуйте запрос «Порекомендуйте мне несколько ресторанов в Маунтин-Вью», который должен вызвать инструмент search_places от вашего имени.

Обмен отзывами

Чтобы поделиться отзывом о Grounding Lite, воспользуйтесь следующими формами: