Method: computeRoutes

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}

enum (RouteLabel)

다른 경로와 비교할 경로의 특정 속성을 식별하는 데 유용한 Route의 라벨입니다.

object (RouteLeg)

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

integer

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

string (Duration format)

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

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

string (Duration format)

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

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

object (Polyline)

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

string

경로에 대한 설명입니다.

string

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

object (Viewport)

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

object (RouteTravelAdvisory)

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

integer

optimizeWaypointOrder를 true로 설정하면 이 필드에 최적화된 중간 경유지 순서가 포함됩니다. 그렇지 않으면 이 필드는 비어 있습니다. 예를 들어 출발지: LA, 중간 경유지: Dallas, Bangor, Phoenix, Destination: New York을 입력하고 최적화된 중간 경유지 순서가 Phoenix, Dallas, Bangor인 경우 이 필드에는 [2, 0, 1] 값이 포함됩니다. 색인은 입력에 제공된 첫 번째 중간 경유지에 대해 0으로 시작합니다.

object (RouteLocalizedValues)

Route 속성의 텍스트 표현

string

Navigation SDK에 전달할 수 있는 웹 안전 base64 인코딩 경로 토큰입니다. 이 토큰을 사용하면 Navigation SDK가 탐색 중에 경로를 재구성할 수 있습니다. 다시 라우팅하는 경우 v2.computeRoutes를 호출하여 경로를 만들 때 원래 의도를 따릅니다. 고객은 이 토큰을 불투명 blob으로 취급해야 합니다. 읽기 또는 변형을 위한 것이 아닙니다. 참고: Route.route_token는 ComputeRoutesRequest.routing_preference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정한 요청에만 사용할 수 있습니다. Route.route_token는 경유지가 포함된 요청에는 지원되지 않습니다.

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}

integer

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

string (Duration format)

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

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

string (Duration format)

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

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

object (Polyline)

각 step의 다중선이 포함된 이 구간의 전체 다중선입니다.

object (Location)

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

object (Location)

이 구간의 도착 위치입니다. 이 위치는 제공된 destination과(와) 다를 수 있습니다. 예를 들어 제공된 destination가 도로 근처에 있지 않으면 도로 위 한 지점입니다.

object (RouteLegStep)

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

object (RouteLegTravelAdvisory)

경로 구간에서 가능한 교통 구역 제한과 같이 사용자에게 알려야 하는 추가 정보가 포함됩니다.

object (RouteLegLocalizedValues)

RouteLeg 속성의 텍스트 표현

object (StepsOverview)

이 RouteLeg의 단계에 대한 개요 정보입니다. 이 필드는 Transit 경로에 대해서만 채워집니다.

{

  // 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.
}

string

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

object (Struct format)

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

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}

integer

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

string (Duration format)

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

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

object (Polyline)

이 단계와 연결된 다중선입니다.

object (Location)

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

object (Location)

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

object (NavigationInstruction)

탐색 안내

object (RouteLegStepTravelAdvisory)

구간 구간에서 가능한 교통 구역 제한과 같이 사용자에게 알려야 하는 추가 정보가 포함되어 있습니다.

object (RouteLegStepLocalizedValues)

RouteLegStep 속성의 텍스트 표현

object (RouteLegStepTransitDetails)

이동 모드가 TRANSIT인 경우 이 단계와 관련된 세부정보입니다.

enum (RouteTravelMode)

이 단계에 사용된 이동 수단입니다.

{
  "maneuver": enum (Maneuver),
  "instructions": string
}

enum (Maneuver)

현재 단계에 대한 내비게이션 안내를 캡슐화합니다 (예: 좌회전, 병합 또는 직선). 이 필드는 표시할 아이콘을 결정합니다.

string

이 단계를 탐색하기 위한 안내

