Route (beta)

کلاس مسیر

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

شامل یک مسیر است که شامل یک سری از بخش های جاده متصل است که به ایستگاه های ابتدایی، انتهایی و میانی می پیوندند.

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

computeRoutes
computeRoutes(request)
پارامترها:
مقدار بازگشتی: 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 تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می شود.

توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
legs
نوع: Array < RouteLeg > optional
مجموعه ای از پاها (بخش های مسیر بین ایستگاه های بین راه) که مسیر را تشکیل می دهند. هر پا مربوط به سفر بین دو ایستگاه غیر via است.

به عنوان مثال:
  • مسیری که ایستگاه بین راهی ندارد فقط یک پا دارد.
  • مسیری که شامل یک ایستگاه بین راهی غیر via است، دو پا دارد.
  • مسیری که شامل یک مسیر via ایستگاه بین راهی است، یک پا دارد.
ترتیب پاها با ترتیب ایستگاه های بین راه از origin تا intermediates تا destination مطابقت دارد.
localizedValues
نوع: RouteLocalizedValues optional
نمایش متنی ویژگی های Route .
optimizedIntermediateWaypointIndices
نوع: Array <number> optional
اگر ComputeRoutesRequest.optimizeWaypointOrder را روی true تنظیم کنید، این فیلد شامل ترتیب بهینه شده نقاط بین راهی است. در غیر این صورت این قسمت خالی است. شاخص با 0 برای اولین نقطه میانی ارائه شده در ورودی شروع می شود.

به عنوان مثال، اگر یک ورودی از:
  • منبع: LA
  • ایستگاه های بین راهی: دالاس، بانگور، فینیکس
  • مقصد: نیویورک
و ترتیب میانی بهینه شده Phoenix، Dallas، Bangor است، سپس این فیلد [2, 0, 1] خواهد بود.
path
نوع: Array < LatLngAltitude > optional
لیست LatLngAltitude s مسیر که می توان از آن برای رسم چند خط مسیر استفاده کرد. دانه بندی مسیر را می توان با تنظیم 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
مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی.

توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
travelAdvisory
نوع: RouteTravelAdvisory optional
اطلاعات تکمیلی در مورد مسیر.
viewport
نوع: LatLngBounds optional
کادر محدود کننده نما در مسیر.
warnings
نوع: Array <string> optional
مجموعه ای از هشدارها برای نشان دادن هنگام نمایش مسیر.
createPolylines
createPolylines([options])
پارامترها:
مقدار بازگشتی: Array < Polyline >
بر اساس داده های موجود چند خط برای مسیر ایجاد می کند.

چند خط چند وجهی:
  • الزامات:
  • برای هر بخش مسیر چند وجهی یک چند خط ایجاد می کند. چند خطوط بر اساس حالت سفر بخش و داده‌های خط حمل‌ونقل در صورت وجود استایل‌بندی می‌شوند. گزینه ها را می توان برای تغییر سبک چند خطی بر اساس حالت سفر و خط حمل و نقل منتقل کرد.

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

چند خط کلی:
  • الزامات:
  • یک چند خط واحد برای کل مسیر با یک استایل پیش فرض اعمال می شود. گزینه ها را می توان برای تغییر سبک چند خطی بر اساس حالت سفر مسیر وارد کرد. برای سفارشی سازی بیشتر، چند خطوط را مستقیماً با استفاده از Route.path یا RouteLeg.path ایجاد کنید.
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
مقدار بازگشتی: Promise < Array < AdvancedMarkerElement >>
نشانگرهایی را برای مسیر با برچسب "A"، "B"، "C" و غیره برای هر نقطه راه ایجاد می کند. نشانگرها استایل پیش‌فرض اعمال شده‌اند. گزینه ها را می توان برای تغییر سبک نشانگر بر اساس شاخص نشانگر یا ویژگی های RouteLeg مربوطه ارسال کرد. اگر مسیر فاقد پا باشد، پارامتر WaypointMarkerDetails.leg تعریف نشده است.

فیلد "legs" باید در ComputeRoutesRequest.fields درخواست شود تا نقاط بین راه درج شود.
toJSON
toJSON()
پارامترها: ندارد
مقدار بازگشتی: Object
به یک شی تبدیل می شود.

رابط ComputeRoutesRequest

google.maps.routes . ComputeRoutesRequest رابط google.maps.routes . ComputeRoutesRequest

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

destination
مقصد مسیر. مقداری که به عنوان رشته ارسال می شود ممکن است آدرس، کد به اضافه یا نام منبع مکان باشد. مقادیر ارتفاع برای مسیرهای محاسباتی در نظر گرفته نمی شود.
fields
نوع: Iterable <string>
مجموعه فیلدهایی که باید واکشی شوند. برای همه فیلدها ["*"] را مشخص کنید.
origin
مبدا مسیر. مقداری که به عنوان رشته ارسال می شود ممکن است یک آدرس، کد به اضافه یا نام منبع مکان باشد. مقادیر ارتفاع برای مسیرهای محاسباتی در نظر گرفته نمی شود.
arrivalTime optional
نوع: Date optional
زمان رسیدن.

توجه: فقط زمانی قابل تنظیم است که ComputeRoutesRequest.travelMode روی TRANSIT تنظیم شده باشد. می توانید ComputeRoutesRequest.departureTime یا ComputeRoutesRequest.arrivalTime را مشخص کنید، اما نه هر دو را. سفرهای ترانزیت تا 7 روز در گذشته یا 100 روز در آینده در دسترس هستند.
computeAlternativeRoutes optional
نوع: boolean optional
تعیین می کند که آیا مسیرهای جایگزین علاوه بر مسیر محاسبه شود یا خیر. هیچ مسیر جایگزینی برای درخواست هایی که دارای ایستگاه های بین راهی هستند بازگردانده نمی شود.
departureTime optional
نوع: Date optional
زمان حرکت اگر این مقدار را تنظیم نکنید، این مقدار به طور پیش‌فرض روی زمانی است که درخواست را انجام داده‌اید.

توجه: شما فقط می توانید زمانی را در گذشته مشخص کنید که ComputeRoutesRequest.travelMode روی TRANSIT تنظیم شده باشد. سفرهای ترانزیت تا 7 روز در گذشته یا 100 روز در آینده در دسترس هستند.
extraComputations optional
فهرستی از محاسبات اضافی که ممکن است برای تکمیل درخواست استفاده شود.

توجه: این محاسبات اضافی ممکن است فیلدهای اضافی را در پاسخ بازگرداند. این فیلدهای اضافی نیز باید در ComputeRoutesRequest.fields مشخص شوند تا در پاسخ بازگردانده شوند.
intermediates optional
نوع: Iterable < Waypoint > optional
مجموعه ای از ایستگاه های بین راهی در طول مسیر (به استثنای نقاط پایانه)، برای توقف یا عبور. حداکثر 25 ایستگاه بین راهی پشتیبانی می شود.
language optional
نوع: string optional
کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان از تنظیمات محلی سازی API جاوا اسکریپت Google Maps شما استنتاج می شود. در غیر این صورت، زبان از محل مبدأ استنباط می شود.
optimizeWaypointOrder optional
نوع: boolean optional
اگر روی true تنظیم شود، سرویس تلاش می کند تا هزینه کلی مسیر را با مرتب کردن مجدد ایستگاه های بین راهی مشخص شده به حداقل برساند. در صورتی که هر یک از ایستگاه های بین راهی یک ایستگاه بین راهی باشد، درخواست با شکست مواجه می شود. از Route.optimizedIntermediateWaypointIndices در پاسخ برای یافتن سفارش جدید استفاده کنید. اگر "optimizedIntermediateWaypointIndices" در ComputeRoutesRequest.fields درخواست نشود، درخواست با شکست مواجه می شود. اگر روی false تنظیم شود، Route.optimizedIntermediateWaypointIndices در پاسخ خالی خواهد بود.
polylineQuality optional
نوع: PolylineQuality optional
اولویت را برای کیفیت پلی لاین مشخص می کند.
region optional
نوع: string optional
کد منطقه که به عنوان یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") مشخص شده است. برای اطلاعات بیشتر به دامنه های سطح بالای کد کشور مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، منطقه از تنظیمات محلی سازی API جاوا اسکریپت Google Maps شما استنتاج می شود. در غیر این صورت، منطقه از محل مبدا استنباط می شود.
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 ثابت های 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 رابط google.maps.routes . DirectionalLocationLiteral

به‌عنوان سهولت، لفظ‌های شی به جای نمونه‌های DirectionalLocation پذیرفته می‌شوند. هنگامی که Maps JS API با آنها برخورد می کند، به DirectionalLocation تبدیل می شوند.

این رابط LatLngAltitudeLiteral را گسترش می دهد.

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

کلاس DirectionalLocation

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

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

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

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

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

