RoutingPreference
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مجموعة من القيم التي تحدد العوامل التي يجب مراعاتها عند حساب المسار.
| عمليات التعداد |
ROUTING_PREFERENCE_UNSPECIFIED |
لم يتم تحديد أي تفضيل للتوجيه. الإعداد التلقائي هو TRAFFIC_UNAWARE. |
TRAFFIC_UNAWARE |
احتساب المسارات بدون مراعاة ظروف حركة المرور المباشرة مناسب عندما لا تكون ظروف حركة المرور مهمة أو غير مناسبة. ينتج عن استخدام هذه القيمة أقل وقت استجابة. ملاحظة: بالنسبة إلى RouteTravelModeDRIVE وTWO_WHEELER، يستند المسار والمدة إلى شبكة الطرق ومتوسط أحوال حركة المرور المستقلة عن الوقت، وليس ظروف الطريق الحالية. وبالتالي، قد تتضمن المسارات طرقًا مغلقة مؤقتًا. قد تختلف النتائج الخاصة بطلب معين بمرور الوقت بسبب التغييرات التي تطرأ على شبكة الطرق وتعديل متوسط أحوال حركة المرور والطبيعة الموزعة للخدمة. قد تختلف النتائج أيضًا بين مسارات متساوية تقريبًا في أي وقت أو معدل تكرار. |
TRAFFIC_AWARE |
تحسب المسارات التي تأخذ في الاعتبار ظروف حركة المرور المباشرة. على عكس TRAFFIC_AWARE_OPTIMAL، يتم تطبيق بعض التحسينات لتقليل وقت الاستجابة بشكلٍ كبير. |
TRAFFIC_AWARE_OPTIMAL |
تحسب المسارات التي تأخذ في الاعتبار ظروف حركة المرور المباشرة، بدون تطبيق معظم تحسينات الأداء. ينتج عن استخدام هذه القيمة أعلى وقت استجابة. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRouting preferences determine how routes are calculated, considering factors like traffic conditions.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eTRAFFIC_UNAWARE\u003c/code\u003e provides the fastest routes without considering real-time traffic, suitable when traffic is irrelevant.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eTRAFFIC_AWARE\u003c/code\u003e balances speed and accuracy by incorporating live traffic data with some optimizations for reduced latency.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eTRAFFIC_AWARE_OPTIMAL\u003c/code\u003e prioritizes accuracy, calculating routes based on real-time traffic for the most precise ETAs, but may have higher latency.\u003c/p\u003e\n"],["\u003cp\u003eThe default setting is \u003ccode\u003eTRAFFIC_UNAWARE\u003c/code\u003e if no routing preference is specified using \u003ccode\u003eROUTING_PREFERENCE_UNSPECIFIED\u003c/code\u003e.\u003c/p\u003e\n"]]],["The document defines four routing preference values: `ROUTING_PREFERENCE_UNSPECIFIED` (defaulting to `TRAFFIC_UNAWARE`), `TRAFFIC_UNAWARE` (ignores live traffic, offering lowest latency and relying on average conditions), `TRAFFIC_AWARE` (considers live traffic with some latency optimizations), and `TRAFFIC_AWARE_OPTIMAL` (considers live traffic without optimizations, resulting in highest latency). When choosing routes with the drive or two-wheeler travel mode, only average time-independent conditions are considered, with possible inclusions of closed roads.\n"],null,["# RoutingPreference\n\nA set of values that specify factors to take into consideration when calculating the route.\n\n| Enums ||\n|----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ROUTING_PREFERENCE_UNSPECIFIED` | No routing preference specified. Default to `TRAFFIC_UNAWARE`. |\n| `TRAFFIC_UNAWARE` | Computes routes without taking live traffic conditions into consideration. Suitable when traffic conditions don't matter or are not applicable. Using this value produces the lowest latency. Note: For [`RouteTravelMode`](/maps/documentation/routes/reference/rest/v2/RouteTravelMode) `DRIVE` and `TWO_WHEELER`, the route and duration chosen are based on road network and average time-independent traffic conditions, not current road conditions. Consequently, routes may include roads that are temporarily closed. Results for a given request may vary over time due to changes in the road network, updated average traffic conditions, and the distributed nature of the service. Results may also vary between nearly-equivalent routes at any time or frequency. |\n| `TRAFFIC_AWARE` | Calculates routes taking live traffic conditions into consideration. In contrast to `TRAFFIC_AWARE_OPTIMAL`, some optimizations are applied to significantly reduce latency. |\n| `TRAFFIC_AWARE_OPTIMAL` | Calculates the routes taking live traffic conditions into consideration, without applying most performance optimizations. Using this value produces the highest latency. |"]]
