FallbackInfo
Stay organized with collections
Save and categorize content based on your preferences.
Information related to how and why a fallback result was used. If this field is set, then it means the server used a different routing mode from your preferred mode as fallback.
| Fields |
routingMode |
enum (FallbackRoutingMode)
Routing mode used for the response. If fallback was triggered, the mode may be different from routing preference set in the original client request.
|
reason |
enum (FallbackReason)
The reason why fallback response was used instead of the original response. This field is only populated when the fallback mode is triggered and the fallback response is returned.
|
FallbackRoutingMode
Actual routing mode used for returned fallback response.
| Enums |
FALLBACK_ROUTING_MODE_UNSPECIFIED |
Not used. |
FALLBACK_TRAFFIC_UNAWARE |
Indicates the TRAFFIC_UNAWARE RoutingPreference |
FALLBACK_TRAFFIC_AWARE |
Indicates the TRAFFIC_AWARE RoutingPreference |
FallbackReason
Reasons for using fallback response.
| Enums |
FALLBACK_REASON_UNSPECIFIED |
No fallback reason specified. |
SERVER_ERROR |
A server error happened while calculating routes with your preferred routing mode, but we were able to return a result calculated by an alternative mode. |
LATENCY_EXCEEDED |
We were not able to finish the calculation with your preferred routing mode on time, but we were able to return a result calculated by an alternative mode. |
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\u003eFallbackInfo provides details on why and how a fallback routing result was used if the server deviated from the preferred routing mode.\u003c/p\u003e\n"],["\u003cp\u003eThis information includes the actual routing mode used (FallbackRoutingMode) and the reason for the fallback (FallbackReason).\u003c/p\u003e\n"],["\u003cp\u003eFallbackRoutingMode specifies whether traffic conditions were considered in the fallback route (TRAFFIC_AWARE or TRAFFIC_UNAWARE).\u003c/p\u003e\n"],["\u003cp\u003eFallbackReason clarifies if the fallback was due to a server error or exceeding the allowed calculation time.\u003c/p\u003e\n"]]],["The server may use a fallback routing mode if the preferred mode fails. This fallback information is provided in JSON format, including the `routingMode` used and the `reason` for the fallback. The `routingMode` can be `FALLBACK_TRAFFIC_UNAWARE` or `FALLBACK_TRAFFIC_AWARE`. The `reason` can be `SERVER_ERROR` (due to an internal error) or `LATENCY_EXCEEDED` (calculation exceeded the allowed time). Specific enumerations define the exact fallback mode and reason used.\n"],null,["# FallbackInfo\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [FallbackRoutingMode](#FallbackRoutingMode)\n- [FallbackReason](#FallbackReason)\n\nInformation related to how and why a fallback result was used. If this field is set, then it means the server used a different routing mode from your preferred mode as fallback.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"routingMode\": enum (/maps/documentation/routes/reference/rest/v2/FallbackInfo#FallbackRoutingMode), \"reason\": enum (/maps/documentation/routes/reference/rest/v2/FallbackInfo#FallbackReason) } ``` |\n\n| Fields ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `routingMode` | `enum (`[FallbackRoutingMode](/maps/documentation/routes/reference/rest/v2/FallbackInfo#FallbackRoutingMode)`)` Routing mode used for the response. If fallback was triggered, the mode may be different from routing preference set in the original client request. |\n| `reason` | `enum (`[FallbackReason](/maps/documentation/routes/reference/rest/v2/FallbackInfo#FallbackReason)`)` The reason why fallback response was used instead of the original response. This field is only populated when the fallback mode is triggered and the fallback response is returned. |\n\nFallbackRoutingMode\n-------------------\n\nActual routing mode used for returned fallback response.\n\n| Enums ||\n|-------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `FALLBACK_ROUTING_MODE_UNSPECIFIED` | Not used. |\n| `FALLBACK_TRAFFIC_UNAWARE` | Indicates the `TRAFFIC_UNAWARE` [`RoutingPreference`](/maps/documentation/routes/reference/rest/v2/RoutingPreference) was used to compute the response. |\n| `FALLBACK_TRAFFIC_AWARE` | Indicates the `TRAFFIC_AWARE` [`RoutingPreference`](/maps/documentation/routes/reference/rest/v2/RoutingPreference) was used to compute the response. |\n\nFallbackReason\n--------------\n\nReasons for using fallback response.\n\n| Enums ||\n|-------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `FALLBACK_REASON_UNSPECIFIED` | No fallback reason specified. |\n| `SERVER_ERROR` | A server error happened while calculating routes with your preferred routing mode, but we were able to return a result calculated by an alternative mode. |\n| `LATENCY_EXCEEDED` | We were not able to finish the calculation with your preferred routing mode on time, but we were able to return a result calculated by an alternative mode. |"]]
