RouteTravelAdvisory
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
가능한 트래픽 존 제한과 같이 사용자에게 알려야 하는 추가 정보가 포함됩니다.
JSON 표현 |
{
"tollInfo": {
object (TollInfo )
},
"speedReadingIntervals": [
{
object (SpeedReadingInterval )
}
],
"fuelConsumptionMicroliters": string,
"routeRestrictionsPartiallyIgnored": boolean,
"transitFare": {
object (Money )
}
} |
필드 |
tollInfo |
object (TollInfo )
경로의 통행료에 관한 정보를 포함합니다. 이 필드는 경로에 통행료가 예상되고 TOLLS 가 요청의 ComputeRoutesRequest.extra_computations 에 포함된 경우에만 채워집니다. 이 필드가 설정되었지만 estimatedPrice 하위 필드가 채워지지 않은 경우 경로에 통행료가 포함되지만 예상 가격은 알 수 없습니다. tollInfo 이 설정되지 않은 경우 경로에 통행료가 부과되지 않습니다.
|
speedReadingIntervals[] |
object (SpeedReadingInterval )
트래픽 밀도를 나타내는 속도 읽기 간격 이 필드는 요청에 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference 값이 있고 TRAFFIC_ON_POLYLINE 이 ComputeRoutesRequest.extra_computations 에 포함된 경우에만 요청에 대해 채워집니다. 인터벌은 중복 없이 경로의 전체 폴리라인을 포함합니다. 지정된 간격의 시작점은 이전 간격의 종료점과 동일합니다. 예:
polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).
|
fuelConsumptionMicroliters |
string (int64 format)
예상 연료 소비량(마이크로리터)입니다. 이 필드는 요청의 ComputeRoutesRequest.extra_computations 에 FUEL_CONSUMPTION 가 포함된 경우에만 채워집니다.
|
routeRestrictionsPartiallyIgnored |
boolean
반환된 경로에 요청된 이동 수단 또는 경로 수정자에 적합하지 않은 제한사항이 있을 수 있습니다.
|
transitFare |
object (Money )
이 경로의 총 요금 또는 티켓 비용이 포함됩니다(있는 경우). 이 속성은 TRANSIT 요청 및 모든 대중교통 단계에 대해 요금 정보를 사용할 수 있는 경로의 경우에만 반환됩니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eJSON representation provides supplementary route details like tolls, traffic, and fuel consumption.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etollInfo\u003c/code\u003e field indicates presence of tolls and potential costs if available.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003espeedReadingIntervals\u003c/code\u003e details traffic density along the route using intervals.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003efuelConsumptionMicroliters\u003c/code\u003e provides an estimate of fuel usage for the route.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003erouteRestrictionsPartiallyIgnored\u003c/code\u003e signals potential unsuitability of the route for the travel mode.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etransitFare\u003c/code\u003e shows the total cost for transit routes if applicable and available.\u003c/p\u003e\n"]]],["The core content details route information via a JSON structure. Key data includes `tollInfo` (toll details), `speedReadingIntervals` (traffic density), `fuelConsumptionMicroliters` (predicted fuel use), `routeRestrictionsPartiallyIgnored` (potential route restrictions), and `transitFare` (total transit costs). The data provides details about tolls, traffic, fuel consumption, restrictions and fares, depending on the request and the characteristics of the route.\n"],null,["# RouteTravelAdvisory\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nContains the additional information that the user should be informed about, such as possible traffic zone restrictions.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"tollInfo\": { object (/maps/documentation/routes/reference/rest/v2/TollInfo) }, \"speedReadingIntervals\": [ { object (/maps/documentation/routes/reference/rest/v2/SpeedReadingInterval) } ], \"fuelConsumptionMicroliters\": string, \"routeRestrictionsPartiallyIgnored\": boolean, \"transitFare\": { object (/maps/documentation/routes/reference/rest/v2/Money) } } ``` |\n\n| Fields ||\n|-------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `tollInfo` | `object (`[TollInfo](/maps/documentation/routes/reference/rest/v2/TollInfo)`)` Contains information about tolls on the route. This field is only populated if tolls are expected on the route and `TOLLS` is included in the request's [ComputeRoutesRequest.extra_computations](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#body.request_body.FIELDS.extra_computations). If this field is set, but the `estimatedPrice` subfield is not populated, then the route contains tolls, but the estimated price is unknown. If `tollInfo` is not set, then there are no tolls expected on the route. |\n| `speedReadingIntervals[]` | `object (`[SpeedReadingInterval](/maps/documentation/routes/reference/rest/v2/SpeedReadingInterval)`)` Speed reading intervals indicating traffic density. This field is only populated for requests when the request has a `TRAFFIC_AWARE` or `TRAFFIC_AWARE_OPTIMAL` [ComputeRoutesRequest.routing_preference](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#body.request_body.FIELDS.routing_preference) value, and `TRAFFIC_ON_POLYLINE` is included in the [ComputeRoutesRequest.extra_computations](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#body.request_body.FIELDS.extra_computations). The intervals cover the entire polyline of the route without overlap. The start point of a specified interval is the same as the end point of the preceding interval. Example: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speedReadingIntervals: [A,C), [C,D), [D,G). |\n| `fuelConsumptionMicroliters` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The predicted fuel consumption in microliters. This field is only populated when `FUEL_CONSUMPTION` is included in the request's [ComputeRoutesRequest.extra_computations](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#body.request_body.FIELDS.extra_computations). |\n| `routeRestrictionsPartiallyIgnored` | `boolean` Returned route may have restrictions that are not suitable for requested travel mode or route modifiers. |\n| `transitFare` | `object (`[Money](/maps/documentation/routes/reference/rest/v2/Money)`)` If present, contains the total fare or ticket costs on this route This property is only returned for `TRANSIT` requests and only for routes where fare information is available for all transit steps. |"]]