Route

کلاس مسیر

‫google.maps.routes.Route کلاس

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

با تماس با const {Route} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

روش‌های ایستا

computeRoutes

computeRoutes(request) پارامترها:  ‫request:  ComputeRoutesRequest مقدار برگشتی:  Promise<{   routes:Array<Route> optional,   fallbackInfo:FallbackInfo optional,   geocodingResults:GeocodingResults optional }> با داشتن مجموعه‌ای از نقطه‌مسیرهای پایانی و میانی، مسیر اصلی را به‌همراه مسیرهای جایگزین اختیاری برمی‌گرداند. توجه: این روش مستلزم آن است که با تنظیم کردن ویژگی ComputeRoutesRequest.fields، ماسک فیلد پاسخ را در درخواست مشخص کنید. مقدار، فهرستی از مسیرهای فیلد است. برای مثال: پوشش فیلد همه فیلدهای دردسترس: fields: ['*'] پوشش فیلد مدت، فاصله، و مسیر در سطح «مسیر»: fields: ['durationMillis', 'distanceMeters', 'path'] استفاده از پوشش فیلد پاسخ عام fields: ['*'] توصیه نمی‌شود زیرا: انتخاب کردن فقط فیلدهایی که نیاز دارید به سرور ما کمک می‌کند چرخه‌های محاسباتی را ذخیره کند و به ما امکان می‌دهد نتیجه را با تأخیر کمتری به شما برگردانیم. انتخاب کردن فقط فیلدهایی که در کار تولیدتان نیاز دارید عملکرد تأخیر پایداری را تضمین می‌کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسباتی بیشتری نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدها را در سطح بالا انتخاب کنید، ممکن است با کاهش عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه می‌کنیم به‌طور خودکار در پاسخ گنجانده می‌شود. انتخاب فقط فیلدهایی که نیاز دارید منجر به اندازه پاسخ کوچک‌تر و درنتیجه بارگیری سریع‌تر در شبکه می‌شود.

مشخصات
description	نوع:  string optional شرح مسیر.
distanceMeters	نوع:  number optional مسافت سفر در مسیر، به متر.
durationMillis	نوع:  number optional مدت زمان لازم برای پیمایش مسیر برحسب میلی‌ثانیه. اگر ComputeRoutesRequest.routingPreference را روی TRAFFIC_UNAWARE تنظیم کنید، این مقدار با Route.staticDurationMillis یکسان خواهد بود. اگر ComputeRoutesRequest.routingPreference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کنید، این مقدار با درنظر گرفتن شرایط ترافیک محاسبه می‌شود. توجه: اگر مدت‌زمان از ۲^۵۳ میلی‌ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
legs	نوع:  Array<RouteLeg> optional مجموعه‌ای از بخش‌ها (بخش‌های مسیر بین نقطه‌مسیرها) که مسیر را تشکیل می‌دهند. هر بخش مربوط به سفر بین دو نقطه‌مسیر غیرvia است. برای مثال: مسیری که نقطه‌مسیر میانی ندارد فقط یک بخش دارد. مسیری که شامل یک نقطه‌مسیر میانی غیرvia باشد، دو بخش دارد. مسیری که شامل یک نقطه‌مسیر میانی via باشد، یک بخش دارد. ترتیب بخش‌ها با ترتیب نقطه‌مسیرها از origin به intermediates به destination مطابقت دارد.
localizedValues	نوع:  RouteLocalizedValues optional نمایش‌های نوشتاری ویژگی‌های Route.
optimizedIntermediateWaypointIndices	نوع:  Array<number> optional اگر ComputeRoutesRequest.optimizeWaypointOrder را روی true تنظیم کنید، این فیلد حاوی ترتیب بهینه‌شده نقاط‌مسیر میانی است. درغیراین‌صورت، این فیلد خالی است. نمایه با ۰ برای اولین نقطه‌مسیر میانی ارائه‌شده در ورودی شروع می‌شود. برای مثال، اگر این ورودی را ارائه دهید: مبدأ: LA نقطه‌مسیرهای میانی: دالاس، بنگور، فینیکس مقصد: نیویورک و ترتیب بهینه‌شده نقطه‌مسیرهای میانی فینیکس، دالاس، بنگور باشد، این فیلد [2, 0, 1] خواهد بود.
path	نوع:  Array<LatLngAltitude> optional فهرست LatLngAltitudeهای مسیر که می‌توان از آن برای ترسیم چندخطی مسیر استفاده کرد. دقت مسیر را می‌توان با تنظیم ComputeRoutesRequest.polylineQuality کنترل کرد.
polylineDetails	نوع:  PolylineDetails optional حاوی اطلاعاتی درباره جزئیات مسیر است.
routeLabels	نوع:  Array<RouteLabel> optional برچسب‌های مسیر که برای شناسایی ویژگی‌های خاص یا مقایسه با دیگران مفید هستند.
routeToken	نوع:  string optional یک توکن مات که می‌تواند به Navigation SDK منتقل شود تا مسیر را درطول ناوبری بازسازی کند و درصورت تغییر مسیر، به هدف اصلی هنگام ایجاد مسیر احترام بگذارد. این کد را به‌عنوان یک حباب مات درنظر بگیرید. مقدار آن را در درخواست‌ها مقایسه نکنید زیرا ممکن است مقدار آن تغییر کند حتی اگر سرویس دقیقاً همان مسیر را برگرداند. توجه: routeToken فقط برای درخواست‌هایی دردسترس است که ComputeRoutesRequest.routingPreference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کرده باشند. این ویژگی برای درخواست‌هایی که via نقطه‌مسیر دارند پشتیبانی نمی‌شود.
speedPaths	نوع:  Array<SpeedPath> optional گروه‌بندی بخش‌های مسیر با خواندن سرعت مربوط به آن‌ها. برای پر شدن این فیلد، ComputeRoutesRequest.routingPreference باید روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم شود و ComputeRoutesRequest.extraComputations باید شامل TRAFFIC_ON_POLYLINE باشد.
staticDurationMillis	نوع:  number optional مدت زمان سفر در مسیر بدون درنظر گرفتن شرایط ترافیک. توجه: اگر مدت‌زمان از ۲^۵۳ میلی‌ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
travelAdvisory	نوع:  RouteTravelAdvisory optional اطلاعات بیشتر درباره مسیر.
viewport	نوع:  LatLngBounds optional جعبه مرزی ناحیه نمایش مسیر.
warnings	نوع:  Array<string> optional آرایه‌ای از هشدارها برای نمایش هنگام نشان دادن مسیر.

