FallbackInfo
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מידע שקשור לאופן שבו ולמה נעשה שימוש בתוצאה חלופית. אם השדה הזה מוגדר, המשמעות היא שהשרת השתמש במצב ניתוב אחר מהמצב המועדף עליכם כחלופה.
שדות |
routingMode |
enum (FallbackRoutingMode )
מצב הניתוב ששימש לתשובה. אם החלופה הופעלה, המצב עשוי להיות שונה מהעדפת הניתוב שהוגדרה בבקשת הלקוח המקורית.
|
reason |
enum (FallbackReason )
הסיבה לכך שנעשה שימוש בתשובה החלופית במקום בתשובה המקורית. השדה הזה מאוכלס רק כשמצב החלופה מופעל, ומוחזרת התשובה החלופית.
|
FallbackRoutingMode
מצב הניתוב בפועל המשמש לתגובת החלופה המוחזרת.
טיפוסים בני מנייה (enum) |
FALLBACK_ROUTING_MODE_UNSPECIFIED |
לא בשימוש. |
FALLBACK_TRAFFIC_UNAWARE |
מציין שהמדד TRAFFIC_UNAWARE RoutingPreference שימש לחישוב התגובה. |
FALLBACK_TRAFFIC_AWARE |
מציין שהמדד TRAFFIC_AWARE RoutingPreference שימש לחישוב התגובה. |
FallbackReason
סיבות לשימוש בתשובה חלופית.
טיפוסים בני מנייה (enum) |
FALLBACK_REASON_UNSPECIFIED |
לא צוינה סיבה לחלופה. |
SERVER_ERROR |
אירעה שגיאת שרת במהלך חישוב מסלולים במצב הניתוב המועדף עליך, אבל הצלחנו להחזיר תוצאה שחושבה באמצעות מצב חלופי. |
LATENCY_EXCEEDED |
לא הצלחנו לסיים את החישוב במצב הניתוב המועדף עליך בזמן, אבל הצלחנו להחזיר תוצאה שחושבה באמצעות מצב חלופי. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון 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. |"]]