RouteTravelAdvisory
Stay organized with collections
Save and categorize content based on your preferences.
Contains the additional information that the user should be informed about, such as possible traffic zone restrictions.
| JSON representation |
{
"tollInfo": {
object (TollInfo)
},
"speedReadingIntervals": [
{
object (SpeedReadingInterval)
}
],
"fuelConsumptionMicroliters": string,
"routeRestrictionsPartiallyIgnored": boolean,
"transitFare": {
object (Money)
}
} |
| Fields |
tollInfo |
object (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. 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.
|
speedReadingIntervals[] |
object (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 value, and TRAFFIC_ON_POLYLINE is included in the ComputeRoutesRequest.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).
|
fuelConsumptionMicroliters |
string (int64 format)
The predicted fuel consumption in microliters. This field is only populated when FUEL_CONSUMPTION is included in the request's ComputeRoutesRequest.extra_computations.
|
routeRestrictionsPartiallyIgnored |
boolean
Returned route may have restrictions that are not suitable for requested travel mode or route modifiers.
|
transitFare |
object (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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 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. |"]]