روش‌ها
createPolylines	createPolylines([options]) پارامترها:  ‫options:  RoutePolylineOptions optional مقدار برگشتی:  Array<Polyline> چندخطی‌هایی برای مسیر براساس داده‌های دردسترس ایجاد می‌کند. چندخطی‌های چندحالتی: پیش‌نیازها: فیلدهای "path" و "legs" باید در ComputeRoutesRequest.fields درخواست شوند ‫ComputeRoutesRequest.travelMode باید روی TRANSIT تنظیم شود. برای هر بخش مسیر چندحالته، یک چندخطی ایجاد می‌کند. چندخطی‌ها براساس حالت سفر بخش و داده‌های خط حمل‌ونقل عمومی (درصورت دردسترس بودن) سبک‌بندی می‌شوند. گزینه‌ها را می‌توان برای تغییر سبک چندخطی براساس حالت سفر و خط حمل‌ونقل عمومی ارسال کرد. چندخطی‌های ترافیک: پیش‌نیازها: فیلدهای "path" و "travelAdvisory" (یا فقط "speedPaths" به‌عنوان خلاصه) باید در ComputeRoutesRequest.fields درخواست شوند. ‫ComputeRoutesRequest.routingPreference باید روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم شود. ComputeRoutesRequest.extraComputations باید شامل TRAFFIC_ON_POLYLINE باشد. وقتی خوانش سرعت با فاصله زمانی قبلی متفاوت باشد، برای هر فاصله زمانی مسیر یک چندخطی ایجاد می‌کند. چندخطی‌ها دارای سبک پیش‌فرض مبتنی بر سرعت هستند. می‌توان گزینه‌هایی را برای تغییر سبک چندخطی براساس سرعت ارسال کرد. چندخطی کلی: پیش‌نیازها: فیلد "path" یا "legs" باید در ComputeRoutesRequest.fields درخواست شود. یک چندخطی واحد برای کل مسیر با اعمال سبک‌پردازی پیش‌فرض ایجاد می‌کند. می‌توان گزینه‌هایی را برای تغییر سبک چندخطی براساس حالت سفر در مسیر ارسال کرد. برای سفارشی‌سازی بیشتر، چندخطی‌ها را مستقیماً بااستفاده از Route.path یا RouteLeg.path ایجاد کنید.
createWaypointAdvancedMarkers	createWaypointAdvancedMarkers([options]) پارامترها:  ‫options:  AdvancedMarkerElementOptions|(function(AdvancedMarkerElementOptions, WaypointMarkerDetails): AdvancedMarkerElementOptions) optional مقدار برگشتی:  Promise<Array<AdvancedMarkerElement>> نشانگرهایی برای مسیر با برچسب‌های «الف»، «ب»، «پ»، و غیره برای هر نقطه‌مسیر ایجاد می‌کند. سبک پیش‌فرض روی نشانگرها اعمال شده است. می‌توان گزینه‌هایی را برای تغییر سبک نشانگر براساس نمایه نشانگر یا ویژگی‌های RouteLeg مربوطه ارسال کرد. اگر مسیر فاقد بخش باشد، پارامتر WaypointMarkerDetails.leg تعریف‌نشده خواهد بود. فیلد "legs" باید در ComputeRoutesRequest.fields درخواست شود تا نقاط‌مسیر میانی اضافه شوند.
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

میانای ComputeRoutesRequest

میانا google.maps.routes.ComputeRoutesRequest

درخواست برای مسیرها.

مشخصات
destination	نوع:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint مقصد مسیر. مقداری که به‌عنوان رشته ارسال می‌شود می‌تواند نشانی، Plus Code، یا نام منبع «مکان» باشد. مقادیر ارتفاع برای محاسبه مسیرها درنظر گرفته نمی‌شود.
fields	نوع:  Iterable<string> مجموعه فیلدهایی که باید واکشی شوند. ["*"] را برای همه فیلدها مشخص کنید.
origin	نوع:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint مبدأ مسیر. مقداری که به‌عنوان رشته ارسال می‌شود می‌تواند نشانی، Plus Code، یا نام منبع «مکان» باشد. مقادیر ارتفاع برای محاسبه مسیرها درنظر گرفته نمی‌شود.
arrivalTime optional	نوع:  Date optional زمان رسیدن. توجه: فقط زمانی می‌توان تنظیم کرد که ComputeRoutesRequest.travelMode روی TRANSIT تنظیم شده باشد. می‌توانید ComputeRoutesRequest.departureTime یا ComputeRoutesRequest.arrivalTime را مشخص کنید، اما نه هر دو را. سفرهای حمل‌ونقل عمومی برای حداکثر ۷ روز گذشته یا ۱۰۰ روز آینده دردسترس است.
computeAlternativeRoutes optional	نوع:  boolean optional مشخص می‌کند که آیا مسیرهای جایگزین علاوه‌بر مسیر اصلی محاسبه شوند یا نه. برای درخواست‌هایی که نقطه‌مسیرهای میانی دارند، هیچ مسیر جایگزینی برگردانده نمی‌شود.
departureTime optional	نوع:  Date optional زمان حرکت. اگر این مقدار را تنظیم نکنید، این مقدار به‌طور پیش‌فرض روی زمانی که درخواست را ارسال کرده‌اید تنظیم می‌شود. توجه: فقط زمانی می‌توانید زمان را در گذشته مشخص کنید که ComputeRoutesRequest.travelMode روی TRANSIT تنظیم شده باشد. سفرهای حمل‌ونقل عمومی برای حداکثر ۷ روز گذشته یا ۱۰۰ روز آینده دردسترس است.
extraComputations optional	نوع:  Iterable<ComputeRoutesExtraComputation> optional فهرستی از محاسبات اضافی که ممکن است برای تکمیل درخواست استفاده شود. توجه: این محاسبات اضافی ممکن است فیلدهای اضافی را در پاسخ برگرداند. این فیلدهای اضافی باید در ComputeRoutesRequest.fields نیز مشخص شوند تا در پاسخ برگردانده شوند.
intermediates optional	نوع:  Iterable<Waypoint> optional مجموعه‌ای از نقطه‌مسیرها درطول مسیر (به‌استثنای نقاط پایانه)، برای توقف یا عبور. حداکثر ۲۵ نقطه‌مسیر میانی پشتیبانی می‌شود.
language optional	نوع:  string optional کد زبان BCP-47، مانند «en-US» یا «sr-Latn». برای اطلاعات بیشتر، شناسه محلی یونیکد را ببینید. برای مشاهده فهرست زبان‌های پشتیبانی‌شده، به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی‌دهید، زبان از تنظیمات بومی‌سازی Google Maps JavaScript API شما استنباط می‌شود. درغیراین‌صورت، زبان از مکان مبدأ استنباط می‌شود.
optimizeWaypointOrder optional	نوع:  boolean optional اگر روی «درست» تنظیم شود، سرویس تلاش می‌کند با تغییر ترتیب نقطه‌مسیرهای میانی مشخص‌شده، هزینه کلی مسیر را به حداقل برساند. اگر هرکدام از نقطه‌مسیرهای میانی از نوع نقطه‌مسیر گذری باشد، درخواست ناموفق خواهد بود. برای پیدا کردن ترتیب جدید، از Route.optimizedIntermediateWaypointIndices در پاسخ استفاده کنید. اگر "optimizedIntermediateWaypointIndices" در ComputeRoutesRequest.fields درخواست نشود، درخواست ناموفق خواهد بود. اگر روی «نادرست» تنظیم شود، Route.optimizedIntermediateWaypointIndices در پاسخ خالی خواهد بود.
polylineQuality optional	نوع:  PolylineQuality optional اولویت کیفیت چندخطی را مشخص می‌کند.
region optional	نوع:  string optional کد منطقه، که به‌عنوان مقدار دو نویسه‌ای ccTLD («دامنه سطح بالا») مشخص شده است. برای اطلاعات بیشتر، دامنه‌های سطح بالای کد کشور را ببینید. وقتی این مقدار را ارائه نمی‌دهید، منطقه از تنظیمات بومی‌سازی Google Maps JavaScript API شما استنباط می‌شود. درغیراین‌صورت، منطقه از مکان مبدأ استنباط می‌شود.
requestedReferenceRoutes optional	نوع:  Iterable<ReferenceRoute> optional مشخص می‌کند که علاوه‌بر مسیر پیش‌فرض، چه مسیرهای مرجعی به‌عنوان بخشی از درخواست محاسبه شود. مسیر مرجع مسیری است که هدف محاسبه آن با مسیر پیش‌فرض متفاوت است. برای مثال، محاسبه مسیر مرجع FUEL_EFFICIENT پارامترهای مختلفی را درنظر می‌گیرد که مسیر بهینه با مصرف سوخت بهینه را ایجاد می‌کند. هنگام استفاده از این ویژگی، به‌دنبال Route.routeLabels در مسیرهای حاصل بگردید.
routeModifiers optional	نوع:  RouteModifiers optional مجموعه‌ای از شرایط که باید برآورده شوند و بر نحوه محاسبه مسیرها تأثیر می‌گذارند. برای مثال، می‌توانید ویژگی‌هایی را که می‌خواهید از آن‌ها اجتناب شود مشخص کنید، مثل جاده‌های عوارضی یا بزرگراه‌ها.
routingPreference optional	نوع:  RoutingPreference optional نحوه محاسبه مسیر را مشخص می‌کند. سرور تلاش می‌کند از اولویت مسیریابی انتخاب‌شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تأخیر بسیار طولانی شود، خطا برگردانده می‌شود. این گزینه را فقط وقتی می‌توانید مشخص کنید که ComputeRoutesRequest.travelMode روی DRIVING یا TWO_WHEELER باشد، درغیراین‌صورت درخواست ناموفق خواهد بود.
trafficModel optional	نوع:  TrafficModel optional فرض‌های مورد استفاده هنگام محاسبه زمان در ترافیک را مشخص می‌کند. این تنظیم بر مقدار Route.durationMillis و RouteLeg.durationMillis که حاوی زمان پیش‌بینی‌شده در ترافیک براساس میانگین‌های تاریخی است تأثیر می‌گذارد. ‫ComputeRoutesRequest.trafficModel فقط برای درخواست‌هایی دردسترس است که ComputeRoutesRequest.routingPreference را روی TRAFFIC_AWARE_OPTIMAL و ComputeRoutesRequest.travelMode را روی DRIVING تنظیم کرده باشند. پیش‌فرض‌ها به BEST_GUESS.
transitPreference optional	نوع:  TransitPreference optional اولویت‌هایی را مشخص می‌کند که بر مسیر برگردانده‌شده برای مسیرهای TRANSIT تأثیر می‌گذارد. توجه: فقط زمانی می‌توان مشخص کرد که ComputeRoutesRequest.travelMode روی TRANSIT تنظیم شده باشد.
travelMode optional	نوع:  TravelMode optional حالت حمل‌ونقل را مشخص می‌کند.
units optional	نوع:  UnitSystem optional واحدهای اندازه‌گیری را برای فیلدهای نمایش، مانند دستورالعمل‌های پیمایش، مشخص می‌کند. واحدهای اندازه‌گیری استفاده‌شده برای مسیر، بخش، فاصله گام، و مدت تحت‌تأثیر این مقدار قرار نمی‌گیرند. اگر این مقدار را ارائه نکنید، واحدهای نمایش از مکان مبدأ استنباط می‌شود.

