MCP Tools Reference: mapstools.googleapis.com

도구: compute_routes

지정된 출발지와 목적지 간의 이동 경로를 계산합니다. 지원되는 이동 수단: DRIVE (기본값), WALK

입력 요구사항 (중요): 출발지와 도착지가 모두 필요합니다. 각각은 다음 방법 중 하나를 사용하여 해당 필드 내에 중첩되어 제공되어야 합니다.

  • address: (문자열, 예: '에펠탑, 파리'). 참고: 입력 주소가 더 세부적이거나 구체적일수록 결과가 더 좋습니다.

  • lat_lng: (object, {"latitude": number, "longitude": number})

  • place_id: (문자열, 예: 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') 참고: 이 ID는 search_places 도구에서 가져올 수 있습니다. 입력 유형의 조합은 허용됩니다 (예: 주소별 출발지, lat_lng별 도착지). 출발지나 목적지가 누락된 경우 도구를 호출하기 전에 사용자에게 명확한 정보를 요청해야 합니다(MUST).

도구 호출 예: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

다음 샘플은 curl를 사용하여 compute_routes MCP 도구를 호출하는 방법을 보여줍니다.

컬 요청 
                  
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "compute_routes",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

ComputeRoutesRequest입니다.

ComputeRoutesRequest

JSON 표현 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode)
}
필드
origin

object (Waypoint)

필수 항목입니다. 출발지 경유지입니다.
destination

object (Waypoint)

필수 항목입니다. 목적지 경유지입니다.
travelMode

enum (RouteTravelMode)

선택사항입니다. 이동 수단을 지정합니다.

경유지

JSON 표현 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (google.type.LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
필드
통합 필드 location_type. 위치를 나타내는 다양한 방법 location_type은 다음 중 하나여야 합니다.
latLng

object (google.type.LatLng)

지리 좌표를 사용하여 지정된 지점입니다.
placeId

string

경유지와 연결된 장소 ID입니다.
address

string

사람이 읽을 수 있는 주소 또는 Plus Code입니다. 자세한 내용은 https://plus.codes를 참고하세요.

LatLng

JSON 표현 
{
  "latitude": number,
  "longitude": number
}
필드
latitude

number

위도입니다. 범위는 [-90.0, +90.0]입니다.
longitude

number

경도입니다. 범위는 [-180.0, +180.0]입니다.

출력 스키마

ComputeRoutesResponse입니다.

ComputeRoutesResponse

JSON 표현 
{
  "routes": [
    {
      object (Route)
    }
  ]
}
필드
routes[]

object (Route)

요청된 출발지와 목적지 간의 경로를 포함합니다. 현재는 하나의 경로만 반환됩니다.

경로

JSON 표현 
{
  "distanceMeters": integer,
  "duration": string
}
필드
distanceMeters

integer

경로의 이동 거리(미터)입니다.
duration

string (Duration format)

경로를 탐색하는 데 필요한 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

기간

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

시간 범위의 부호가 있는 초입니다. -315,576,000,000~+315,576,000,000(포함) 사이여야 합니다. 참고: 이 범위는 60초/분 * 60분/시간 * 24시간/일 * 365.25일/년 * 10,000년에서 계산됩니다.
nanos

integer

시간 범위의 나노초 단위로 된 부호가 있는 초수입니다. 1초 미만의 기간은 0 seconds 필드와 양수 또는 음수 nanos 필드로 표현됩니다. 1초 이상의 기간의 경우 nanos 필드의 0이 아닌 값은 seconds 필드와 부호가 같아야 합니다. -999,999,999~+999,999,999(포함) 사이여야 합니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ❌ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