MCP Tools Reference: mapstools.googleapis.com

도구: compute_routes

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

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

  • address: (문자열, 예: 'Eiffel Tower, Paris') 참고: 입력 주소가 세분화되거나 구체적일수록 더 나은 결과를 얻을 수 있습니다.

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

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

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

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

curl 요청 
                  
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)

선택사항입니다. 교통수단을 지정합니다.

Waypoint

JSON 표현 
{

  // 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.
}
필드
통합 필드 location_type. 위치를 나타내는 다양한 방법입니다. location_type은 다음 중 하나여야 합니다.
latLng

object (LatLng)

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

string

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

string

사람이 읽을 수 있는 주소 또는 플러스 코드입니다. 자세한 내용은 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,
  "attribution": {
    object (Attribution)
  }
}
필드
distanceMeters

integer

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

string (Duration format)

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

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

object (Attribution)

경로와 함께 표시할 기여 분석이 필요합니다.

기간

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초 이상의 기간의 경우 0이 아닌 nanos 필드 값은 seconds 필드와 동일한 부호여야 합니다. -999,999,999~+999,999,999(포함)이어야 합니다.

기여 분석

JSON 표현 
{
  "title": string,
  "url": string
}
필드
title

string

기여 분석에 표시할 제목입니다.
url

string

기여 분석에 연결할 URL입니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ❌ | 읽기 전용 힌트: ✅ | 개방형 세계 힌트: ❌