FallbackInfo
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يشير ذلك المصطلح إلى معلومات تتعلّق بكيفية استخدام نتيجة احتياطية وسبب استخدامها. إذا تم ضبط هذا الحقل، هذا يعني أنّ الخادم استخدم وضع توجيه مختلفًا عن الوضع المفضّل لديك كوضع احتياطي.
| الحقول |
routingMode |
enum (FallbackRoutingMode)
وضع التوجيه المستخدم للاستجابة. إذا تم تفعيل إجراء احتياطي، قد يختلف الوضع عن الإعدادات المفضّلة للتوجيه التي تم ضبطها في طلب العميل الأصلي.
|
reason |
enum (FallbackReason)
السبب في استخدام الردّ الاحتياطي بدلاً من الردّ الأصلي. لا تتم تعبئة هذا الحقل إلا عند تفعيل الوضع الاحتياطي وعرض الاستجابة الاحتياطية.
|
FallbackRoutingMode
وضع التوجيه الفعلي المُستخدَم للاستجابة الاحتياطية التي تم عرضها.
| عمليات التعداد |
FALLBACK_ROUTING_MODE_UNSPECIFIED |
غير مستخدَم |
FALLBACK_TRAFFIC_UNAWARE |
تشير هذه السمة إلى أنّه تم استخدام RoutingPreferenceTRAFFIC_UNAWARE لحساب الاستجابة. |
FALLBACK_TRAFFIC_AWARE |
تشير هذه السمة إلى أنّه تم استخدام RoutingPreferenceTRAFFIC_AWARE لحساب الاستجابة. |
FallbackReason
أسباب استخدام ردّ احتياطي
| عمليات التعداد |
FALLBACK_REASON_UNSPECIFIED |
لم يتم تحديد سبب احتياطي. |
SERVER_ERROR |
حدث خطأ في الخادم أثناء حساب المسارات باستخدام وضع التوجيه المفضل، لكننا تمكنا من عرض نتيجة تم حسابها بواسطة وضع بديل. |
LATENCY_EXCEEDED |
لم نتمكن من إنهاء الحساب باستخدام وضع التوجيه المفضل في الوقت المحدد، ولكننا تمكنا من عرض نتيجة تم حسابها باستخدام وضع بديل. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
