MCP Tools Reference: mapstools.googleapis.com

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

Рассчитывает маршруты между пунктами отправления и назначения, в том числе с промежуточными остановками. Возвращает расстояние и продолжительность для каждого маршрута.

Требования к входным данным (КРИТИЧЕСКИ ВАЖНО):

1. origin и destination (объекты – ОБЯЗАТЕЛЬНО). Для каждого из них необходимо указать только одно из следующих значений:

   • address (строка, например 'Eiffel Tower, Paris'). Названия мест, достопримечательностей и компаний разрешаются напрямую, поэтому НЕ вызывайте сначала search_places, чтобы геокодировать путевую точку. Укажите город, регион или страну, упомянутые пользователем.
   • lat_lng (объект, {"latitude": number, "longitude": number}).
   • place_id (строка, например 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), например из search_places.

2. intermediate_waypoints (массив объектов, необязательный). До 10 остановок, через которые нужно проехать по порядку между пунктами отправления и назначения. Формат такой же, как у origin. Не поддерживается в TRANSIT. Включайте только те остановки, о которых просил пользователь.

3. travel_mode (enum – НЕОБЯЗАТЕЛЬНО): DRIVE (по умолчанию), WALK, BICYCLE или TRANSIT.

4. Время (НЕОБЯЗАТЕЛЬНО – укажите не более одного значения): временные метки RFC 3339 с разницей с UTC, например '2026-09-19T08:00:00-07:00'. По умолчанию используется текущее время. Для TRANSIT можно указать время в пределах семи дней в прошлом или 100 дней в будущем. Для других режимов время может быть установлено на 365 дней вперед и не должно быть в прошлом.

   • departure_time – используйте, когда пользователь говорит, когда он уедет (например, "завтра в 8 утра").
   • arrival_time – используйте, когда пользователь говорит, к какому времени ему нужно прибыть (например, "быть там к 9:00").

5. routing_preference (enum – НЕОБЯЗАТЕЛЬНО):

   • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (по умолчанию): не учитывает текущую загруженность дорог, инциденты и перекрытия. Самая низкая задержка.
   • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL – используются данные о загруженности дорог в реальном времени (если доступны). Не поддерживается для WALK и BICYCLE. Устанавливайте этот параметр, ТОЛЬКО когда пользователь спрашивает о дорожном движении, пробках или расчетном времени прибытия с учетом пробок. Это приводит к более высоким затратам и задержкам.

6. location_bias (объект, НЕОБЯЗАТЕЛЬНО). {"latitude": number, "longitude": number}, используемый для устранения неоднозначности названий мест в адресах путевых точек. Если название неоднозначно (например, "Спрингфилд"), а пользователь не указал регион, оставьте название в address как есть и установите location_bias в направлении нужной области, а не угадывайте регион.

7. compute_alternative_routes (логическое значение, НЕОБЯЗАТЕЛЬНО). Установите значение true, только если пользователь запрашивает варианты маршрута. По умолчанию используется значение false, при котором возвращается только рекомендуемый маршрут.

8. 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 каждого маршрута, если оно доступно.

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

Схема ввода

{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // Union field timing can be only one of the following:
  "departureTime": string,
  "arrivalTime": string
  // End of list of possible types for union field timing.
}

{
  "seconds": string,
  "nanos": integer
}

{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}

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

Схема вывода

{
  "routes": [
    {
      object (Route)
    }
  ]
}

{
  "distanceMeters": integer,
  "duration": string,
  "attribution": {
    object (Attribution)
  },
  "encodedPolyline": string,
  "retrievalToken": string
}

{
  "seconds": string,
  "nanos": integer
}

{
  "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: ❌