در
روز انجمن توسعهدهندگان Google Maps Platform بعدی ما در ماه دسامبر در سانفرانسیسکو به ما بپیوندید! برای شرکت کردن،
اکنون درخواست دهید.
TrafficModel
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این فیلد یکی از مفروضات زیر را برای محاسبه زمان سفر در شرایط ترافیکی مشخص می کند که در شماره های زیر نشان داده شده است. بسته به enum انتخاب شده، فیلد duration پاسخ TrafficModel متفاوت خواهد بود. این مقدار شامل زمان پیشبینیشده تا مقصد در ترافیک، بر اساس میانگینهای تاریخی است. TrafficModel فقط برای درخواستهایی در دسترس است که RoutingPreference روی TRAFFIC_AWARE_OPTIMAL و RouteTravelMode را روی DRIVE تنظیم کردهاند.
| Enums |
|---|
TRAFFIC_MODEL_UNSPECIFIED | استفاده نشده اگر مشخص شود، بهطور پیشفرض روی BEST_GUESS خواهد بود. |
BEST_GUESS | نشان می دهد که duration بازگشت باید بهترین تخمین زمان سفر با توجه به آنچه در مورد شرایط ترافیک تاریخی و ترافیک زنده شناخته شده است باشد. هرچه زمان departureTime به زمان حال نزدیکتر باشد، ترافیک زنده اهمیت بیشتری پیدا میکند. |
PESSIMISTIC | نشان می دهد که مدت زمان بازگشت باید بیشتر از زمان واقعی سفر در بیشتر روزها باشد، اگرچه روزهای گاه به گاه با شرایط ترافیکی به خصوص بد ممکن است از این مقدار فراتر رود. |
OPTIMISTIC | نشان میدهد که مدت زمان بازگشت باید در بیشتر روزها کوتاهتر از زمان واقعی سفر باشد، اگرچه ممکن است روزهای گاه به گاه با شرایط ترافیکی خوب سریعتر از این مقدار باشد. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2026-09-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2026-09-04 بهوقت ساعت هماهنگ جهانی."],[],["The core content outlines how to specify traffic-based time calculations, impacting the `duration` field. The `TRAFFIC_MODEL_UNSPECIFIED` defaults to `BEST_GUESS`, which uses historical and live data to estimate travel time. `PESSIMISTIC` calculates a longer travel time, likely exceeded only in severe conditions. Conversely, `OPTIMISTIC` calculates a shorter time, potentially beaten during favorable conditions. These options modify the estimated duration by factoring in historical traffic data and real-time conditions.\n"]]