Поиск мест

Инструмент search_places позволяет LLM находить места на Google Картах по запросу на естественном языке. Инструмент возвращает созданную ИИ сводку по подходящим местам. Для каждого места, упомянутого в сводке, также возвращается идентификатор места, координаты, ссылки на Google Карты и атрибуция.

На этой странице описаны параметры запроса, включая параметры Pro, содержимое ответа и порядок оплаты запросов. Полная схема инструмента приведена в справочнике по search_places.

Параметры запроса

LLM задает эти параметры при вызове инструмента на основе запроса пользователя и описания инструмента. Вы можете влиять на то, какие варианты использует модель, с помощью собственных инструкций. Подробнее о том, как управлять использованием Pro…

Option Описание
text_query Обязательно. Поисковый запрос, например coffee shops near Golden Gate Park. Запрос должен содержать достаточно геоданных, чтобы его можно было однозначно определить, или в запросе должен быть указан параметр location_bias.
location_bias Окружность (center и необязательный параметр radius_meters, до 50 000 метров), в пределах которой предпочтительно искать результаты. Если в text_query указано точное местоположение, используется оно.
language_code Язык сводки, например en или ja. По умолчанию используется английский язык.
region_code Код региона пользователя по CLDR, например US. Влияет на названия мест в зависимости от региона и может влиять на результаты в соответствии с действующим законодательством.
page_size Максимальное количество мест, которые нужно вернуть. Значение по умолчанию – 5. Значения от 6 до 10 доступны только в версии Pro. Если указать значение больше 10, возвращается ошибка INVALID_ARGUMENT. Сервис может вернуть меньше мест, чем запрошено.
include_extended_details Если true, сводка включает расширенную информацию о месте. Это функция Pro. Значение по умолчанию – false.

Профессиональные функции

Два варианта выбора SKU Pro. Запрос, в котором используется одна или обе функции, оплачивается по коду Pro:

Версия Pro Для чего его можно использовать
Адрес "true" сохранен с ярлыком "include_extended_details". Пользователь запрашивает расширенную информацию о месте, например выдержки из отзывов, популярные блюда в меню, описание атмосферы или советы посетителей.
page_size от 6 до 10 Пользователь хочет сравнить более пяти мест.

Запросы, в которых не используется ни один из вариантов, включая запросы с параметром page_size от 1 до 5, оплачиваются по коду Essentials.

Расширенная информация о месте

Задайте для параметра include_extended_details значение true, если в запросе пользователя нужны качественные данные, условия в реальном времени или специализированные атрибуты, например:

  • Что говорят клиенты: отзывы, настроения и обратная связь.
  • Особые предложения: позиции меню, блюда, фирменные блюда, напитки или особенности бизнеса.
  • Атмосфера: декор, эстетика, обстановка или настроение.
  • Практические советы для посетителей: нужно ли бронировать заранее, правила посещения без записи, время ожидания, загруженность места, парковка и удобства.
  • Близость: расстояние или время в пути от места, указанного в запросе, или центра location_bias, когда пользователь спрашивает, что находится поблизости или ближе всего.

Информация в сводке зависит от запроса и данных, доступных для каждого места. В каждом ответе могут быть представлены не все типы статистики.

Оставьте значение по умолчанию (false) для стандартных поисковых запросов: кухни или типы магазинов, адреса, контактная информация, часы работы и стандартные удобства. Запросы с расширенными сведениями обрабатываются дольше.

Расширенные сведения не меняют структуру ответа. Если их нет, в сводке будет по одному-два предложения о каждом месте. Теперь у каждого места есть более подробное описание, основанное на данных Google Карт, в том числе на отзывах. Записи структурированных данных places одинаковы для обоих кодов продукта.

Пример

В следующем запросе запрашивается до 8 мест с расширенными сведениями. Оплата за нее взимается по тарифу Pro:

{
  "method": "tools/call",
  "params": {
    "name": "search_places",
    "arguments": {
      "text_query": "date night Italian restaurants in Chicago",
      "page_size": 8,
      "include_extended_details": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

Без расширенных сведений сводка описывает каждое место в одном или двух предложениях:

Example Trattoria [0] (4,6★ (1250) · 123 W Example St · $$$) A neighborhood trattoria known for handmade pasta and a long wine list.

With extended details, the summary adds what reviewers highlight and practical tips:

Example Trattoria [0] (4.6★ (1,250) · 123 W Example St · $$$) Уютный ресторан со свечами на столах.Посетители описывают его как романтичный, но шумный по выходным. Среди фирменных блюд – тальятелле аль рагу, буррата и тирамису. Рекомендуется бронировать столики заранее. Посетителям без бронирования в пятницу и субботу вечером приходится ждать 30–45 минут. Места на уличной парковке ограничены.

Ответ

Ответ содержит:

  • summary – краткий пересказ результатов поиска на естественном языке. Может содержать цитаты, начинающиеся с нуля, например [0], которые сопоставляются с записями в places.
  • places[] – места, упомянутые в сводке. Для каждого места указаны:
    • place – название ресурса места в формате places/{id}.
    • id – идентификатор места. Его можно использовать с другими API платформы Google Карт, например чтобы показать место на карте.
    • location – широта и долгота места.
    • googleMapsLinks: ссылки на Google Карты для места (placeUrl), маршрутов (directionsUrl), отзывов (reviewsUrl), фотографий (photosUrl) и написания отзыва (writeAReviewUrl).
    • attribution – указание авторства, которое должно отображаться вместе с местом. Подробнее о требованиях к указанию авторства…

Ответ имеет одинаковую структуру для обоих SKU. Подробные сведения о полях приведены в справочнике по search_places.

Варианты перехода на Pro в период ограниченной общей доступности

В период ограниченной общей доступности функции Pro доступны только для проектов из белого списка Pro. Если ваш проект ещё не добавлен в белый список, параметры Pro будут игнорироваться, а не отклоняться.

  • include_extended_details обрабатывается как false.
  • page_size Значения выше 5, в том числе выше 10, уменьшаются до 5.

Запрос оплачивается по коду Essentials. Чтобы запросить доступ, ознакомьтесь с разделом Варианты Pro во время ограниченного общего доступа.

Оплата и квоты

Каждый запрос search_places – это одно оплачиваемое событие:

  • Запрос, в котором не используются функции Pro, оплачивается по коду Essentials SKU.
  • Запрос, в котором используется вариант Pro, оплачивается по коду Pro. Если вы используете оба варианта в одном запросе, плата не изменится. Цены на Pro указаны в разделе Сравнение Essentials, Pro и обоснования с Google Картами.

Квота search_places составляет 300 запросов в минуту на проект и распространяется на оба SKU. Цены приведены в основной таблице цен и таблице цен для Индии.