ثابت‌های ComputeRoutesExtraComputation

google.maps.routes.ComputeRoutesExtraComputation یادآور همیشگی

محاسبات اضافی برای انجام درخواست Route.computeRoutes.

با تماس با const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
FLYOVER_INFO_ON_POLYLINE	اطلاعات پرواز بر فراز مسیر(ها). برای برگرداندن این اطلاعات، فیلد "polylineDetails" باید در ComputeRoutesRequest.fields مشخص شود. درحال‌حاضر این داده‌ها فقط برای برخی‌از شهرهای هند پر می‌شود. این ویژگی آزمایشی است و SKU/هزینه ممکن است تغییر کند.
FUEL_CONSUMPTION	مصرف سوخت تخمینی برای مسیر(ها).
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS	دستورالعمل‌های ناوبری به‌صورت رشته نوشتاری HTML قالب‌بندی‌شده ارائه می‌شود. این محتوا باید همان‌طور که هست خوانده شود و فقط برای نمایش است. آن را به‌صورت برنامه‌نویسی تجزیه نکنید.
NARROW_ROAD_INFO_ON_POLYLINE	اطلاعات جاده باریک برای مسیر(ها). برای برگرداندن این اطلاعات، فیلد "polylineDetails" باید در ComputeRoutesRequest.fields مشخص شود. درحال‌حاضر این داده‌ها فقط برای برخی‌از شهرهای هند پر می‌شود. این ویژگی آزمایشی است و SKU/هزینه ممکن است تغییر کند.
TOLLS	اطلاعات عوارض برای مسیر(ها).
TRAFFIC_ON_POLYLINE	چندخطی‌های آگاه از ترافیک برای مسیر(ها).

DirectionalLocationLiteral میانجی

میانا google.maps.routes.DirectionalLocationLiteral

راستین‌نمادهای شیء به‌جای نمونه‌های DirectionalLocation برای راحتی پذیرفته می‌شوند. وقتی Maps JS API با این موارد مواجه می‌شود، آن‌ها را به DirectionalLocation تبدیل می‌کند.

این میانای گسترش‌یافته LatLngAltitudeLiteral.

مشخصات
heading optional	نوع:  number optional جهت قطب‌نما مربوط به جهت جریان ترافیک. مقادیر جهت می‌توانند اعدادی از ۰ تا ۳۶۰ باشند، که ۰ جهت شمال واقعی، ۹۰ جهت شرق واقعی، و غیره را مشخص می‌کند. از این فیلد فقط برای DRIVING و TWO_WHEELER ComputeRoutesRequest.travelMode می‌توانید استفاده کنید.
به‌ارث‌رسیده: altitude، lat، lng

کلاس DirectionalLocation

‫google.maps.routes.DirectionalLocation کلاس

یک نقطه جغرافیایی و یک عنوان اختیاری را دربرمی‌گیرد.

این کلاس LatLngAltitude را گسترش می‌دهد.

این کلاس DirectionalLocationLiteral را پیاده‌سازی می‌کند.

با تماس با const {DirectionalLocation} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

سازنده
از سازمان بالاتر: LatLngAltitude

مشخصات
heading	نوع:  number optional جهت قطب‌نما مربوط به جهت جریان ترافیک. مقادیر جهت می‌توانند اعدادی از ۰ تا ۳۶۰ باشند، که ۰ جهت شمال واقعی، ۹۰ جهت شرق واقعی، و غیره را مشخص می‌کند. از این فیلد فقط برای DRIVING و TWO_WHEELER ComputeRoutesRequest.travelMode می‌توانید استفاده کنید.
به‌ارث‌رسیده: altitude، lat، lng

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  DirectionalLocationLiteral به شیء تبدیل می‌کند.
از سازمان بالاتر: equals

FallbackInfo کلاس

‫google.maps.routes.FallbackInfo کلاس

اطلاعات مربوط به نحوه و دلیل استفاده از نتیجه جایگزین در پاسخ Route.computeRoutes. اگر این فیلد تنظیم شده باشد، به این معنی است که سرور از حالت مسیریابی متفاوتی نسبت به حالت ترجیحی شما به‌عنوان جایگزین استفاده کرده است.

با تماس با const {FallbackInfo} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
reason	نوع:  FallbackReason optional دلیل استفاده از پاسخ جایگزین به‌جای پاسخ اصلی. این فیلد فقط زمانی پر می‌شود که حالت بازگشت فعال شود و پاسخ بازگشت برگردانده شود.
routingMode	نوع:  FallbackRoutingMode optional حالت مسیریابی استفاده‌شده برای پاسخ. اگر بازگشت راه‌اندازی شده باشد، ممکن است حالت با اولویت مسیریابی تنظیم‌شده در درخواست مشتری اصلی متفاوت باشد.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

ثابت‌های FallbackReason

google.maps.routes.FallbackReason یادآور همیشگی

دلیل اینکه پاسخ جایگزین در پاسخ Route.computeRoutes برگردانده شد.

با تماس با const {FallbackReason} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
LATENCY_EXCEEDED	نتوانستیم محاسبه را با حالت مسیریابی ترجیحی شما به‌موقع تمام کنیم، اما توانستیم نتیجه محاسبه‌شده با حالت جایگزین را برگردانیم.
SERVER_ERROR	هنگام محاسبه مسیرها با حالت مسیریابی ترجیحی شما، خطای سرور رخ داد، اما توانستیم نتیجه محاسبه‌شده با حالت جایگزین را برگردانیم.

