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가 아닌 중간 경유지가 하나 포함된 경로에는 두 개의 구간이 있습니다. 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_waypoint_order가 true로 설정된 경우 이 필드에는 중간 경유지의 최적화된 순서가 포함됩니다. 그 외의 경우에는 이 필드가 비어 있습니다. 예를 들어 입력이 LA, 중개자: Dallas, Bangor, Phoenix, 목적지: New York이고 최적화된 중간 경유지 순서가 Phoenix, Dallas, Bangor라고 가정해 보겠습니다. 그러면 이 필드에는 [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)

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

폴리라인

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

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)

참고: 이 필드는 현재 채워져 있지 않습니다.

RouteLegTravelAdvisory

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

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

object (TollInfo)

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

object (SpeedReadingInterval)

속도 읽기 간격으로 교통량 밀도를 자세히 보여줍니다. TRAFFIC_AWARE 및 TRAFFIC_AWARE_OPTIMAL 라우팅 환경설정의 경우 적용할 수 있습니다. 간격은 겹치지 않고 RouteLeg의 전체 다중선에 적용됩니다. 지정된 간격의 시작 지점은 이전 간격의 끝 지점과 동일합니다.

예:

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