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이 아닌 중간 경유지 1개가 포함된 경로에는 두 개의 구간이 있습니다. via 중간 경유지가 1개인 경로에는 구간이 하나만 있습니다. 구간의 순서는 origin에서 intermediates부터 destination까지 경유지의 순서와 일치합니다.

distanceMeters

integer

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

duration

string (Duration format)

경로를 탐색하는 데 필요한 시간입니다. routingPreferenceTRAFFIC_UNAWARE로 설정하면 이 값은 staticDuration과 동일합니다. routingPreferenceTRAFFIC_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_ 관리자가_order를 true로 설정하면 이 필드에는 중간 경유지의 최적화된 순서가 포함됩니다. 그렇지 않으면 이 필드는 비어 있습니다. 예를 들어 입력이 Origin: LA라고 가정합니다. 중개자: Dallas, Bangor, Phoenix 목적지: 뉴욕, 최적화된 중간 경유지 순서는 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_preferenceTRAFFIC_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)

트래픽 밀도를 자세히 설명하는 속도 읽기 간격입니다. TRAFFIC_AWARETRAFFIC_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_AWARETRAFFIC_AWARE_OPTIMAL 라우팅 환경설정의 경우 적용할 수 있습니다. 간격은 겹치지 않고 RouteLg의 전체 폴리라인을 포함합니다. 지정된 간격의 시작 지점은 이전 간격의 끝 지점과 동일합니다.

예:

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