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. Timing(선택사항 - 최대 1개 설정): UTC 오프셋이 있는 RFC 3339 타임스탬프(예: '2026-09-19T08:00:00-07:00') 기본값은 지금 출발입니다. TRANSIT의 경우 시간은 과거 최대 7일 또는 미래 최대 100일일 수 있습니다. 다른 모드의 경우 시간은 미래의 최대 365일일 수 있으며 과거가 아니어야 합니다.

   • departure_time: 사용자가 출발 시간을 말할 때 사용합니다 (예: '내일 오전 8시').
   • arrival_time: 사용자가 도착해야 하는 시간을 말할 때 사용합니다 (예: '오전 9시까지 도착').

5. routing_preference (enum - 선택사항):

   • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (기본값): 실시간 교통정보, 교통체증 상황, 도로 폐쇄를 무시합니다. 가장 짧은 지연 시간
   • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: 가능한 경우 실시간 교통 상황을 사용합니다. WALK 또는 BICYCLE에는 지원되지 않습니다. 사용자가 교통정보, 혼잡도 또는 교통 상황이 반영된 도착 예정 시간에 대해 문의하는 경우에만 설정합니다. 비용과 지연 시간이 더 많이 발생합니다.

6. location_bias (객체 - 선택사항): 경유지 주소에서 장소 이름의 모호성을 해소하는 데 사용되는 {"latitude": number, "longitude": number}입니다. 이름이 모호하고 (예: 'Springfield') 사용자가 지역을 제공하지 않은 경우 address에 지정된 이름을 유지하고 지역을 추측하는 대신 의도한 지역을 향해 location_bias를 설정합니다.

7. compute_alternative_routes (불리언 - 선택사항): 사용자가 경로 옵션 또는 대안을 요청하는 경우에만 true로 설정합니다. 기본값은 false이며, 추천 경로만 반환합니다.

8. include_polyline (불리언 - 선택사항): 경로 도형 (encoded_polyline)이 필요한 경우에만 true로 설정합니다. 기본값은 false입니다.

도구 호출 안내:

• 출발지 또는 목적지가 누락된 경우 도구를 호출하기 전에 사용자에게 명확한 설명을 요청해야 합니다.
• 'A는 B에서 얼마나 멀리 떨어져 있나요?'라는 질문의 경우 B를 origin로, A를 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를 사용하여 compute_routes MCP 도구를 호출하는 방법을 보여줍니다.

입력 스키마

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