MCP Tools Reference: mapstools.googleapis.com

Инструмент: search_places

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

Требования к входным данным (КРИТИЧНО)

1. 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').

2. 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).

3. language_code (строка, необязательный параметр) – язык, на котором будет показана сводка результатов поиска.

   • Формат: двухбуквенный код языка (ISO 639-1), за которым может следовать нижнее подчеркивание и двухбуквенный код страны (ISO 3166-1 alpha-2), например en, ja, en_US, zh_CN, es_MX. Если код языка не указан, результаты будут на английском языке.

4. region_code (строка – НЕОБЯЗАТЕЛЬНО). Код региона пользователя в формате Unicode CLDR. Этот параметр используется для показа сведений о месте, например названия места для определенного региона, если оно доступно. Параметр может влиять на результаты в соответствии с действующим законодательством.

   • Формат: двухбуквенный код страны (ISO 3166-1 alpha-2), например US или CA.

Инструкции для вызова инструмента

• Информация о местоположении (КРИТИЧНО). В запросе должно быть достаточно информации о местоположении. Если местоположение не указано (например, просто "пиццерии"), необходимо добавить его в параметр text_query (например, "пиццерии в Нью-Йорке") или использовать параметр location_bias. Если нужно уточнить, о каком городе идет речь, добавьте название штата/провинции и региона/страны.

• Всегда предоставляйте максимально точный и контекстуально богатый text_query.

• Используйте location_bias, только если координаты указаны явным образом или если определение местоположения на основе известного контекста пользователя уместно и необходимо для получения более точных результатов.

• Обоснованный ответ должен быть связан с источником с помощью информации из поля attribution, если она доступна.

В приведенном ниже фрагменте кода показано, как использовать curl для вызова инструмента search_places MCP.

Схема ввода

{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,

  // Union field _location_bias can be only one of the following:
  "locationBias": {
    object (LocationBias)
  }
  // End of list of possible types for union field _location_bias.
}

{
  "circle": {
    object (Circle)
  }
}

{
  "center": {
    object (LatLng)
  },

  // Union field _radius_meters can be only one of the following:
  "radiusMeters": number
  // End of list of possible types for union field _radius_meters.
}

{
  "latitude": number,
  "longitude": number
}

Схема вывода

{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string
}

{
  "place": string,
  "id": string,
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _location can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field _location.
}

{
  "latitude": number,
  "longitude": number
}

{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}

{
  "title": string,
  "url": string
}

Аннотации инструментов

Аннотации инструментов отправляются клиентам MCP, чтобы описать основной риск, связанный с определенным инструментом. Большинство клиентов считают эти подсказки ненадежными, но их можно использовать, чтобы определить, когда пользователю может быть отправлен запрос на подтверждение.

Вместе со строкой заголовка определены следующие логические подсказки:

• readOnlyHint: если значение равно true, инструмент не изменяет среду. Значение по умолчанию – false.
• destructiveHint: если задано значение True, инструмент может выполнять деструктивные действия. Если задано значение false, инструмент может выполнять только действия по добавлению. Значение по умолчанию: true.
• idempotentHint: если задано значение True, повторный вызов инструмента с теми же аргументами не окажет дополнительного влияния на его среду. Значение по умолчанию – false.
• openWorldHint – если значение равно true, инструмент может взаимодействовать с внешними объектами. Если значение равно false, инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