Method: computeRoutes

요청된 이동 수단에 대해 요청된 출발지와 목적지 간의 기본 경로를 반환합니다.

HTTP 요청

POST https://mapstools.googleapis.com/v1:computeRoutes

URL은 gRPC 트랜스코딩 문법을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
필드
origin

object (Waypoint)

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

object (Waypoint)

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

enum (RouteTravelMode)

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

object (Waypoint)

선택사항입니다. 출발지와 목적지 사이에 순서대로 통과할 중간 경유지입니다. 중간 경유지는 최대 25개까지 지원됩니다.

중간 경유지를 10개 넘게 지정하면 비용과 지연 시간이 증가합니다. travelMode가 TRANSIT인 경우 중간 경유지는 지원되지 않습니다.
routingPreference

enum (RoutingPreference)

선택사항입니다. 교통정보 데이터를 사용하여 경로를 계산하는 방법을 결정합니다. travelMode가 WALK 또는 BICYCLE인 경우 ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL는 지원되지 않습니다. TRANSIT의 경우 지연 및 취소와 같은 실시간 대중교통 데이터를 사용 설정합니다.
locationBias

object (LatLng)

선택사항입니다. 검색 결과의 편향을 유도할 위치입니다(예: 경유지 텍스트 검색어의 모호성 해소).
includePolyline

boolean

선택사항입니다. 응답 경로에 인코딩된 다중선을 포함할지 여부입니다. 기본값은 false입니다. true로 설정하면 Route.encoded_polyline이 반환됩니다.
computeAlternativeRoutes

boolean

선택사항입니다. 추천 경로 외에 대체 경로를 계산할지 여부입니다. 기본값은 false이며, 이 경우 추천 경로만 반환됩니다. true로 설정하면 사용 가능한 모든 경로가 반환되지만, 모든 요청에 대해 대체 경로가 제공되지 않을 수도 있습니다.
출발지에서 출발하거나 최종 경유지에 도착하는 시간을 지정합니다. 지정하지 않으면 기본적으로 현재 시간에 출발합니다. TRANSIT의 경우 시간은 최대 7일 전, 최대 100일 후여야 합니다. 다른 이동 수단의 경우 시간은 과거가 아니어야 하며 최대 365일 이내여야 합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
departureTime

string (Timestamp format)

선택사항입니다. 출발 시간을 기준으로 경로를 계산해야 함을 나타냅니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
arrivalTime

string (Timestamp format)

선택사항입니다. 도착 시간을 기준으로 경로를 계산해야 함을 나타냅니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
상호 배타적 필드의 끝입니다.

응답 본문

성공한 경우 응답 본문에 ComputeRoutesResponse의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/maps-platform.mapstools