Route

시작, 끝 및 중간 경유지를 연결하는 일련의 연결된 도로 구간으로 구성된 경로를 캡슐화합니다.

JSON 표현 
{
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ]
}
필드
legs[]

object (RouteLeg)

경로를 구성하는 구간 (경유지 사이의 경로 세그먼트) 모음입니다. 각 구간은 via이 아닌 두 개의 경유지 사이의 이동에 해당합니다. 예를 들어 중간 경유지가 없는 경로의 경우 구간이 하나만 있습니다. via가 아닌 중간 경유지가 한 개 포함된 경로의 구간은 2개입니다. 하나의 via 중간 경유지가 포함된 경로에는 하나의 구간이 있습니다. 구간의 순서는 origin부터 intermediates, destination까지 경유지의 순서와 일치합니다.
distanceMeters

integer

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

string (Duration format)

경로를 탐색하는 데 필요한 시간입니다. routingPreference을 TRAFFIC_UNAWARE로 설정하면 이 값은 staticDuration와 동일합니다. routingPreference을 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정하면 이 값은 교통상황을 고려하여 계산됩니다.

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

string (Duration format)

교통상황을 고려하지 않고 경로를 통과한 시간입니다.

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

object (Polyline)

전체 경로 다중선입니다. 이 다중선은 모든 legs의 결합된 다중선이 됩니다.
description

string

경로에 대한 설명입니다.
warnings[]

string

경로를 표시할 때 표시할 경고의 배열입니다.
viewport

object (Viewport)

다중선의 표시 영역 경계 상자입니다.
travelAdvisory

object (RouteTravelAdvisory)

경로에 대한 추가 정보입니다.
optimizedIntermediateWaypointIndex[]

integer

ComputeRoutesRequest.optimize_discount_order가 true로 설정된 경우, 이 필드에는 중간 경유지의 최적화된 순서가 포함됩니다. 그 외의 경우에는 이 필드가 비어 있습니다. 예를 들어 입력이 LA이고 중급이 댈러스, 뱅고, 피닉스, 목적지: 뉴욕이고 최적화된 중간 경유지 순서는 피닉스, 댈러스, 뱅고라고 가정해 보겠습니다. 이 필드에는 [2, 0, 1] 값이 포함됩니다. 색인은 첫 번째 중간 경유지에 대해 0으로 시작합니다.

RouteLeg

via이 아닌 경유지 사이의 세그먼트를 캡슐화합니다.

JSON 표현 
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}
필드
distanceMeters

integer

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

string (Duration format)

구간을 탐색하는 데 필요한 시간입니다. route_preference가 TRAFFIC_UNAWARE로 설정되면 이 값은 staticDuration와 동일합니다. route_preference이 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL이면 이 값은 교통상황을 고려하여 계산됩니다.

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

string (Duration format)

구간을 통과하는 시간으로, 교통 상황을 고려하지 않고 계산됩니다.

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

object (Polyline)

이 구간의 전체 폴리라인입니다. 여기에는 각 step의 다중선이 포함됩니다.
startLocation

object (Location)

이 구간의 시작 위치입니다. 제공된 origin과 다를 수 있습니다. 예를 들어 제공된 origin가 도로 근처에 있지 않으면 이 값은 도로 위 한 지점입니다.
endLocation

object (Location)

이 구간의 종료 위치입니다. 제공된 destination과 다를 수 있습니다. 예를 들어 제공된 destination가 도로 근처에 있지 않으면 이 값은 도로 위 한 지점입니다.
steps[]

object (RouteLegStep)

이 구간 내의 세그먼트를 나타내는 단계의 배열입니다. 각 단계는 하나의 탐색 안내를 나타냅니다.
travelAdvisory

object (RouteLegTravelAdvisory)

경로 구간에서 가능한 교통 구역 제한 등 사용자에게 알려야 하는 추가 정보를 캡슐화합니다.

Polyline

인코딩된 폴리라인을 캡슐화합니다.

JSON 표현 
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
필드
통합 필드 polyline_type. 다중선의 유형을 캡슐화합니다. 기본값은 encoded_polyline입니다. polyline_type은 다음 중 하나여야 합니다.
encodedPolyline

string

다중선 인코딩 알고리즘을 사용하는 다중선의 문자열 인코딩
geoJsonLinestring

object (Struct format)

GeoJSON LineString 형식을 사용하여 다중선을 지정합니다.

RouteLegStep

RouteLeg의 세그먼트를 캡슐화합니다. 단계는 단일 탐색 명령에 해당합니다. 경로 구간은 계단으로 구성됩니다.

JSON 표현 
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  }
}
필드
distanceMeters

integer

이 단계의 이동 거리(미터)입니다. 경우에 따라 이 필드에 값이 없을 수 있습니다.
staticDuration

string (Duration format)

교통상황을 고려하지 않은 이 단계를 통과한 이동 시간입니다. 경우에 따라 이 필드에 값이 없을 수 있습니다.

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

object (Polyline)

이 단계와 연결된 폴리라인입니다.
startLocation

object (Location)

이 단계의 시작 위치입니다.
endLocation

object (Location)

이 단계의 종료 위치입니다.
navigationInstruction

object (NavigationInstruction)

내비게이션 안내
travelAdvisory

object (RouteLegStepTravelAdvisory)

구간 구간에 있을 수 있는 교통 구역 제한과 같이 사용자에게 알려야 하는 추가 정보를 캡슐화합니다.

RouteLegStepTravelAdvisory

구간 구간에 있을 수 있는 교통 구역 제한과 같이 사용자에게 알려야 하는 추가 정보를 캡슐화합니다.

JSON 표현 
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
필드
speedReadingIntervals[]

object (SpeedReadingInterval)

트래픽 밀도를 자세히 설명하는 속도 읽기 간격. TRAFFIC_AWARE 및 TRAFFIC_AWARE_OPTIMAL 라우팅 환경설정의 경우에 적용됩니다. 간격은 RouteLegStep의 전체 폴리라인을 겹치지 않습니다. 지정된 간격의 시작 지점은 이전 간격의 종료 지점과 동일합니다.

예:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegTravelAdvisory

경로 구간에서 가능한 교통 구역 제한 등 사용자에게 알려야 하는 추가 정보를 캡슐화합니다.

JSON 표현 
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
필드
tollInfo

object (TollInfo)

특정 RouteLeg의 통행 요금 정보를 캡슐화합니다. 이 필드는 RouteLeg에 통행료가 있을 것으로 예상되는 경우에만 채워집니다. 이 필드가 설정되지만estimatedPrice 하위 필드가 채워지지 않으면 도로에 유료도로가 포함될 것으로 예상되지만 예상 가격은 알 수 없습니다. 이 필드가 존재하지 않으면 RouteLeg에 유료 도로가 없는 것입니다.
speedReadingIntervals[]

object (SpeedReadingInterval)

트래픽 밀도를 자세히 설명하는 속도 읽기 간격. TRAFFIC_AWARE 및 TRAFFIC_AWARE_OPTIMAL 라우팅 환경설정의 경우에 적용됩니다. 간격은 겹치지 않고 RouteLg의 전체 폴리라인을 포함합니다. 지정된 간격의 시작 지점은 이전 간격의 종료 지점과 동일합니다.

예:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).