مشخص کنید که چگونه و آیا شامل داده های ترافیکی شود

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

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

Routes API RoutingPreference (REST) ​​و RoutingPreference (gRPC) را ارائه می دهد که به شما امکان می دهد اولویت های مسیریابی را برای محاسبه مسیرها مشخص کنید. این ترجیحات در میزانی که شرایط ترافیک را در محاسبه مسیر لحاظ می کنند، متفاوت هستند. هر اولویت مسیریابی نتایجی را تولید می کند که از نظر کیفیت مسیر، تخمین ETA و تأخیر پاسخ تا حدی متفاوت است.

شرایط ترافیکی سرعت جریان ترافیک را مشخص می کند. مثلا:

  • هنگامی که ازدحام وجود ندارد، شرایط ترافیکی عادی در نظر گرفته می شود و ترافیک با سرعت عادی بدون مانع جریان دارد.
  • با نزدیک شدن به ساعت شلوغی، تراکم ترافیک افزایش می‌یابد که باعث کاهش سرعت ترافیک و ایجاد شرایط ترافیکی سبک تا متوسط ​​می‌شود.
  • در ترافیک سپر به سپر، سرعت جریان متوقف می شود و شرایط ترافیکی سنگینی ایجاد می کند.

ترافیک بی خبر

وقتی اولویت مسیریابی TRAFFIC_UNAWARE را تنظیم می کنید، مسیرها بدون در نظر گرفتن شرایط ترافیک فعلی محاسبه می شوند. این اولویت مسیریابی کمترین تأخیر پاسخ را ارائه می‌کند (پاسخ‌ها سریع‌ترین زمان را برمی‌گردانند).

TRAFFIC_UNAWARE تنظیم پیش فرض است.

در پاسخ:

  • ETA در ویژگی پاسخ duration موجود است.

  • ویژگی‌های پاسخ duration و staticDuration دارای یک مقدار هستند.

از این اولویت مسیریابی زمانی استفاده کنید که می‌خواهید سریع‌ترین پاسخ‌ها را دریافت کنید و جزئیات مسیریابی تقریبی به اندازه کافی خوب هستند.

آگاه از ترافیک

هنگامی که اولویت مسیریابی TRAFFIC_AWARE را تنظیم می کنید، مسیرها برای شرایط ترافیک فعلی محاسبه می شوند. در نتیجه، جزئیات مسیر و مسیر با دقت بیشتری شرایط دنیای واقعی را منعکس می کنند. از آنجایی که این افزایش در کیفیت داده ها به قیمت تاخیر پاسخ تمام می شود، بهینه سازی عملکرد برای کاهش بسیاری از تاخیر اعمال می شود.

در پاسخ:

  • ETA که ترافیک بلادرنگ را در نظر می گیرد در ویژگی پاسخ duration موجود است.

  • ویژگی پاسخ staticDuration شامل مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی است.

وقتی می‌خواهید جزئیات مسیریابی دقیق‌تری نسبت به TRAFFIC_UNAWARE می‌خواهید، از این اولویت مسیریابی استفاده کنید، و با این حال برایتان مهم نیست که پاسخ‌ها با افزایش متوسط ​​تأخیر برگردانده شوند.

ترافیک آگاه بهینه

وقتی اولویت مسیریابی TRAFFIC_AWARE_OPTIMAL را تنظیم می‌کنید، مسیرها برای شرایط ترافیک فعلی محاسبه می‌شوند، اما هیچ بهینه‌سازی عملکردی اعمال نمی‌شود. در این حالت سرور جستجوی جامع تری در شبکه جاده ها انجام می دهد تا مسیر بهینه را پیدا کند.

اولویت مسیریابی TRAFFIC_AWARE_OPTIMAL معادل حالتی است که maps.google.com و برنامه تلفن همراه Google Maps استفاده می کند.

هنگام استفاده از این گزینه با Compute Route Matrix، تعداد عناصر در یک درخواست (تعداد مبدا × تعداد مقصد) نمی تواند از 100 تجاوز کند. برای اطلاعات بیشتر در مورد محدودیت های محاسبه مسیر ماتریس، به محاسبه ماتریس مسیر مراجعه کنید.

در پاسخ:

  • ETA که ترافیک بلادرنگ را در نظر می گیرد در ویژگی پاسخ duration موجود است.

  • ویژگی پاسخ staticDuration شامل مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی است.

این اولویت مسیریابی بالاترین تأخیر پاسخ را فراهم می کند (یعنی پاسخ ها با طولانی ترین تأخیر برمی گردند). از این اولویت مسیریابی زمانی استفاده کنید که می‌خواهید نتایجی با بالاترین کیفیت داشته باشید، بدون توجه به مدت زمان پاسخ‌ها.

تأثیر تنظیم زمان حرکت

شما به صورت اختیاری از ویژگی departureTime برای تنظیم زمان حرکت برای یک سفر استفاده می کنید. اگر ویژگی departureTime را تنظیم نکنید، به طور پیش‌فرض روی زمانی است که درخواست را انجام می‌دهید.

  • برای TRAFFIC_UNAWARE ، نمی‌توانید departureTime تنظیم کنید، زیرا انتخاب مسیر و مدت زمان بر اساس شبکه جاده‌ای و میانگین شرایط ترافیکی مستقل از زمان است.

  • برای TRAFFIC_AWARE و TRAFFIC_AWARE_OPTIMAL که شرایط ترافیک زنده را در نظر می‌گیرند، هرچه departureTime به زمان حال نزدیک‌تر باشد، ترافیک زنده اهمیت بیشتری پیدا می‌کند. هرچه زمان حرکت را در آینده دورتر تنظیم کنید، به شرایط ترافیکی تاریخی توجه بیشتری می شود.

به عنوان مثال تنظیم اولویت مسیریابی

کد 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"
}

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

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