Заземление Lite

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

Сервис Google Maps Platform Grounding Lite, поддерживающий протокол Model Context Protocol (MCP), упрощает интеграцию ваших приложений искусственного интеллекта с надежными геопространственными данными из Google Maps. Сервер MCP предоставляет инструменты, позволяющие LLM-системам получать доступ к данным о местах, погоде и маршрутах. Вы можете протестировать Grounding Lite, включив его в любом инструменте, поддерживающем серверы MCP.

Инструменты

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

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

• Расчет маршрутов : Запрос информации о маршрутах движения на автомобиле или пешком между двумя точками и получение информации о расстоянии и продолжительности маршрута.

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

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

Попробуйте демонстрационное приложение Grounding Lite (откройте в новой вкладке).

Выставление счетов и квоты

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

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

Политика и условия предоставления услуг

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

Требования к совместимым программам магистратуры в области права

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

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

Требования к указанию источников Google Maps

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

• Исходные файлы Google Maps должны непосредственно следовать за сгенерированным контентом, который эти исходные файлы поддерживают. Этот сгенерированный контент также называется Grounded Output (обоснованный вывод) .
• Исходные данные Google Maps должны быть доступны для просмотра в рамках одного взаимодействия пользователя.

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

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

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

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

• Укажите в качестве источника Google Maps, следуя рекомендациям Grounding Lite по указанию авторства текста .
• Ссылка на источник должна быть получена с помощью places.googleMapsLinks.placeUrl из ответа.

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

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

Включите сервис Maps Grounding Lite в своем проекте Google Cloud.

Чтобы включить API в вашем проекте:

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

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

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

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

Аутентификация с использованием ключа API.

Вы можете использовать существующий ключ API с Maps Grounding Lite или создать новый, при условии, что вы включите службу API Maps Grounding Lite как в проекте Google Cloud, так и в ключе.

Для аутентификации с использованием ключа API:

1. Создайте или настройте ключ API, следуя инструкциям в разделе «Начало работы с платформой Google Maps» .
2. Передайте ключ на сервер MCP, используя заголовок X-Goog-Api-Key . Необходимо указать этот заголовок в качестве пользовательского HTTP-заголовка в конфигурации инструмента MCP в LLM.

Примечание: При создании или настройке ключа API обязательно ограничьте его использование, применив соответствующие ограничения. Для получения дополнительной информации см. раздел «Ограничение использования ключей API» .

Аутентификация с использованием OAuth

Аутентификация с использованием OAuth может быть выполнена путем создания учетных данных OAuth и передачи их хосту MCP или серверному приложению MCP.

Для аутентификации с использованием OAuth:

1. В консоли Google Cloud выберите проект, который вы хотите использовать для Grounding Lite.
2. В меню «API и сервисы» выберите «Учетные данные» .
3. В верхнем меню выберите «Создать учетные данные» > «Идентификатор клиента OAuth» .
4. Если в проекте отсутствует настроенный экран согласия, нажмите «Настроить экран согласия» и следуйте инструкциям на экране.
5. В разделе «Метрики» нажмите «Создать клиент OAuth» .
6. На экране «Создать идентификатор клиента OAuth» выберите тип приложения и введите имя для идентификатора клиента.
7. Укажите дополнительные сведения, относящиеся к типу вашего приложения. Например, если вы создаете веб-приложение, добавьте разрешенные URI для запросов от браузера и сервера.
8. После создания клиента сохраните идентификатор клиента и секретный ключ.
9. При настройке вашего MCP-хоста или MCP-сервера для доступа к Grounding Lite передайте идентификатор и секрет клиента OAuth.

Для получения дополнительной информации см. раздел «Использование OAuth 2.0 для доступа к API Google» .

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

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

Для получения дополнительной информации см. раздел «Настройка MCP в приложении ИИ» .

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

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

1. После установки 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
   

   Если настройка прошла успешно, вы увидите подтверждение того, что сервер добавлен в ваши пользовательские настройки.

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

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

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

Примечание: Информацию о настройке расширения Gemini CLI для доступа к Grounding Lite с использованием OAuth см. в разделе Gemini CLI в документации MCP на Google Cloud.

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

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

• Сообщить об ошибке
• Отправьте запрос на добавление функции
• Оставьте отзыв