API مسیرهای ترجیحی، سه اولویت مسیریابی برای محاسبه مسیرها ارائه میدهد. تفاوت آنها در میزان در نظر گرفتن شرایط ترافیک در محاسبه مسیر است. هر اولویت مسیریابی نتایجی را تولید میکند که از نظر کیفیت مسیر، ETA تخمینی و تأخیر پاسخ، تا حدی متفاوت هستند.
درباره شرایط ترافیکی
شرایط ترافیک، نرخ جریان ترافیک را مشخص میکند. برای مثال:
وقتی هیچ ازدحامی وجود ندارد، شرایط ترافیک عادی تلقی میشود و ترافیک با سرعت عادی و بدون مانع جریان دارد.
با نزدیک شدن به ساعات شلوغی، تراکم ترافیک افزایش مییابد که باعث کند شدن ترافیک شده و شرایط ترافیکی سبک تا متوسط را ایجاد میکند.
در ترافیک سنگین، سرعت جریان ترافیک به شدت کاهش مییابد و شرایط ترافیکی سنگینی ایجاد میشود.
ترافیک بیخبر
وقتی اولویت مسیریابی TRAFFIC_UNAWARE را تنظیم میکنید، مسیرها بدون در نظر گرفتن شرایط ترافیک محاسبه میشوند. این اولویت مسیریابی کمترین تأخیر پاسخ را فراهم میکند (پاسخها با سریعترین سرعت بازگردانده میشوند).
از این ترجیح مسیریابی زمانی استفاده کنید که میخواهید پاسخها در سریعترین زمان ممکن بازگردانده شوند و جزئیات تقریبی مسیریابی به اندازه کافی خوب باشند.
آگاه از ترافیک
وقتی اولویت مسیریابی TRAFFIC_AWARE را تنظیم میکنید، مسیرها با در نظر گرفتن شرایط ترافیک محاسبه میشوند. در نتیجه، مسیر و جزئیات مسیر با دقت بیشتری شرایط دنیای واقعی را منعکس میکنند. از آنجایی که این افزایش کیفیت دادهها به قیمت تأخیر پاسخ تمام میشود، بهینهسازیهای عملکرد برای کاهش بخش عمدهای از تأخیر اعمال میشوند.
از این ترجیح مسیریابی زمانی استفاده کنید که جزئیات مسیریابی دقیقتری میخواهید، و در عین حال اگر پاسخها با افزایش متوسطی در تأخیر برگردانده شوند، برایتان مهم نیست.
ترافیک آگاه بهینه
وقتی ترجیح مسیریابی TRAFFIC_AWARE_OPTIMAL را تنظیم میکنید، مسیرها با در نظر گرفتن شرایط ترافیک محاسبه میشوند، اما هیچ بهینهسازی عملکردی اعمال نمیشود. در این حالت، سرور جستجوی جامعتری در شبکه جادهای انجام میدهد تا مسیر بهینه را پیدا کند.
این اولویت مسیریابی بالاترین تأخیر پاسخ را فراهم میکند (یعنی پاسخها با طولانیترین تأخیر برمیگردند). از این اولویت مسیریابی زمانی استفاده کنید که میخواهید نتایجی با بالاترین کیفیت داشته باشید، صرف نظر از اینکه پاسخها چقدر طول میکشند.
مثال
کد JSON زیر نحوه تنظیم اولویت مسیریابی در بدنه موجودیت پیام درخواست را نشان میدهد.
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }