سطح داده های ترافیک را تنظیم کنید

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

تنظیمات ترافیکی که انتخاب می‌کنید، دقت جزئیات مسیر را با عملکرد درخواست به یکی از دو روش زیر متعادل می‌کند:

  • آگاه از ترافیک -- دقیق‌ترین نتایج ممکن را ارائه می‌دهد (با تأخیر بالاتر).

  • عدم آگاهی از ترافیک -- نتایج را در اسرع وقت (کمترین تأخیر) برگردانید.

وقتی درخواستی ارسال می‌کنید، بررسی کنید که آیا بهتر است دقیق‌ترین نتایج ممکن را برگردانید یا نتایج را در سریع‌ترین زمان ممکن برگردانید. API مسیرها گزینه‌هایی را ارائه می‌دهد که به شما امکان می‌دهد کیفیت داده‌های پاسخ را در مقابل تأخیر پاسخ کنترل کنید.

نحوه تنظیم سطح ترافیک

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 استفاده می‌کنید، تعداد عناصر موجود در یک درخواست (تعداد مبدا × تعداد مقصد) نمی‌تواند از ... بیشتر شود.

  1. برای اطلاعات بیشتر در مورد محاسبه محدودیت‌های ماتریس مسیر، به محاسبه ماتریس مسیر مراجعه کنید.

پاسخ‌هایی که خواهید دید به شرح زیر است:

  • 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"
}

پیکربندی ترافیک روی خطوط چندخطی

API مسیرها به شما امکان می‌دهد اطلاعاتی در مورد شرایط ترافیک در امتداد یک چندخطی آگاه از ترافیک درخواست کنید. برای اطلاعات بیشتر به درخواست چندخطی‌ها مراجعه کنید.