ثابت‌های FallbackRoutingMode

google.maps.routes.FallbackRoutingMode یادآور همیشگی

حالت مسیریابی واقعی که هنگام برگرداندن پاسخ بازگشتی در پاسخ Route.computeRoutes استفاده می‌شود.

با تماس با const {FallbackRoutingMode} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
TRAFFIC_AWARE	نشان می‌دهد که از TRAFFIC_AWARE RoutingPreference برای محاسبه پاسخ استفاده شده است.
TRAFFIC_UNAWARE	نشان می‌دهد که از TRAFFIC_UNAWARE RoutingPreference برای محاسبه پاسخ استفاده شده است.

کلاس GeocodedWaypoint

‫google.maps.routes.GeocodedWaypoint کلاس

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

با تماس با const {GeocodedWaypoint} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
geocoderStatus	نوع:  RPCStatus optional رمز وضعیت حاصل از عملیات زمین‌کدیابی را نشان می‌دهد.
intermediateWaypointRequestIndex	نوع:  number optional شاخص نقطه‌مسیر میانی مربوطه در درخواست. فقط درصورتی درج می‌شود که نقطه‌مسیر مربوطه نقطه‌مسیر میانی باشد.
partialMatch	نوع:  boolean نشان می‌دهد که زمین‌کدیاب برای درخواست اصلی مطابقت دقیقی برنگردانده است، هرچند توانسته است بخشی از نشانی درخواست‌شده را مطابقت دهد. شاید بخواهید درخواست اصلی را ازنظر غلط املایی و/یا نشانی ناقص بررسی کنید.
placeId	نوع:  string شناسه مکان برای این نتیجه.
types	نوع:  Array<string> نوع(انواع) نتیجه، به‌صورت صفر یا چند برچسب نوع. برای انواع پشتیبانی‌شده، https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types را ببینید.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

GeocodingResults کلاس

‫google.maps.routes.GeocodingResults کلاس

حاوی GeocodedWaypoints برای مبدأ، مقصد، و نقاط‌مسیر میانی است. فقط برای نقاط‌مسیر نشانی درج می‌شود.

با تماس با const {GeocodingResults} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
destination	نوع:  GeocodedWaypoint optional نقطه‌مسیر زمین‌کدیابی‌شده برای مقصد.
intermediates	نوع:  Array<GeocodedWaypoint> optional فهرستی از نقطه‌مسیرهای زمین‌کدیابی‌شده میانی که هرکدام حاوی فیلد نمایه‌ای است که با موقعیت نقطه‌مسیر در ترتیب مشخص‌شده در درخواست مطابقت دارد (موقعیت‌ها از صفر شروع می‌شوند).
origin	نوع:  GeocodedWaypoint optional نقطه‌مسیر زمین‌کدیابی‌شده برای مبدأ.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

کلاس MultiModalSegment

‫google.maps.routes.MultiModalSegment کلاس

اطلاعات خلاصه‌شده‌ای درباره بخش چندحالتی RouteLeg.steps مسیر ارائه می‌دهد. بخش چندحالتی به‌عنوان یک یا چند RouteLegStep مجاور تعریف می‌شود که TravelMode یکسانی دارند.

با تماس با const {MultiModalSegment} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
instructions	نوع:  string optional دستورالعمل‌های پیمایش این بخش چندحالتی.
maneuver	نوع:  string optional مانور ناوبری که باید در این مرحله انجام شود. برای مشاهده فهرست مقادیر ممکن، مانور را ببینید.
stepEndIndex	نوع:  number نمایه RouteLegStep مربوطه که پایان بخش چندحالتی است.
stepStartIndex	نوع:  number نمایه RouteLegStep مربوطه که شروع بخش چندحالتی است.
travelMode	نوع:  TravelMode optional حالت سفر استفاده‌شده برای این بخش چندحالته.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

کلاس PolylineDetailInfo

‫google.maps.routes.PolylineDetailInfo کلاس

اطلاعات مربوط به عارضه جاده را در امتداد یک چندخطی کپسوله‌سازی می‌کند.

با تماس با const {PolylineDetailInfo} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
endIndex	نوع:  number optional نمایه پایانی این عارضه جاده در چندخطی.
presence	نوع:  RoadFeatureState optional نشان می‌دهد که آیا عارضه جاده درطول چندخطی وجود دارد یا نه.
startIndex	نوع:  number optional نمایه شروع این عارضه جاده در چندخطی.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

کلاس PolylineDetails

‫google.maps.routes.PolylineDetails کلاس

جزئیات مربوط به نمایه یا بخش مجاور چندخطی. با داشتن چندخطی با نقاط P_0،‏ P_1،‏ ...،‏ P_N (نمایه با مبنای صفر)، PolylineDetails ویژگی جاده را برای بازه مشخصی توصیف می‌کند.

با تماس با const {PolylineDetails} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
flyoverInfo	نوع:  Array<PolylineDetailInfo> جزئیات پرواز در امتداد چندخطی.
narrowRoadInfo	نوع:  Array<PolylineDetailInfo> جزئیات جاده باریک درطول چندخطی.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

ثابت‌های PolylineQuality

google.maps.routes.PolylineQuality یادآور همیشگی

کیفیت چندخطی را مشخص می‌کند.

با تماس با const {PolylineQuality} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
HIGH_QUALITY	چندخطی با کیفیت بالایی را مشخص می‌کند که بااستفاده از بیش‌از OVERVIEW نقطه تشکیل شده است و هزینه آن افزایش اندازه پاسخ است. وقتی به دقت بیشتری نیاز دارید، از این مقدار استفاده کنید.
OVERVIEW	چندخطی نمای کلی را که بااستفاده از تعداد کمی نقطه تشکیل شده است مشخص می‌کند. استفاده از این گزینه در مقایسه با HIGH_QUALITY تأخیر درخواست کمتری دارد. هنگام نمایش نمای کلی مسیر، از این مقدار استفاده کنید.

ثابت‌های ReferenceRoute

google.maps.routes.ReferenceRoute یادآور همیشگی

مسیر مرجع پشتیبانی‌شده در ComputeRoutesRequest.

با تماس با const {ReferenceRoute} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
FUEL_EFFICIENT	مسیر با بهره‌وری سوخت.
SHORTER_DISTANCE	مسیر با مسافت سفر کوتاه‌تر.

ثابت‌های RoadFeatureState

google.maps.routes.RoadFeatureState یادآور همیشگی

وضعیت‌های ویژگی‌های جاده را درطول یک بخش چندخطی کپسوله‌سازی می‌کند.

با تماس با const {RoadFeatureState} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
DOES_NOT_EXIST	این عارضه جاده وجود ندارد.
EXISTS	ویژگی جاده وجود دارد.

ثابت‌های RouteLabel

google.maps.routes.RouteLabel یادآور همیشگی

برچسب‌های مسیر که برای شناسایی ویژگی‌های خاص برای مقایسه با دیگران مفید هستند.

با تماس با const {RouteLabel} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
DEFAULT_ROUTE	مسیر «بهترین» پیش‌فرض برای محاسبه مسیر برگردانده شد.
DEFAULT_ROUTE_ALTERNATE	جایگزینی برای مسیر «بهترین» پیش‌فرض. وقتی ComputeRoutesRequest.computeAlternativeRoutes مشخص شود، مسیرهایی مثل این برگردانده می‌شود.
FUEL_EFFICIENT	مسیر با بهره‌وری سوخت. مسیرهایی که با این مقدار برچسب‌گذاری شده‌اند برای پارامترهای زیست‌محیطی مانند مصرف سوخت بهینه‌سازی شده‌اند.
SHORTER_DISTANCE	مسیر با مسافت سفر کوتاه‌تر. این قابلیتی آزمایشی است.

