search_places |
Вызывайте этот инструмент, когда пользователь хочет найти места, компании, адреса, местоположения, достопримечательности или выполнить любой другой связанный запрос, связанный с Google Картами. Требования к входным данным (КРИТИЧЕСКИ ВАЖНО):
text_query (строка, ОБЯЗАТЕЛЬНО). Основной поисковый запрос. В нем должно быть четко указано, что ищет пользователь.
- Примеры:
'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'.
- Для получения информации о местах укажите запрашиваемый атрибут (например,
'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').
location_bias (объект, НЕОБЯЗАТЕЛЬНО). Используйте этот параметр, чтобы в первую очередь выводить результаты в пределах определенного географического региона.
- Формат:
{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
- Использование:
- Чтобы задать смещение в радиусе 5 км, используйте следующий код:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
- Чтобы задать сильное смещение к центральной точке, укажите
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (без radius_meters).
language_code (строка, необязательный параметр). Язык, на котором будет показана сводка результатов поиска.
- Формат. Двухбуквенный код языка (ISO 639-1), за которым может следовать символ подчеркивания и двухбуквенный код страны (ISO 3166-1 alpha-2), например
en, ja, en_US, zh_CN, es_MX. Если код языка не указан, результаты будут на английском.
region_code (строка, необязательный). Код региона пользователя в формате Unicode CLDR. Этот параметр используется для отображения информации о месте, например названия места в определенном регионе, если оно доступно. Этот параметр может влиять на результаты в соответствии с действующим законодательством.
- Формат. Двухбуквенный код страны (ISO 3166-1 alpha-2), например
US, CA.
Инструкции по вызову инструмента
Информация о местоположении (КРИТИЧЕСКИ ВАЖНО). Поисковый запрос должен содержать достаточно информации о местоположении. Если местоположение указано неточно (например, просто "пиццерии"), необходимо уточнить его в параметре text_query (например, "пиццерии в Нью-Йорке") или использовать параметр location_bias. При необходимости укажите город, штат/провинцию и регион/страну. Всегда указывайте максимально точные и подробные text_query. Используйте location_bias, только если координаты указаны явно или если определение местоположения по известному контексту пользователя уместно и необходимо для получения лучших результатов. Обоснованный ответ должен быть связан с источником с помощью информации из поля attribution, если оно доступно.
|
lookup_weather |
Получает подробные данные о погоде, включая текущие условия, почасовые и ежедневные прогнозы. Доступные данные: температура (текущая, ощущаемая, максимальная/минимальная, тепловой индекс), ветер (скорость, порывы, направление), астрономические события (восход/закат, фаза луны), осадки (тип, вероятность, количество/QPF), атмосферные условия (УФ-индекс, влажность, облачность, вероятность грозы) и геокодированный адрес местоположения. Местоположение и правила для местоположений (КРИТИЧЕСКИ ВАЖНО) Местоположение, для которого запрашиваются данные о погоде, указывается в поле location. Это поле имеет структуру "один из", то есть вы ДОЛЖНЫ указать значение ТОЛЬКО ДЛЯ ОДНОГО из трех подполей местоположения, чтобы обеспечить точный поиск данных о погоде.
Географические координаты (lat_lng)
- Используйте его, если у вас есть точные координаты широты и долготы.
- Пример: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Лос-Анджелес
Идентификатор места (place_id)
- Однозначный строковый идентификатор (идентификатор места в Google Картах).
- Идентификатор place_id можно получить с помощью инструмента search_places.
- Пример: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Эйфелева башня
Строка адреса (address)
- Строка в свободной форме, которая требует уточнения для геокодирования.
- Город и регион. Всегда указывайте регион или страну (например, "Лондон, Великобритания", а не просто "Лондон").
- Почтовый адрес. Укажите полный адрес, например "1600 Pennsylvania Ave NW, Washington, DC".
- Почтовые индексы: ОБЯЗАТЕЛЬНО должны сопровождаться названием страны (например, "90210, США", а не "90210").
- Пример: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}
Режимы использования
Текущая погода. Укажите только location. Не указывайте свойства date и hour. Почасовой прогноз. Укажите location, date и hour (0–23). Используйте для конкретного времени (например, "в 17:00") или таких выражений, как "в ближайшие несколько часов" или "позже сегодня". Если пользователь указывает минуты, округлите время до ближайшего часа. Почасовой прогноз погоды на период более 120 часов не поддерживается. Почасовые данные о погоде доступны за последние 24 часа. Прогноз на день. Укажите location и date. Не указывайте hour. Используйте для общих запросов о погоде на определенный день, например "погода на завтра", "погода в пятницу", "погода 25 декабря". Если в контексте нет сегодняшней даты, уточните ее у пользователя. Прогноз на срок более 10 дней, включая сегодняшний, не поддерживается. Прогноз погоды за прошедшие дни не поддерживается. Ограничения параметров:
|
compute_routes |
Рассчитывает маршруты между пунктами отправления и назначения, в том числе с промежуточными остановками. Возвращает расстояние и продолжительность для каждого маршрута. Требования к входным данным (КРИТИЧЕСКИ ВАЖНО):
origin и destination (объекты – ОБЯЗАТЕЛЬНО). Для каждого из них необходимо указать только одно из следующих значений:
address (строка, например 'Eiffel Tower, Paris'). Названия мест, достопримечательностей и компаний разрешаются напрямую, поэтому НЕ вызывайте сначала search_places, чтобы геокодировать путевую точку. Укажите город, регион или страну, упомянутые пользователем.lat_lng (объект, {"latitude": number, "longitude": number}).place_id (строка, например 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), например из search_places. intermediate_waypoints (массив объектов, необязательный). До 10 остановок, через которые нужно проехать по порядку между пунктами отправления и назначения. Формат такой же, как у origin. Не поддерживается в TRANSIT. Включайте только те остановки, о которых просил пользователь.
travel_mode (enum – НЕОБЯЗАТЕЛЬНО): DRIVE (по умолчанию), WALK, BICYCLE или TRANSIT.
Время (НЕОБЯЗАТЕЛЬНО – укажите не более одного значения): временные метки RFC 3339 с разницей с UTC, например '2026-09-19T08:00:00-07:00'. По умолчанию используется текущее время. Для TRANSIT можно указать время в пределах семи дней в прошлом или 100 дней в будущем. Для других режимов время может быть установлено на 365 дней вперед и не должно быть в прошлом.
departure_time – используйте, когда пользователь говорит, когда он уедет (например, "завтра в 8 утра").arrival_time – используйте, когда пользователь говорит, к какому времени ему нужно прибыть (например, "быть там к 9:00"). routing_preference (enum – НЕОБЯЗАТЕЛЬНО):
ROUTING_PREFERENCE_TRAFFIC_UNAWARE (по умолчанию): не учитывает текущую загруженность дорог, инциденты и перекрытия. Самая низкая задержка.ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL – используются данные о загруженности дорог в реальном времени (если доступны). Не поддерживается для WALK и BICYCLE. Устанавливайте этот параметр, ТОЛЬКО когда пользователь спрашивает о дорожном движении, пробках или расчетном времени прибытия с учетом пробок. Это приводит к более высоким затратам и задержкам. location_bias (объект, НЕОБЯЗАТЕЛЬНО). {"latitude": number, "longitude": number}, используемый для устранения неоднозначности названий мест в адресах путевых точек. Если название неоднозначно (например, "Спрингфилд"), а пользователь не указал регион, оставьте название в address как есть и установите location_bias в направлении нужной области, а не угадывайте регион.
compute_alternative_routes (логическое значение, НЕОБЯЗАТЕЛЬНО). Установите значение true, только если пользователь запрашивает варианты маршрута. По умолчанию используется значение false, при котором возвращается только рекомендуемый маршрут.
include_polyline (логическое значение, НЕОБЯЗАТЕЛЬНО). Установите значение true, только если требуется геометрия маршрута (encoded_polyline). Значение по умолчанию – false.
Инструкции по вызову инструмента
- Если пункт отправления или назначения отсутствует, вы ДОЛЖНЫ попросить пользователя уточнить информацию, прежде чем вызывать инструмент.
- Для вопросов типа "Как далеко А от Б?" используйте Б в качестве
origin и А в качестве destination.
Пример вызова инструмента: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Louvre Museum"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"} Инструкции по ответу:
- Если запрашиваются альтернативные маршруты, они упорядочиваются от наиболее рекомендуемых к наименее рекомендуемым.
- Если
routes пусто, сообщите пользователю, что маршрут не найден. Не пытайтесь угадать маршрут.
- Приводи только факты, полученные от инструмента. НЕ придумывайте пошаговые маршруты, линии общественного транспорта, станции, платформы или пересадки.
- Обоснованные выходные данные должны быть соотнесены с источником с помощью поля
attribution каждого маршрута, если оно доступно.
|
resolve_names |
Преобразует пакетный список запросов о местоположении (названия ориентиров или точные адреса) в канонические идентификаторы мест Google Карт. Требования к входным данным (КРИТИЧЕСКИ ВАЖНО):
queries (массив объектов, ОБЯЗАТЕЛЬНО). Список запросов местоположения, которые нужно обработать. Можно указать до 20 запросов.
- Каждый объект запроса должен содержать:
text (строка, ОБЯЗАТЕЛЬНО). Текстовый запрос, представляющий название или адрес места, которое нужно найти.
- Примеры:
'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'.
location_bias (объект, НЕОБЯЗАТЕЛЬНО). Используйте этот параметр, чтобы в первую очередь выводить результаты в пределах определенного географического региона.
- Формат:
{"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}
region_code (строка, необязательный). Код региона CLDR Unicode (двухбуквенный код страны, например US, CA) пользователя, для которого нужно уточнить результаты.
Инструкции по вызову инструмента
- Точность (КРИТИЧЕСКИ ВАЖНО). Запросы должны содержать название или адрес конкретного места. Общие поисковые запросы, например
'restaurants', или названия сетей, например 'Starbucks', не поддерживаются.
- НЕ вызывайте этот инструмент, если последующие инструменты, которые вы планируете использовать, уже принимают необработанные строки адреса или названия места напрямую.
Сохранить в Google Картах
- Ответ содержит поле
save_to_maps_url – одну ссылку на Google Карты, содержащую все успешно распознанные места.
- Когда пользователь захочет сохранить, отправить или открыть найденные места в виде списка в Google Картах, покажите ему эту ссылку. Не создавайте эту ссылку самостоятельно.
Обработка ошибок (КРИТИЧЕСКИЙ ПРИОРИТЕТ)
- Это инструмент пакетной обработки. Запрос может возвращать смешанные результаты (например, некоторые запросы выполняются успешно, а другие – нет).
- Выходной список
results гарантированно сопоставляется 1:1 с входными индексами queries. Если запрос не удастся выполнить, то в списке results по соответствующему индексу будет возвращено пустое сообщение Result (без entity).
- Вы ОБЯЗАНЫ проверить поле карты
failed_requests в ответе, чтобы определить, какой именно индекс запроса не удалось выполнить. Ключ failed_requests представляет собой индекс неудачного запроса, начинающийся с нуля. Не считайте, что весь пакетный вызов завершился ошибкой, если она произошла только в некоторых случаях.
|
resolve_maps_urls |
Преобразует список URL Google Карт в канонические идентификаторы мест Google Карт. Когда вызывать этот инструмент (ВАЖНО):
- Используйте этот инструмент, когда пользователь предоставляет одну или несколько ссылок или URL-адресов Google Карт (например, https://maps.app.goo.gl/…), ('https://www.google.com/maps/place/...' или 'https://maps.google.com/...'), и вам нужно извлечь канонические идентификаторы мест.
- В одном пакетном запросе можно указать до 20 URL.
Требования к входным данным (КРИТИЧЕСКИ ВАЖНО):
urls (массив строк, ОБЯЗАТЕЛЬНО). Список URL Google Карт, которые нужно преобразовать. Каждый URL должен быть действительным и указывать на одно место в Google Картах. Сохранить в Google Картах
- Ответ содержит поле
save_to_maps_url – одну ссылку на Google Карты, содержащую все успешно распознанные места.
- Если пользователь хочет сохранить, отправить или открыть найденные места в виде списка в Google Картах (например, собрать места, упомянутые в разговоре), покажите ему эту ссылку. Не создавайте эту ссылку самостоятельно.
Обработка ошибок (КРИТИЧЕСКИЙ ПРИОРИТЕТ)
- Это инструмент пакетной обработки. Запрос может возвращать смешанные результаты (например, некоторые URL разрешаются успешно, а другие – нет).
- Выходной список
entities гарантированно сопоставляется 1:1 с входными индексами urls. Если URL не удастся обработать, в списке entities появится пустое сообщение Entity (без полей).
- Вы ДОЛЖНЫ проверить поле карты
failed_requests в ответе, чтобы определить, какой именно индекс URL не удалось обработать. Ключ failed_requests представляет собой индекс URL, который не удалось обработать, в запросе (начиная с нуля). Не считайте, что весь пакетный вызов завершился ошибкой, если она произошла только в некоторых случаях.
|
