اولویتهای ترافیکی که انتخاب میکنید دقت جزئیات مسیر و عملکرد درخواست را به یکی از دو روش متعادل میکنند:
آگاه از ترافیک -- دقیق ترین نتایج ممکن را برگردانید (تأخیر بالاتر).
ترافیک ناآگاه -- نتایج را در سریع ترین زمان ممکن برگردانید (کمترین تاخیر).
وقتی درخواستی میکنید، بررسی کنید که آیا بهتر است دقیقترین نتایج ممکن را برگردانید یا نتایج را در سریعترین زمان ممکن برگردانید. Routes API گزینه هایی را ارائه می دهد که به شما امکان می دهد کیفیت داده های پاسخ را در مقابل تأخیر پاسخ کنترل کنید.
نحوه تنظیم سطح ترافیک
Routes API RoutingPreference (REST) و RoutingPreference (gRPC) را ارائه می دهد که به شما امکان می دهد اولویت های مسیریابی را برای محاسبه مسیرها مشخص کنید.
پیش فرض نتایج ناآگاه از ترافیک است. شما گزینه های ترافیک را با اولویت های مسیریابی TRAFFIC_UNAWARE
، TRAFFIC_AWARE
و TRAFFIC_AWARE_OPTIMAL
انتخاب می کنید. هر اولویت مسیریابی نتایجی را تولید می کند که در کیفیت مسیر، تخمین ETA و تأخیر پاسخ متفاوت است.
شرایط ترافیکی
شرایط ترافیکی سرعت جریان ترافیک را مشخص می کند:
ترافیک عادی : بدون ازدحام و ترافیک با سرعت عادی جریان دارد.
ترافیک سبک تا متوسط : ازدحام فزاینده، با جریان ترافیک با سرعت کم.
ترافیک سنگین : ازدحام شدید، با کاهش شدید سرعت ترافیک.
ترافیک بی خبر
TRAFFIC_UNAWARE
تنظیم پیش فرض است. از این اولویت مسیریابی زمانی استفاده کنید که میخواهید سریعترین پاسخها را دریافت کنید و جزئیات مسیریابی تقریبی به اندازه کافی خوب هستند.
مسیرهای TRAFFIC_UNAWARE
بدون در نظر گرفتن شرایط ترافیک فعلی محاسبه میشوند. این اولویت مسیریابی منجر به سریعترین پاسخ درخواست (کمترین تاخیر) می شود.
اگر TRAFFIC_UNAWARE
را انتخاب کنید، مسیر و مدت زمان انتخاب شده بر اساس شبکه جاده و میانگین شرایط ترافیکی مستقل از زمان است، نه شرایط فعلی جاده. در نتیجه، مسیرها ممکن است شامل جاده هایی باشد که به طور موقت بسته هستند. نتایج برای یک درخواست معین ممکن است در طول زمان به دلیل تغییرات در شبکه جادهها، میانگین بهروز شده شرایط ترافیکی و ماهیت توزیعشده خدمات متفاوت باشد. نتایج همچنین ممکن است بین مسیرهای تقریباً معادل در هر زمان یا فرکانس متفاوت باشد.
در اینجا پاسخ هایی است که خواهید دید:
duration
- شامل ETA برای مسیر است.staticDuration
: ETA برای مسیر فقط اطلاعات ترافیک تاریخی را در نظر می گیرد. برایTRAFFIC_UNAWARE
، این مقدار دارای همان مقدارduration
است.
آگاه از ترافیک
وقتی میخواهید جزئیات مسیریابی دقیقتری نسبت به TRAFFIC_UNAWARE
میخواهید، از این اولویت مسیریابی استفاده کنید، و با این حال برایتان مهم نیست که پاسخها با افزایش متوسط تأخیر برگردانده شوند.
وقتی اولویت مسیریابی TRAFFIC_AWARE
را تنظیم می کنید، سرویس مسیر را با توجه به شرایط ترافیک فعلی محاسبه می کند. در نتیجه، جزئیات مسیر و مسیر با دقت بیشتری شرایط دنیای واقعی را منعکس می کنند. از آنجایی که این افزایش در کیفیت داده ها به قیمت تاخیر پاسخ تمام می شود، بهینه سازی عملکرد برای کاهش بسیاری از تاخیر اعمال می شود.
در اینجا پاسخ هایی است که خواهید دید:
duration
: ETA با در نظر گرفتن اطلاعات ترافیک در زمان واقعی.staticDuration
ETA برای مسیر تنها با در نظر گرفتن اطلاعات ترافیک تاریخی.
ترافیک آگاه بهینه
از این اولویت مسیریابی زمانی استفاده کنید که بدون توجه به مدت زمان پاسخها، نتایجی با بالاترین کیفیت میخواهید. این اولویت مسیریابی بیشترین تاخیر را در بازگشت پاسخ ها دارد (بالاترین تاخیر).
وقتی اولویت مسیریابی TRAFFIC_AWARE_OPTIMAL
را تنظیم می کنید، این سرویس مسیر را با توجه به شرایط ترافیک فعلی محاسبه می کند، اما بهینه سازی عملکرد را اعمال نمی کند. در این حالت سرور جستجوی جامع تری در شبکه جاده ها انجام می دهد تا مسیر بهینه را پیدا کند.
اولویت مسیریابی TRAFFIC_AWARE_OPTIMAL
معادل حالتی است که maps.google.com و برنامه تلفن همراه Google Maps استفاده می کند.
هنگامی که از این گزینه با Compute Route Matrix استفاده می کنید، تعداد عناصر در یک درخواست (تعداد مبدا × تعداد مقصد) نمی تواند بیشتر شود.
- برای اطلاعات بیشتر در مورد محدودیتهای ماتریس مسیر محاسبه، به محاسبه ماتریس مسیر مراجعه کنید.
در اینجا پاسخ هایی است که خواهید دید:
duration
: ETA برای مسیر با در نظر گرفتن اطلاعات ترافیک در زمان واقعی.staticDuration
: ETA برای مسیر فقط اطلاعات ترافیک تاریخی را در نظر می گیرد.
تنظیم زمان حرکت (اختیاری)
از این ویژگی فقط برای درخواستهای آگاه از ترافیک استفاده کنید، جایی که زمان حرکت باید در آینده باشد. اگر ویژگی departureTime
را تنظیم نکنید، به طور پیشفرض روی زمانی است که درخواست را انجام میدهید.
هنگامی که میخواهید نحوه پیشبینی ترافیک را هنگام انتخاب مسیر تنظیم کنید، از ویژگی departureTime
به همراه گزینههای TRAFFIC_AWARE
و TRAFFIC_AWARE_OPTIMAL
استفاده کنید.
TRAFFIC_UNAWARE
: توصیه نمی شود زیرا انتخاب مسیر و مدت زمان بر اساس شبکه جاده و میانگین شرایط ترافیکی مستقل از زمان است.TRAFFIC_AWARE
وTRAFFIC_AWARE_OPTIMAL
: برای حرکتهایی که در آینده نزدیک اتفاق میافتند توصیه میشود زیرا این تنظیمات ترجیحی شرایط ترافیک زنده را در نظر میگیرند. هرچه زمانdepartureTime
به زمان حال نزدیکتر باشد، ترافیک زنده مهمتر و مرتبطتر میشود. هرچه زمان حرکت را در آینده دورتر تعیین کنید، در انتخاب مسیرها به شرایط ترافیکی تاریخی توجه بیشتری می شود.
مثال: نحوه انتخاب مسیریابی آگاه از ترافیک
کد JSON زیر نحوه تنظیم اولویت مسیریابی TRAFFIC_AWARE_OPTIMAL
را در بدنه موجودیت پیام درخواست نشان می دهد.
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }
ترافیک را روی چند خط پیکربندی کنید
Routes API به شما امکان می دهد اطلاعاتی در مورد شرایط ترافیک در امتداد یک خط چند خطی آگاه از ترافیک درخواست کنید. برای اطلاعات بیشتر به درخواست چند خط مراجعه کنید.