کلاس RouteLeg

‫google.maps.routes.RouteLeg کلاس

حاوی بخشی بین نقاط‌مسیر غیرvia است.

با تماس با const {RouteLeg} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
distanceMeters	نوع:  number مسافت سفر بخش مسیر، به متر.
durationMillis	نوع:  number optional مدت زمان لازم برای پیمایش بخش مسیر برحسب میلی‌ثانیه. اگر ComputeRoutesRequest.routingPreference را روی TRAFFIC_UNAWARE تنظیم کنید، این مقدار با staticDurationMillis یکسان خواهد بود. اگر ComputeRoutesRequest.routingPreference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کنید، این مقدار با درنظر گرفتن شرایط ترافیک محاسبه می‌شود. توجه: اگر مدت‌زمان از ۲^۵۳ میلی‌ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
endLocation	نوع:  DirectionalLocation optional مکان پایان این بخش. این مکان ممکن است با ComputeRoutesRequest.destination متفاوت باشد. برای مثال، وقتی ComputeRoutesRequest.destination نزدیک جاده نیست، این نقطه روی جاده است.
localizedValues	نوع:  RouteLegLocalizedValues optional نمایش‌های نوشتاری ویژگی‌های RouteLeg.
path	نوع:  Array<LatLngAltitude> فهرست LatLngAltitudeهای بخش مسیر که می‌توان از آن برای ترسیم چندخطی بخش مسیر استفاده کرد. دقت مسیر را می‌توان با تنظیم ComputeRoutesRequest.polylineQuality کنترل کرد.
speedPaths	نوع:  Array<SpeedPath> گروه‌بندی بخش‌های مسیر مرحله با خواندن سرعت مربوطه. برای پر شدن این فیلد، ComputeRoutesRequest.routingPreference باید روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم شود و ComputeRoutesRequest.extraComputations باید شامل TRAFFIC_ON_POLYLINE باشد.
startLocation	نوع:  DirectionalLocation optional مکان شروع این بخش. این مکان ممکن است با ComputeRoutesRequest.origin متفاوت باشد. برای مثال، وقتی ComputeRoutesRequest.origin نزدیک جاده نیست، این نقطه روی جاده است.
staticDurationMillis	نوع:  number optional مدت سفر در بخش بدون درنظر گرفتن شرایط ترافیک. توجه: اگر مدت‌زمان از ۲^۵۳ میلی‌ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
steps	نوع:  Array<RouteLegStep> آرایه‌ای از مراحل که بخش‌های درون این مسیر را نشان می‌دهد. هر مرحله نشان‌دهنده یک دستورالعمل ناوبری است.
stepsOverview	نوع:  StepsOverview optional اطلاعات کلی درباره مراحل این RouteLeg. این فیلد فقط برای مسیرهای TRANSIT پر می‌شود.
travelAdvisory	نوع:  RouteLegTravelAdvisory optional حاوی اطلاعات تکمیلی است که کاربر باید از آن‌ها مطلع شود، مثل محدودیت‌های احتمالی منطقه ترافیکی در یک بخش مسیر.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

RouteLegLocalizedValues کلاس

‫google.maps.routes.RouteLegLocalizedValues کلاس

نمایش نوشتاری RouteLeg.

با تماس با const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
distance	نوع:  string optional مسافت سفر بخش مسیر به‌صورت نوشتاری.
distanceLanguage	نوع:  string optional کد زبان BCP-47 نوشتار فاصله، مانند «en-US» یا «sr-Latn». برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید.
duration	نوع:  string optional مدت، به‌صورت نوشتاری و بومی‌سازی‌شده برای منطقه پُرسمان نشان داده می‌شود. شرایط ترافیک را درنظر می‌گیرد.
durationLanguage	نوع:  string optional کد زبان BCP-47 نوشتار مدت، مانند «en-US» یا «sr-Latn». برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید.
staticDuration	نوع:  string optional مدت‌زمان بدون درنظر گرفتن شرایط ترافیک، که به‌صورت نوشتاری نشان داده می‌شود.
staticDurationLanguage	نوع:  string optional کد زبان BCP-47 نوشتار مدت‌زمان ایستا، مانند «en-US» یا «sr-Latn».

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

کلاس RouteLegStep

‫google.maps.routes.RouteLegStep کلاس

حاوی بخشی از RouteLeg است. هر مرحله مربوط به یک دستورالعمل ناوبری است. بخش‌های مسیر از مراحل تشکیل شده‌اند.

با تماس با const {RouteLegStep} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
distanceMeters	نوع:  number مسافت سفر این مرحله، به متر.
endLocation	نوع:  DirectionalLocation optional مکان پایان این مرحله.
instructions	نوع:  string optional دستورالعمل‌های پیمایش این مرحله.
localizedValues	نوع:  RouteLegStepLocalizedValues optional نمایش‌های نوشتاری ویژگی‌های RouteLegStep.
maneuver	نوع:  string optional مانور ناوبری که باید در این مرحله انجام شود. برای مشاهده فهرست مقادیر ممکن، مانور را ببینید.
path	نوع:  Array<LatLngAltitude> فهرست LatLngAltitudeهای مرحله بخش مسیر که می‌توان از آن برای ترسیم چندخطی مرحله بخش مسیر استفاده کرد. دقت مسیر را می‌توان با تنظیم ComputeRoutesRequest.polylineQuality کنترل کرد. فیلد "path" باید در ComputeRoutesRequest.fields درخواست شود تا این فیلد پر شود.
startLocation	نوع:  DirectionalLocation optional مکان شروع این مرحله.
staticDurationMillis	نوع:  number optional مدت زمان سفر در این مرحله بدون درنظر گرفتن شرایط ترافیک. توجه: اگر مدت‌زمان از ۲^۵۳ میلی‌ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
transitDetails	نوع:  TransitDetails optional جزئیات مربوط به این مرحله اگر حالت سفر TRANSIT باشد.
travelMode	نوع:  TravelMode optional حالت سفر استفاده‌شده برای این مرحله.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

RouteLegStepLocalizedValues کلاس

‫google.maps.routes.RouteLegStepLocalizedValues کلاس

نمایش‌های نوشتاری ویژگی‌های RouteLegStep.

با تماس با const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
distance	نوع:  string optional مسافت سفر مرحله بخش مسیر به‌صورت نوشتاری.
distanceLanguage	نوع:  string optional کد زبان BCP-47 نوشتار فاصله، مانند «en-US» یا «sr-Latn». برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید.
staticDuration	نوع:  string optional مدت‌زمان بدون درنظر گرفتن شرایط ترافیک، که به‌صورت نوشتاری نشان داده می‌شود.
staticDurationLanguage	نوع:  string optional کد زبان BCP-47 نوشتار مدت‌زمان ایستا، مانند «en-US» یا «sr-Latn». برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

کلاس RouteLegTravelAdvisory

‫google.maps.routes.RouteLegTravelAdvisory کلاس

حاوی اطلاعات بیشتری است که کاربر باید در RouteLeg از آن‌ها مطلع شود.

با تماس با const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
speedReadingIntervals	نوع:  Array<SpeedReadingInterval> optional فواصل خواندن سرعت که جزئیات تراکم ترافیک را نشان می‌دهد. قابل‌اجرا درصورت TRAFFIC_AWARE و TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. این فاصله‌ها کل چندخطی RouteLeg را بدون هم‌پوشانی پوشش می‌دهند. نقطه شروع یک بازه مشخص‌شده با نقطه پایان بازه قبلی یکسان است. مثال: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo	نوع:  TollInfo optional حاوی اطلاعاتی درباره عوارض در RouteLeg خاص است. این فیلد فقط درصورتی پر می‌شود که انتظار برود در RouteLeg عوارض وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما TollInfo.estimatedPrices پر نشده باشد، بخش مسیر شامل عوارض است اما قیمت تخمینی نامشخص است. اگر این فیلد خالی باشد، یعنی در RouteLeg عوارضی وجود ندارد.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

RouteLocalizedValues کلاس

‫google.maps.routes.RouteLocalizedValues کلاس

نمایش‌های نوشتاری ویژگی‌های Route.

با تماس با const {RouteLocalizedValues} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
distance	نوع:  string optional مسافت سفر مسیر به‌صورت نوشتاری نشان داده می‌شود.
distanceLanguage	نوع:  string optional کد زبان BCP-47 نوشتار فاصله، مانند «en-US» یا «sr-Latn». برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید.
duration	نوع:  string optional مدت، به‌صورت نوشتاری و بومی‌سازی‌شده برای منطقه پُرسمان نشان داده می‌شود. شرایط ترافیک را درنظر می‌گیرد. توجه: اگر اطلاعات ترافیک را درخواست نکرده باشید، این مقدار همان مقدار staticDuration است.
durationLanguage	نوع:  string optional کد زبان BCP-47 نوشتار مدت، مانند «en-US» یا «sr-Latn». برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید.
staticDuration	نوع:  string optional مدت‌زمان بدون درنظر گرفتن شرایط ترافیک، که به‌صورت نوشتاری نشان داده می‌شود.
staticDurationLanguage	نوع:  string optional کد زبان BCP-47 نوشتار مدت‌زمان ایستا، مانند «en-US» یا «sr-Latn».
transitFare	نوع:  string optional کرایه حمل‌ونقل عمومی به‌صورت نوشتاری نشان داده می‌شود.
transitFareLanguage	نوع:  string optional کد زبان BCP-47 نوشتار کرایه حمل‌ونقل عمومی، مثل «en-US» یا «sr-Latn».

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

میانای RouteModifiers

میانا google.maps.routes.RouteModifiers

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

مشخصات
avoidFerries optional	نوع:  boolean optional وقتی روی true تنظیم شده باشد، درصورت امکان از کشتی‌های خودروبر اجتناب می‌کند و مسیرهای بدون کشتی خودروبر را ترجیح می‌دهد. فقط برای DRIVING یا TWO_WHEELER TravelMode اعمال می‌شود.
avoidHighways optional	نوع:  boolean optional وقتی روی true تنظیم شود، درصورت امکان از بزرگراه‌ها اجتناب می‌کند و مسیرهایی را که بزرگراه ندارند ترجیح می‌دهد. فقط برای DRIVING یا TWO_WHEELER TravelMode اعمال می‌شود.
avoidIndoor optional	نوع:  boolean optional وقتی روی true تنظیم شده باشد، درصورت امکان از پیمایش در فضای بسته اجتناب می‌کند و مسیرهایی را که حاوی پیمایش در فضای بسته نیستند ترجیح می‌دهد. فقط برای WALKING TravelMode اعمال می‌شود.
avoidTolls optional	نوع:  boolean optional وقتی روی true تنظیم شده باشد، درصورت امکان از جاده‌های عوارضی اجتناب می‌کند و مسیرهایی را که جاده عوارضی ندارند ترجیح می‌دهد. فقط برای DRIVING یا TWO_WHEELER TravelMode اعمال می‌شود.
tollPasses optional	نوع:  Iterable<string> optional اطلاعات مربوط به گذرکارت‌های عوارضی را کپسوله‌سازی می‌کند. اگر گذرکارت عوارضی ارائه شده باشد، API تلاش می‌کند قیمت گذرکارت را برگرداند. اگر گذرکارت عوارضی ارائه نشده باشد، API گذرکارت عوارضی را به‌عنوان نامشخص درنظر می‌گیرد و سعی می‌کند قیمت نقدی را برگرداند. فقط برای DRIVING یا TWO_WHEELER TravelMode اعمال می‌شود. برای مشاهده فهرست مقادیر معتبر، TollPass را ببینید.
vehicleInfo optional	نوع:  VehicleInfo optional اطلاعات خودرو را مشخص می‌کند.

میانای RoutePolylineDetails

میانا google.maps.routes.RoutePolylineDetails

جزئیات مربوط به بخشی از مسیر مطابق با چندخطی که می‌تواند برای سفارشی‌سازی سبک چندخطی استفاده شود.

مشخصات
speed optional	نوع:  Speed optional سرعت خواندن بخشی از مسیر مربوط به این چندخطی. فقط برای مسیرهای دارای اطلاعات ترافیک درج می‌شود.
transitDetails optional	نوع:  TransitDetails optional جزئیات حمل‌ونقل عمومی بخشی از مسیر که با این چندخطی مطابقت دارد. فقط برای مسیرهای دارای اطلاعات حمل‌ونقل عمومی درج می‌شود.
travelMode optional	نوع:  TravelMode optional حالت سفر بخشی از مسیر که با این چندخطی مطابقت دارد. خالی برای چندخطی‌های ترافیک.

میانای RoutePolylineOptions

میانا google.maps.routes.RoutePolylineOptions

گزینه‌های ایجاد چندخطی‌های مسیر.

مشخصات
colorScheme optional	نوع:  ColorScheme optional آرایش رنگ‌ها برای استفاده در چندخطی. وقتی به‌عنوان FOLLOW_SYSTEM مشخص شود و نقشه colorScheme نیز FOLLOW_SYSTEM باشد، چندخطی‌ها در همان حالت تیره/روشن نقشه ترسیم خواهند شد. وقتی مشخص نشده باشد، Route.createPolylines تلاش می‌کند از colorScheme نقشه استفاده کند یا به پیش‌فرض سیستم برمی‌گردد.
polylineOptions optional	نوع:  PolylineOptions|(function(PolylineOptions, RoutePolylineDetails): PolylineOptions) optional گزینه‌های سفارشی‌سازی کردن سبک چندخطی. می‌تواند شیء PolylineOptions باشد که برای همه چندخطی‌های مسیر اعمال می‌شود یا تابعی باشد که PolylineOptions و RoutePolylineDetails پیش‌فرض را می‌گیرد و PolylineOptions را برای اعمال شدن روی آن چندخطی برمی‌گرداند.

RouteTravelAdvisory کلاس

‫google.maps.routes.RouteTravelAdvisory کلاس

حاوی اطلاعات بیشتری است که کاربر باید در Route از آن‌ها مطلع شود.

با تماس با const {RouteTravelAdvisory} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
fuelConsumptionMicroliters	نوع:  number optional مصرف سوخت پیش‌بینی‌شده به میکرولیتر. توجه: اگر مصرف سوخت از ۲^۵۳ میکرولیتر بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
routeRestrictionsPartiallyIgnored	نوع:  boolean optional Route ممکن است محدودیت‌هایی داشته باشد که برای حالت سفر یا اصلاح‌کننده‌های مسیر درخواست‌شده مناسب نباشد.
speedReadingIntervals	نوع:  Array<SpeedReadingInterval> optional فواصل خواندن سرعت که جزئیات تراکم ترافیک را نشان می‌دهد. قابل‌اجرا درصورت TRAFFIC_AWARE و TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. این فاصله‌ها کل چندخطی Route را بدون هم‌پوشانی پوشش می‌دهند. نقطه شروع یک بازه مشخص‌شده با نقطه پایان بازه قبلی یکسان است. مثال: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo	نوع:  TollInfo optional حاوی اطلاعاتی درباره عوارض در Route است. این فیلد فقط درصورتی پر می‌شود که انتظار برود در Route عوارض وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما TollInfo.estimatedPrices پر نشده باشد، مسیر شامل عوارض است اما قیمت تخمینی نامشخص است. اگر این فیلد خالی باشد، یعنی در Route عوارضی وجود ندارد.
transitFare	نوع:  Money optional درصورت وجود، شامل کل هزینه کرایه یا بلیت این Route است. این ویژگی فقط برای TRANSIT ComputeRoutesRequest.travelMode و فقط برای مسیرهایی برگردانده می‌شود که اطلاعات کرایه برای همه مراحل حمل‌ونقل عمومی دردسترس باشد.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