ارثی: LatLngAltitude
heading
نوع: number optional
عنوان قطب نما با جهت جریان ترافیک مرتبط است. مقادیر سرفصل می توانند اعدادی از 0 تا 360 باشند، که در آن 0 سرفصل شمال را مشخص می کند، 90 عنوان یک عنوان شرق و غیره را مشخص می کند. شما می توانید از این فیلد فقط برای DRIVING و TWO_WHEELER ComputeRoutesRequest.travelMode استفاده کنید.
موروثی: altitude ، lat ، lng
toJSON
toJSON()
پارامترها: ندارد
مقدار برگشتی: DirectionalLocationLiteral
به یک شی تبدیل می شود.
موروثی: equals

کلاس FallbackInfo

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

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

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

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

ثابت های FallbackReason

google.maps.routes . 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 ثابت های 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 کلاس google.maps.routes . GeocodedWaypoint

کدگذاری جغرافیایی در مورد مکان های مورد استفاده به عنوان ایستگاه های بین راه. فقط برای نقاط راه آدرس پر شده است. شامل جزئیاتی در مورد نتایج کدگذاری جغرافیایی به منظور تعیین اینکه آدرس به چه مکانی کدگذاری شده است.

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

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

کلاس نتایج جغرافیایی

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

شامل GeocodedWaypoint برای مبدا، مقصد، و ایستگاه های بین راهی. فقط برای نقاط راه آدرس پر شده است.

با فراخوانی 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 کلاس 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 کلاس 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 کلاس google.maps.routes . PolylineDetails

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

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

flyoverInfo
جزئیات پرواز در امتداد چند خط.
narrowRoadInfo
جزئیات جاده باریک در امتداد چند خط.
toJSON
toJSON()
پارامترها: ندارد
مقدار بازگشتی: Object
به یک شی تبدیل می شود.

ثابت های کیفیت Polyline

google.maps.routes . 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 ثابت های google.maps.routes . ReferenceRoute

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

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

FUEL_EFFICIENT مسیر مصرف سوخت
SHORTER_DISTANCE مسیری با مسافت سفر کمتر.

ثابت های RoadFeatureState

google.maps.routes . RoadFeatureState ثابت های google.maps.routes . RoadFeatureState

حالت های ویژگی های جاده را در امتداد یک خط چند خطی در بر می گیرد.

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

DOES_NOT_EXIST ویژگی جاده وجود ندارد.
EXISTS ویژگی جاده وجود دارد.

ثابت های RouteLabel

google.maps.routes . 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 کلاس 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 تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می شود.

توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
endLocation
نوع: DirectionalLocation optional
محل انتهایی این پا. این مکان ممکن است متفاوت از ComputeRoutesRequest.destination باشد. به عنوان مثال، زمانی که ComputeRoutesRequest.destination نزدیک جاده ای نیست، این نقطه ای در جاده است.
localizedValues
نوع: RouteLegLocalizedValues optional
نمایش متنی ویژگی های RouteLeg .
path
نوع: Array < LatLngAltitude >
لیست LatLngAltitude s پای مسیر که می توان از آن برای رسم چند خط پای مسیر استفاده کرد. دانه بندی مسیر را می توان با تنظیم 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
مدت زمان سفر از طریق پا بدون در نظر گرفتن شرایط ترافیکی.

توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
steps
نوع: Array < RouteLegStep >
مجموعه‌ای از مراحل که بخش‌های درون این پا را نشان می‌دهد. هر مرحله نشان دهنده یک دستورالعمل ناوبری است.
stepsOverview
نوع: StepsOverview optional
اطلاعات کلی در مورد مراحل این RouteLeg . این قسمت فقط برای مسیرهای TRANSIT پر شده است.
travelAdvisory
نوع: RouteLegTravelAdvisory optional
حاوی اطلاعات اضافی است که کاربر باید از آنها مطلع شود، مانند محدودیت های احتمالی منطقه ترافیک، در یک مسیر.
toJSON
toJSON()
پارامترها: ندارد
مقدار بازگشتی: Object
به یک شی تبدیل می شود.

کلاس RouteLegLocalizedValues

google.maps.routes . 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 کلاس 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 s پله پای مسیر که می توان از آن برای رسم چندخط پله پای مسیر استفاده کرد. دانه بندی مسیر را می توان با تنظیم ComputeRoutesRequest.polylineQuality کنترل کرد. فیلد "path" باید در ComputeRoutesRequest.fields درخواست شود تا این فیلد پر شود.
startLocation
نوع: DirectionalLocation optional
محل شروع این مرحله.
staticDurationMillis
نوع: number optional
مدت زمان سفر در این مرحله بدون در نظر گرفتن شرایط ترافیکی.

توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
transitDetails
نوع: TransitDetails optional
جزئیات مربوط به این مرحله اگر حالت سفر TRANSIT باشد.
travelMode
نوع: TravelMode optional
حالت سفر استفاده شده برای این مرحله.
toJSON
toJSON()
پارامترها: ندارد
مقدار بازگشتی: Object
به یک شی تبدیل می شود.

کلاس RouteLegStepLocalizedValues

google.maps.routes . 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 کلاس 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 کلاس 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 رابط google.maps.routes . RouteModifiers

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

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

رابط Routepolylinedetails

google.maps.routes . RoutePolylineDetails رابط google.maps.routes . RoutePolylineDetails

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

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

رابط RoutepolylineOptions

google.maps.routes . RoutePolylineOptions رابط google.maps.routes . RoutePolylineOptions

گزینه هایی برای ایجاد polylines مسیر.

colorScheme optional
نوع: ColorScheme optional
طرح رنگی برای استفاده برای polyline. هنگامی که به عنوان FOLLOW_SYSTEM مشخص می شود در حالی که Map colorScheme نیز FOLLOW_SYSTEM ، polylines در همان حالت تاریک/نور به عنوان نقشه ترسیم می شود. هنگامی که مشخص نشده است ، Route.createPolylines سعی می کند از colorScheme نقشه استفاده کند یا به پیش فرض سیستم برگردد.
polylineOptions optional
گزینه هایی برای شخصی سازی سبک یک پلی خط. می تواند یا یک شیء PolylineOptions باشد که برای همه پولیلین ها برای مسیر اعمال می شود یا عملکردی که به طور پیش فرض PolylineOptions و RoutePolylineDetails را انجام می دهد و PolylineOptions باز می گرداند که برای آن پلی خط اعمال می شود.

کلاس RoutetravelAdvisory

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

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

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

fuelConsumptionMicroliters
نوع: number optional
پیش بینی مصرف سوخت در میکرولیترها.

توجه: اگر مصرف سوخت بیش از 2^53 میکرولیتر باشد ، این مقدار Number.POSITIVE_INFINITY است. 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
تبدیل به یک شی.

ConstingPreenference Constants

google.maps.routes . RoutingPreference Constants

عواملی که باید هنگام محاسبه مسیر مورد توجه قرار گیرند.

دسترسی با فراخوانی 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 تاخیر در ترافیک

رابط کاربری سرعت

google.maps.routes . SpeedPath رابط google.maps.routes . SpeedPath

گروه های LatLngAltitude از یک فاصله مسیر با سرعت خواندن برای فاصله را با هم گروه ها گروه می کنند.

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

کلاس SpeedReadingInterval

google.maps.routes . 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 کلاس google.maps.routes . StepsOverview

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

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

multiModalSegments
اطلاعات خلاصه شده در مورد بخش های مختلف چند منظوره از RouteLeg.steps .
toJSON
toJSON()
پارامترها: هیچ
مقدار بازگشت: Object
تبدیل به یک شی.

کلاس TollInfo

google.maps.routes . 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
تبدیل به یک شی.

کلاس ترانزیراژنی

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

اطلاعات مربوط به آژانس ترانزیت.

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

name
نوع: string optional
نام این آژانس ترانزیت.
phoneNumber
نوع: string optional
شماره تلفن با فرمت اختصاصی آژانس ترانزیت.
url
نوع: URL optional
URL آژانس ترانزیت.
toJSON
toJSON()
پارامترها: هیچ
مقدار بازگشت: Object
تبدیل به یک شی.

کلاس TransitDetails

google.maps.routes . 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
زمان پیش بینی شده در میلی ثانیه بین عزیمت از همان توقف در این زمان را مشخص می کند. به عنوان مثال ، با ارزش پیشروی 600000 ، انتظار دارید که اگر اتوبوس خود را از دست بدهید ، ده دقیقه منتظر بمانید.

توجه: اگر پیشروی بیش از 2^53 میلی ثانیه باشد ، این مقدار Number.POSITIVE_INFINITY است. positive_infinity.
stopCount
نوع: number
تعداد توقف از عزیمت به توقف ورود. این شمارش شامل توقف ورود است ، اما توقف عزیمت را مستثنی می کند. به عنوان مثال ، اگر مسیر شما از توقف A خارج شود ، از توقف B و C عبور می کند و به Stop D می رسد ، stopCount 3 خواهد بود.
transitLine
نوع: TransitLine optional
اطلاعات مربوط به خط ترانزیت مورد استفاده در مرحله.
tripShortText
نوع: string optional
متنی که در برنامه ها ظاهر می شود و تابلوها را امضا می کند تا یک سفر ترانزیت به مسافران را شناسایی کند. متن منحصر به فرد سفر را در یک روز خدمات مشخص می کند. به عنوان مثال ، "538" tripShortText از قطار Amtrak است که سان خوزه ، کالیفرنیا را در ساعت 15:10 در روزهای هفته به ساکرامنتو ، کالیفرنیا ترک می کند.
toJSON
toJSON()
پارامترها: هیچ
مقدار بازگشت: Object
تبدیل به یک شی.

کلاس TransitLine

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

اطلاعات مربوط به یک خط ترانزیت.

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

agencies
نوع: Array < TransitAgency >
آژانس ترانزیت (یا آژانس ها) که این خط ترانزیت را اداره می کند.
color
نوع: string optional
رنگی که معمولاً در این علائم در علائم استفاده می شود. در hexadecimal نماینده است.
iconURL
نوع: URL optional
URL برای نماد مرتبط با این خط.
name
نوع: string optional
به عنوان مثال ، نام کامل این خط ترانزیت ، "8 خیابان محلی".
shortName
نوع: string optional
نام کوتاه این خط ترانزیت. این نام معمولاً یک شماره خط مانند "M7" یا "355" خواهد بود.
textColor
نوع: string optional
رنگی که معمولاً در متن روی علائم برای این خط استفاده می شود. در hexadecimal نماینده است.
url
نوع: URL optional
URL برای این خط ترانزیت همانطور که توسط آژانس ترانزیت ارائه شده است.
vehicle
نوع: TransitVehicle optional
نوع وسیله نقلیه ای که در این خط ترانزیت کار می کند.
toJSON
toJSON()
پارامترها: هیچ
مقدار بازگشت: Object
تبدیل به یک شی.

رابط TransitPreference

google.maps.routes . TransitPreference رابط google.maps.routes . TransitPreference

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

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

کلاس ترانزیت

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

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

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

location
نوع: DirectionalLocation optional
محل توقف بیان شده در مختصات عرض جغرافیایی/طول جغرافیایی و عنوان اختیاری.
name
نوع: string optional
نام ترانزیت توقف.
toJSON
toJSON()
پارامترها: هیچ
مقدار بازگشت: Object
تبدیل به یک شی.

کلاس ترانزیت

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

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

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

iconURL
نوع: URL optional
URL برای یک نماد مرتبط با این نوع وسیله نقلیه.
localIconURL
نوع: URL optional
URL برای نماد مرتبط با این نوع وسیله نقلیه ، بر اساس علائم حمل و نقل محلی.
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
تبدیل به یک شی.

ثابت VehicleMissionType

google.maps.routes . 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 رابط google.maps.routes . VehicleInfo

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

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

رابط نقطه راه

google.maps.routes . Waypoint رابط google.maps.routes . Waypoint

نمایانگر یک نقطه راه در یک مسیر است.

location
محل ایستگاه Waypoint. یک رشته ممکن است یک آدرس ، یک کد به علاوه یا نام منبع مکان باشد.
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 LEGS را ضمیمه می کند تا جزئیات مربوط به توقف در آن پای سفر را ارائه دهد.

وقتی می خواهید مسیر از این نقطه عبور کند بدون اینکه متوقف شود ، این مقدار را true تنظیم کنید. از طریق ایستگاه های راه باعث نمی شود که ورود به Route.legs لژها اضافه شود ، اما آنها سفر را از طریق ایستگاه راه طی می کنند.

یادداشت ها:
  • فقط می توانید این مقدار را در ایستگاه های راه که واسطه هستند تنظیم کنید. اگر این قسمت را در ایستگاه های راه ترمینال تنظیم کنید ، درخواست انجام نمی شود.
  • اگر ComputeRoutesRequest.optimizeWaypointOrder true تنظیم شده باشد ، این قسمت نمی تواند درست تنظیم شود. در غیر این صورت ، درخواست انجام نمی شود.

رابط WaypointmarkerDetails

google.maps.routes . WaypointMarkerDetails رابط google.maps.routes . WaypointMarkerDetails

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

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