{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (SpeedReadingInterval)

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

{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

텍스트 형식으로 표시된 이동 거리입니다.

object (LocalizedText)

교통상황을 고려하지 않은 지속 시간으로, 텍스트 형식으로 표시됩니다.

{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}

object (TransitStopDetails)

단계의 도착 및 출발 정류장에 대한 정보입니다.

object (TransitDetailsLocalizedValues)

RouteLegStepTransitDetails 속성의 텍스트 표현

string

이 노선에서 이동할 방향을 차량에 표시된 대로 또는 출발 정류장에 지정합니다. 방향은 보통 종착역입니다.

string (Duration format)

현재 동일한 정류장에서 출발 사이의 예상 시간을 지정합니다. 예를 들어 운행 간격(초) 값이 600인 경우 버스를 놓치면 다음 버스까지 10분을 기다려야 합니다.

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

object (TransitLine)

이 단계에서 사용되는 대중교통 노선에 대한 정보입니다.

integer

출발 정류장에서 도착 정류장까지 정류장의 수입니다. 이 수에는 도착 정류장이 포함되지만 출발 정류장은 제외됩니다. 예를 들어 경로가 정류장 A에서 출발하여 정류장 B와 C를 지나 정류장 D에 도착하면 stopCount는 3을 반환합니다.

string

승객의 대중교통 이동을 식별하기 위해 일정 및 표지판에 표시되는 텍스트입니다. 텍스트는 서비스 제공일에 포함된 이동을 고유하게 식별해야 합니다. 예를 들어 '538'은 평일 15시 10분에 캘리포니아주 산호세에서 출발하여 캘리포니아주 새크라멘토로 가는 암트랙 열차의 tripShortText입니다.

{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}

object (TransitStop)

단계의 도착 정류장에 대한 정보입니다.

string (Timestamp format)

단계의 예상 도착 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

object (TransitStop)

단계의 출발 정류장에 대한 정보입니다.

string (Timestamp format)

단계의 예상 출발 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

{
  "name": string,
  "location": {
    object (Location)
  }
}

string

대중교통 정류장의 이름입니다.

object (Location)

위도/경도 좌표로 표현된 정류장의 위치입니다.

{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}

object (LocalizedTime)

해당 시간대와 함께 형식이 지정된 텍스트 표현으로 된 시간입니다.

object (LocalizedTime)

해당 시간대와 함께 형식이 지정된 텍스트 표현으로 된 시간입니다.

{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}

object (LocalizedText)

특정 시간대의 문자열로 지정된 시간입니다.

string

시간대가 포함됩니다. IANA 시간대 데이터베이스(예: 미국/뉴욕')에 따라 정의된 시간대의 이름이 값으로 사용됩니다.

{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}

object (TransitAgency)

이 대중교통 노선을 운영하는 대중교통 기관입니다.

string

대중교통 노선의 전체 이름입니다(예: '8 Avenue Local').

string

대중교통 기관에서 제공한 이 대중교통 노선의 URI입니다.

string

이 노선의 표지판에 흔히 사용되는 색상입니다. 16진수로 표현됩니다.

string

이 노선과 연결된 아이콘의 URI입니다.

string

이 대중교통 노선의 짧은 이름입니다. 이 이름은 일반적으로 'M7' 또는 '355'와 같은 노선 번호입니다.

string

이 노선의 표지판 텍스트에 흔히 사용되는 색상입니다. 16진수로 표현됩니다.

object (TransitVehicle)

이 대중교통 노선에서 운행되는 운송 수단의 유형입니다.

{
  "name": string,
  "phoneNumber": string,
  "uri": string
}

string

이 대중교통 기관의 이름입니다.

string

대중교통 기관의 언어별 형식 전화번호입니다.

string

대중교통 기관의 URI입니다.

{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}

object (LocalizedText)

차량의 이름(대문자)입니다.

enum (TransitVehicleType)

사용된 차량 유형입니다.

string

이 운송 수단 유형과 관련된 아이콘의 URI입니다.

string

지역 교통 표지판을 기반으로 이 운송 수단 유형과 연결된 아이콘의 URI입니다.

{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (TollInfo)

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

object (SpeedReadingInterval)

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

예:

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

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

텍스트 형식으로 표시된 이동 거리입니다.

object (LocalizedText)

텍스트 형식으로 표시된 교통상황을 고려한 시간입니다. 참고: 교통정보를 요청하지 않은 경우 이 값은 staticDuration과 동일합니다.

object (LocalizedText)

교통상황을 고려하지 않은 지속 시간으로, 텍스트 형식으로 표시됩니다.

{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}

object (MultiModalSegment)

RouteLeg.steps의 여러 멀티 모달 세그먼트에 관한 정보를 요약했습니다. RouteLeg의 단계에 다중 모달 세그먼트가 포함되어 있지 않으면 이 필드가 채워지지 않습니다.

{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}

object (NavigationInstruction)

다중 모달 세그먼트의 NavigationDirections

enum (RouteTravelMode)

다중 모달 세그먼트의 이동 수단입니다.

integer

상응하는 RouteLegStep 색인은 멀티모달 세그먼트의 시작입니다.

integer

상응하는 RouteLegStep 색인으로, 멀티 모달 세그먼트의 끝입니다.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

필수 항목입니다. 표시 영역의 최저점입니다.

object (LatLng)

필수 항목입니다. 표시 영역의 최고점입니다.

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}

object (LocalizedText)

텍스트 형식으로 표시된 이동 거리입니다.

object (LocalizedText)

교통상황을 고려한 시간으로, 텍스트 형식으로 표시됩니다. 참고: 교통정보를 요청하지 않은 경우 이 값은 staticDuration와 동일합니다.

object (LocalizedText)

교통상황을 고려하지 않은 지속 시간으로, 텍스트 형식으로 표시됩니다.

object (LocalizedText)

텍스트 형식으로 표시된 대중교통 요금입니다.

{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}

object (GeocodedWaypoint)

출발지 지오코딩된 경유지입니다.

object (GeocodedWaypoint)

목적지 지오코딩된 경유지입니다.

object (GeocodedWaypoint)

요청에 지정된 순서대로 경유지의 0 기반 위치에 해당하는 색인 필드를 각각 포함하는 중간 지오코딩된 경유지의 목록입니다.

{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}

object (Status)

지오코딩 작업의 상태 코드를 나타냅니다.

string

0개 이상의 유형 태그 형식으로 된 결과의 유형입니다. 지원되는 유형: 주소 유형 및 주소 구성요소 유형

boolean

지오코더가 원래 요청에 대해 정확히 일치하는 결과를 반환하지 않았지만 요청된 주소의 일부분과 일치함을 나타냅니다. 원래 요청을 검사하여 맞춤법 오류 및/또는 불완전한 주소를 찾아낼 수 있습니다.

string

이 결과의 장소 ID입니다.

integer

요청에 있는 해당 중간 경유지의 색인입니다. 해당 경유지가 중간 경유지인 경우에만 채워집니다.