RoutingParameters

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

نمایندگی JSON
{
  "origin": {
    object (LatLng)
  },
  "travelMode": enum (TravelMode),
  "routeModifiers": {
    object (RouteModifiers)
  },
  "routingPreference": enum (RoutingPreference)
}
فیلدها
origin

object ( LatLng )

اختیاری. یک مبدا مسیریابی صریح که مبدا تعریف شده در چند خط را لغو می کند. به طور پیش فرض، از مبدا چند خطی استفاده می شود.

travel Mode

enum ( TravelMode )

اختیاری. حالت سفر

route Modifiers

object ( RouteModifiers )

اختیاری. اصلاح کننده های مسیر

routing Preference

enum ( RoutingPreference )

اختیاری. نحوه محاسبه خلاصه های مسیریابی را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اولویت مسیریابی آگاه از ترافیک فقط برای DRIVE یا TWO_WHEELER travelMode در دسترس است.

حالت سفر

گزینه های حالت سفر این گزینه‌ها به آنچه Routes API ارائه می‌دهد، نشان می‌دهند.

Enums
TRAVEL_MODE_UNSPECIFIED حالت سفر مشخص نشده است. پیش‌فرض DRIVE است.
DRIVE با ماشین مسافربری سفر کنید.
BICYCLE با دوچرخه سفر کنید. با searchAlongRouteParameters پشتیبانی نمی شود.
WALK با پیاده روی سفر کنید. با searchAlongRouteParameters پشتیبانی نمی شود.
TWO_WHEELER انواع وسایل نقلیه موتوری دو چرخ مانند اسکوتر و موتورسیکلت. توجه داشته باشید که این حالت از حالت سفر BICYCLE که حمل و نقل با نیروی انسانی را پوشش می دهد متمایز است. با searchAlongRouteParameters پشتیبانی نمی شود. فقط در کشورهایی که در فهرست کشورها و مناطقی که برای وسایل نقلیه دو چرخ پشتیبانی می شوند، پشتیبانی می شود.

RouteModifiers

مجموعه ای از شرایط اختیاری را در بر می گیرد تا هنگام محاسبه مسیرها برآورده شوند.

نمایندگی JSON
{
  "avoidTolls": boolean,
  "avoidHighways": boolean,
  "avoidFerries": boolean,
  "avoidIndoor": boolean
}
فیلدها
avoid Tolls

boolean

اختیاری. وقتی روی true تنظیم شود، در صورت معقول بودن از جاده‌های عوارضی اجتناب می‌کند و به مسیرهایی که شامل جاده‌های عوارضی نیستند، ترجیح می‌دهد. فقط برای DRIVE و TWO_WHEELER TravelMode اعمال می شود.

avoid Highways

boolean

اختیاری. وقتی روی true تنظیم شود، از بزرگراه‌هایی که معقول باشد اجتناب می‌کند و به مسیرهایی که شامل بزرگراه نیستند ترجیح می‌دهد. فقط برای DRIVE و TWO_WHEELER TravelMode اعمال می شود.

avoid Ferries

boolean

اختیاری. وقتی روی true تنظیم شود، در صورت معقول بودن از کشتی‌ها اجتناب می‌کند و به مسیرهایی که شامل کشتی نیستند ترجیح می‌دهد. فقط برای DRIVE و TWO_WHEELER TravelMode اعمال می شود.

avoid Indoor

boolean

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

RoutingPreference

مجموعه ای از مقادیر که فاکتورهایی را مشخص می کند که هنگام محاسبه مسیر باید در نظر گرفته شوند.

Enums
ROUTING_PREFERENCE_UNSPECIFIED هیچ اولویت مسیریابی مشخص نشده است. پیش‌فرض TRAFFIC_UNAWARE است.
TRAFFIC_UNAWARE مسیرها را بدون در نظر گرفتن شرایط ترافیکی زنده محاسبه می کند. مناسب زمانی که شرایط ترافیک مهم نیست یا قابل اجرا نیست. استفاده از این مقدار کمترین تاخیر را ایجاد می کند. توجه: برای TravelMode DRIVE و TWO_WHEELER ، مسیر و مدت زمان انتخاب شده بر اساس شبکه جاده و میانگین شرایط ترافیک مستقل از زمان است، نه شرایط فعلی جاده. در نتیجه، مسیرها ممکن است شامل جاده هایی باشد که به طور موقت بسته هستند. نتایج برای یک درخواست معین ممکن است در طول زمان به دلیل تغییرات در شبکه جاده‌ها، میانگین به‌روز شده شرایط ترافیکی و ماهیت توزیع‌شده خدمات متفاوت باشد. نتایج همچنین ممکن است بین مسیرهای تقریباً معادل در هر زمان یا فرکانس متفاوت باشد.
TRAFFIC_AWARE مسیرها را با در نظر گرفتن شرایط ترافیکی زنده محاسبه می کند. برخلاف TRAFFIC_AWARE_OPTIMAL ، برخی بهینه‌سازی‌ها برای کاهش قابل توجه تأخیر اعمال می‌شوند.
TRAFFIC_AWARE_OPTIMAL مسیرها را با در نظر گرفتن شرایط ترافیکی زنده، بدون اعمال اکثر بهینه‌سازی‌های عملکرد، محاسبه می‌کند. استفاده از این مقدار بیشترین تاخیر را ایجاد می کند.