ثابت‌های RoutingPreference

google.maps.routes.RoutingPreference یادآور همیشگی

عواملی که باید هنگام محاسبه مسیر درنظر گرفته شوند.

با تماس با const {RoutingPreference} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
TRAFFIC_AWARE	مسیرها را با درنظر گرفتن شرایط ترافیک زنده محاسبه می‌کند. برخلاف TRAFFIC_AWARE_OPTIMAL، برخی بهینه‌سازی‌ها برای کاهش قابل‌توجه تأخیر اعمال می‌شود.
TRAFFIC_AWARE_OPTIMAL	مسیرها را با درنظر گرفتن شرایط ترافیک زنده محاسبه می‌کند، بدون اینکه اکثر بهینه‌سازی‌های عملکرد را اعمال کند. استفاده از این مقدار بیشترین تأخیر را ایجاد می‌کند.
TRAFFIC_UNAWARE	مسیرها را بدون درنظر گرفتن شرایط ترافیک زنده محاسبه می‌کند. زمانی مناسب است که شرایط ترافیک اهمیتی نداشته باشد یا قابل‌اعمال نباشد. استفاده از این مقدار کمترین تأخیر را ایجاد می‌کند.

یادآورهای همیشگی سرعت

google.maps.routes.Speed یادآور همیشگی

طبقه‌بندی سرعت چندخطی براساس داده‌های ترافیک.

با تماس با const {Speed} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
NORMAL	سرعت عادی، بدون تأخیر ترافیکی.
SLOW	کاهش سرعت شناسایی شد، ترافیک متوسط.
TRAFFIC_JAM	تأخیر ترافیک.

میانای SpeedPath

میانا google.maps.routes.SpeedPath

‫LatLngAltitudeهای یک بازه مسیر را با خواندن سرعت برای آن بازه گروه‌بندی می‌کند.

مشخصات
path	نوع:  Array<LatLngAltitude> مسیر تحت پوشش این مسیر سرعت.
speed optional	نوع:  Speed optional سرعت خواندن مسیر.

کلاس SpeedReadingInterval

‫google.maps.routes.SpeedReadingInterval کلاس

نشانگر تراکم ترافیک در بخش مجاور چندخطی یا مسیر. با داشتن مسیری با نقاط P_0،‏ P_1،‏ ...،‏ P_N (شاخص صفرپایه)، SpeedReadingInterval تراکم ترافیک یک بازه را توصیف می‌کند.

با تماس با const {SpeedReadingInterval} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
endPolylinePointIndex	نوع:  number optional نمایه پایانی این فاصله در چندخطی.
speed	نوع:  Speed optional سرعت ترافیک در این بازه.
startPolylinePointIndex	نوع:  number optional نمایه شروع این فاصله زمانی در چندخطی.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  هیچ به شیء تبدیل می‌کند.

StepsOverview کلاس

‫google.maps.routes.StepsOverview کلاس

اطلاعات کلی درباره فهرستی از RouteLeg.steps ارائه می‌دهد.

با تماس با const {StepsOverview} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
multiModalSegments	نوع:  Array<MultiModalSegment> اطلاعات خلاصه‌شده درباره بخش‌های چندحالتی مختلف RouteLeg.steps.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

TollInfo کلاس

‫google.maps.routes.TollInfo کلاس

اطلاعات عوارض را در Route یا RouteLeg کپسوله می‌کند.

با تماس با const {TollInfo} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
estimatedPrices	نوع:  Array<Money> optional مبلغ پولی عوارض برای Route یا RouteLeg مربوطه. این فهرست حاوی مبلغی برای هر واحد پولی است که انتظار می‌رود ایستگاه‌های عوارضی دریافت کنند. معمولاً این فهرست فقط شامل یک مورد برای مسیرهای دارای عوارض با یک ارز خواهد بود. برای سفرهای بین‌المللی، این فهرست ممکن است شامل چندین مورد باشد تا عوارض را با واحدهای پولی مختلف نشان دهد.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

TransitAgency class

‫google.maps.routes.TransitAgency کلاس

اطلاعات مربوط به دفتر حمل‌ونقل عمومی.

با تماس با const {TransitAgency} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
name	نوع:  string optional نام این سازمان حمل‌ونقل عمومی.
phoneNumber	نوع:  string optional شماره تلفن سازمان حمل‌ونقل عمومی با قالب‌بندی مختص منطقه زبانی.
url	نوع:  URL optional نشانی وب دفتر حمل‌ونقل عمومی.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

کلاس TransitDetails

‫google.maps.routes.TransitDetails کلاس

اطلاعات بیشتر درباره مرحله حمل‌ونقل عمومی در مسیر.

با تماس با const {TransitDetails} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
arrivalStop	نوع:  TransitStop optional اطلاعات مربوط به ایستگاه مقصد برای این مرحله.
arrivalTime	نوع:  Date optional زمان تخمینی ورود برای مرحله.
departureStop	نوع:  TransitStop optional اطلاعات مربوط به ایستگاه حرکت برای این مرحله.
departureTime	نوع:  Date optional زمان تخمینی حرکت برای این مرحله.
headsign	نوع:  string optional جهت حرکت در این خط را همان‌طور که روی وسیله نقلیه یا در ایستگاه عزیمت علامت‌گذاری شده است مشخص می‌کند. جهت اغلب ایستگاه پایانی است.
headwayMillis	نوع:  number optional زمان موردانتظار را برحسب میلی‌ثانیه بین حرکت‌ها از یک ایستگاه در این زمان مشخص می‌کند. برای مثال، با مقدار فاصله زمانی ۶۰۰٬۰۰۰، اگر اتوبوس را ازدست بدهید، انتظار می‌رود ده دقیقه منتظر بمانید. توجه: اگر فاصله زمانی از ۲^۵۳ میلی‌ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
stopCount	نوع:  number تعداد توقف‌ها از ایستگاه عزیمت تا ایستگاه ورود. این تعداد شامل ایستگاه ورود می‌شود، اما ایستگاه خروج را دربرنمی‌گیرد. برای مثال، اگر مسیرتان از ایستگاه الف شروع شود، از ایستگاه‌های ب و پ عبور کند، و به ایستگاه ت برسد، stopCount برابر با ۳ خواهد بود.
transitLine	نوع:  TransitLine optional اطلاعات مربوط به خط حمل‌ونقل عمومی استفاده‌شده در مرحله.
tripShortText	نوع:  string optional نوشتاری که در زمان‌بندی‌ها و تابلوهای راهنما نشان داده می‌شود تا سفر حمل‌ونقل عمومی را برای مسافران مشخص کند. این نوشتار به‌طور منحصربه‌فردی سفر را در یک روز خدمات مشخص می‌کند. برای مثال، «۵۳۸» tripShortText قطار Amtrak است که در روزهای هفته ساعت ۱۵:۱۰ از سن خوزه، کالیفرنیا به مقصد ساکرامنتو، کالیفرنیا حرکت می‌کند.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

TransitLine کلاس

‫google.maps.routes.TransitLine کلاس

اطلاعات مربوط به خط حمل‌ونقل عمومی.

با تماس با const {TransitLine} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
agencies	نوع:  Array<TransitAgency> سازمان حمل‌ونقل عمومی (یا سازمان‌هایی) که این خط حمل‌ونقل عمومی را اداره می‌کند.
color	نوع:  string optional رنگی که معمولاً در تابلوهای این خط استفاده می‌شود. به‌صورت شانزده‌شانزدهی نشان داده می‌شود.
iconURL	نوع:  URL optional نشانی وب نماد مرتبط با این خط.
name	نوع:  string optional نام کامل این خط حمل‌ونقل عمومی، برای مثال، «8 Avenue Local».
shortName	نوع:  string optional نام کوتاه این خط حمل‌ونقل عمومی. این نام معمولاً شماره خط است، مثل «M7» یا «355».
textColor	نوع:  string optional رنگی که معمولاً در نوشتار تابلوهای این خط استفاده می‌شود. به‌صورت شانزده‌شانزدهی نشان داده می‌شود.
url	نوع:  URL optional نشانی وب این خط حمل‌ونقل عمومی که توسط سازمان حمل‌ونقل عمومی ارائه شده است.
vehicle	نوع:  TransitVehicle optional نوع وسیله نقلیه‌ای که در این خط حمل‌ونقل عمومی کار می‌کند.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

میانای TransitPreference

میانا google.maps.routes.TransitPreference

اولویت‌های مربوط به مسیرهای مبتنی بر TRANSIT که بر مسیر برگشتی تأثیر می‌گذارد.

مشخصات
allowedTransitModes optional	نوع:  Iterable<TransitMode> optional مجموعه‌ای از حالت‌های سفر برای استفاده هنگام دریافت مسیر TRANSIT. به‌طور پیش‌فرض همه حالت‌های سفر پشتیبانی‌شده را نشان می‌دهد.
routingPreference optional	نوع:  TransitRoutePreference optional اولویت مسیریابی که درصورت مشخص شدن، بر مسیر TRANSIT برگردانده‌شده تأثیر می‌گذارد.

کلاس TransitStop

‫google.maps.routes.TransitStop کلاس

اطلاعات مربوط به ایستگاه حمل‌ونقل عمومی.

با تماس با const {TransitStop} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
location	نوع:  DirectionalLocation optional مکان ایستگاه که با مختصات عرض جغرافیایی/طول جغرافیایی و عنوان اختیاری بیان می‌شود.
name	نوع:  string optional نام ایستگاه حمل‌ونقل عمومی.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

کلاس TransitVehicle

‫google.maps.routes.TransitVehicle کلاس

اطلاعات مربوط به وسیله نقلیه مورداستفاده در مسیرهای حمل‌ونقل عمومی.

با تماس با const {TransitVehicle} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

مشخصات
iconURL	نوع:  URL optional نشانی وب نماد مرتبط با این نوع خودرو.
localIconURL	نوع:  URL optional نشانی وب نماد مرتبط با این نوع وسیله نقلیه، براساس علائم حمل‌ونقل محلی.
name	نوع:  string optional نام این خودرو، با حروف بزرگ.
nameLanguage	نوع:  string optional کد زبان BCP-47 نوشتار نام خودرو، مثل «en-US» یا «sr-Latn». برای اطلاعات بیشتر، به این نشانی مراجعه کنید: https://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
vehicleType	نوع:  string optional نوع وسیله نقلیه استفاده‌شده. برای مشاهده فهرست مقادیر ممکن، https://developers.google.com/maps/documentation/routes/reference/rpc/google.maps.routing.v2#transitvehicletype را ببینید.

روش‌ها
toJSON	toJSON() پارامترها:  هیچ مقدار برگشتی:  Object به شیء تبدیل می‌کند.

ثابت‌های VehicleEmissionType

google.maps.routes.VehicleEmissionType یادآور همیشگی

مجموعه‌ای از مقادیر که نوع انتشار کربن خودرو را توصیف می‌کند. فقط برای حالت سفر DRIVING اعمال می‌شود.

با تماس با const {VehicleEmissionType} = await google.maps.importLibrary("routes") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

ثابت‌ها
DIESEL	خودروِ گازوئیلی.
ELECTRIC	خودرو برقی.
GASOLINE	خودروِ بنزینی.
HYBRID	خودرو با سوخت ترکیبی (مثل بنزین + برق).

میانای VehicleInfo

میانا google.maps.routes.VehicleInfo

حاوی اطلاعات خودرو، مثل نوع آلایندگی خودرو است.

مشخصات
emissionType optional	نوع:  VehicleEmissionType optional نوع انتشار کربن خودرو را توصیف می‌کند. فقط برای حالت سفر DRIVING اعمال می‌شود.

میانای Waypoint

میانا google.maps.routes.Waypoint

نشان‌دهنده نقطه‌مسیر در مسیر است.

مشخصات
location	نوع:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place مکان نقطه‌مسیر. رشته می‌تواند نشانی، plus code، یا نام منبع «مکان» باشد.
sideOfRoad optional	نوع:  boolean optional نشان می‌دهد که مکان این نقطه‌مسیر برای توقف خودرو در سمت خاصی از جاده ترجیح داده می‌شود. وقتی این مقدار را تنظیم می‌کنید، مسیر از مکان عبور می‌کند تا خودرو بتواند در سمتی از جاده که مکان نسبت‌به مرکز جاده به آن متمایل است توقف کند. این گزینه فقط برای DRIVING و TWO_WHEELER ComputeRoutesRequest.travelMode کار می‌کند
vehicleStopover optional	نوع:  boolean optional نشان می‌دهد که نقطه‌مسیر برای توقف خودروها درنظر گرفته شده است، جایی که هدف سوار کردن یا پیاده کردن است. وقتی این مقدار را تنظیم می‌کنید، مسیر محاسبه‌شده شامل نقطه‌مسیرهای غیرvia در جاده‌هایی که برای سوار کردن و پیاده کردن مناسب نیستند نخواهد بود. این گزینه فقط برای DRIVING و TWO_WHEELER ComputeRoutesRequest.travelMode و زمانی‌که Waypoint.location string یا Place نباشد کار می‌کند.
via optional	نوع:  boolean optional این نقطه‌مسیر را به‌عنوان نقطه عطف علامت‌گذاری می‌کند نه نقطه توقف. برای هر نقطه‌مسیر غیرvia در ComputeRoutesRequest، Route.computeRoutes ورودی‌ای به آرایه Route.legs اضافه می‌کند تا جزئیات توقف‌های بین راه را در آن بخش از سفر ارائه دهد. وقتی می‌خواهید مسیر بدون توقف از این نقطه‌مسیر عبور کند، این مقدار را روی true تنظیم کنید. نقطه‌مسیرهای گذری باعث نمی‌شوند ورودی‌ای به آرایه Route.legs اضافه شود، اما سفر را ازطریق نقطه‌مسیر مسیریابی می‌کنند. نکته‌ها: این مقدار را فقط می‌توانید برای نقاط‌مسیر میانی تنظیم کنید. اگر این فیلد را روی نقطه‌مسیرهای پایانه تنظیم کنید، درخواست ناموفق خواهد بود. اگر ComputeRoutesRequest.optimizeWaypointOrder روی true تنظیم شده باشد، این فیلد نمی‌تواند روی درست تنظیم شود؛ درغیراین‌صورت، درخواست ناموفق خواهد بود.

میانای WaypointMarkerDetails

میانا google.maps.routes.WaypointMarkerDetails

جزئیات مربوط به نقطه‌مسیر که می‌تواند برای سفارشی‌سازی سبک نشانگر استفاده شود.

مشخصات
index	نوع:  number نمایه نشانگر.
totalMarkers	نوع:  number تعداد کل نشانگرها در مسیر.
leg optional	نوع:  RouteLeg optional مسیری که نشانگر به آن تعلق دارد. اگر مسیر بخش نداشته باشد، خالی است.