Route Matrix (beta)

کلاس RouteMatrix

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

ماتریسی از مسیرهای محاسبه شده برای مجموعه ای از جفت مبدا/مقصد توسط RouteMatrix.computeRouteMatrix

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

computeRouteMatrix
computeRouteMatrix(request)
پارامترها:
مقدار بازگشتی: Promise <{matrix: RouteMatrix }>
فهرستی از مبدا و مقصد را می گیرد و ماتریسی حاوی اطلاعات مسیر را برای هر ترکیب مبدا و مقصد برمی گرداند.

توجه: این روش مستلزم آن است که با تنظیم ویژگی ComputeRouteMatrixRequest.fields ، ماسک فیلد پاسخ را در درخواست مشخص کنید. مقدار فهرستی از مسیرهای فیلد است.

به عنوان مثال:
  • ماسک فیلد همه فیلدهای موجود: fields: ['*']
  • ماسک میدان مدت و فاصله در سطح مسیر: fields: ['durationMillis', 'distanceMeters']

استفاده از fields: ['*'] ممنوع است زیرا:
  • انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می کند تا چرخه های محاسباتی را ذخیره کند و به ما امکان می دهد نتیجه را با تاخیر کمتری به شما برگردانیم.
  • انتخاب تنها زمینه هایی که در کار تولیدی خود به آن نیاز دارید، عملکرد تاخیر پایدار را تضمین می کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسبات اضافی نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدها را در سطح بالا انتخاب کنید، ممکن است با کاهش عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه کنیم به طور خودکار در پاسخ گنجانده می شود.
  • انتخاب فقط فیلدهایی که به آنها نیاز دارید باعث می‌شود که اندازه پاسخ کوچک‌تر و در نتیجه بارگذاری سریع‌تر روی شبکه انجام شود.
rows
نوع: Array < RouteMatrixRow >
ردیف های ماتریس. هر ردیف مربوط به یک مبدا است و شامل آرایه ای از RouteMatrixItem s است که هر یک نشان دهنده مسیری به مقصد است.
toJSON
toJSON()
پارامترها: ندارد
مقدار بازگشتی: Object
به یک شی تبدیل می شود.

کلاس RouteMatrixRow

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

مربوط به مبدأ ارسال شده به RouteMatrix.computeRouteMatrix است. حاوی لیستی از RouteMatrixItem است که هر آیتم نشان دهنده مسیری به مقصد است.

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

items
نوع: Array < RouteMatrixItem >
اطلاعات مسیر برای هر مقصد
toJSON
toJSON()
پارامترها: ندارد
مقدار بازگشتی: Object
به یک شی تبدیل می شود.

کلاس RouteMatrixItem

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

حاوی اطلاعات مسیر محاسبه شده برای یک جفت مبدا/مقصد ارسال شده به RouteMatrix.computeRouteMatrix است.

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

condition
نوع: RouteMatrixItemCondition optional
نشان می دهد که آیا مسیر پیدا شده است یا خیر.
distanceMeters
نوع: number optional
مسافت طی مسیر بر حسب متر.
durationMillis
نوع: number optional
مدت زمان لازم برای پیمایش مسیر بر حسب میلی ثانیه. اگر ComputeRouteMatrixRequest.routingPreference را روی TRAFFIC_UNAWARE تنظیم کنید، این مقدار با RouteMatrixItem.staticDurationMillis یکسان است. اگر ComputeRouteMatrixRequest.routingPreference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می شود.

توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
error
نوع: RouteMatrixItemError optional
خطایی که در حین محاسبه مسیر رخ داد.
fallbackInfo
نوع: FallbackInfo optional
در برخی موارد که سرور قادر به محاسبه مسیر با ترجیحات داده شده برای این جفت مبدا/مقصد خاص نیست، ممکن است به استفاده از حالت دیگری از محاسبه بازگردد. هنگامی که از یک بازگشت مجدد استفاده می شود، این قسمت حاوی اطلاعات دقیق در مورد پاسخ بازگشتی است. در غیر این صورت این فیلد تنظیم نشده است.
localizedValues
نمایش متنی خصوصیات RouteMatrixItem .
staticDurationMillis
نوع: number optional
مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی.

توجه: اگر مدت زمان از 2^53 میلی ثانیه بیشتر شود، این مقدار Number.POSITIVE_INFINITY است.
travelAdvisory
نوع: RouteTravelAdvisory optional
اطلاعات تکمیلی در مورد مسیر.

رابط ComputeRouteMatrixRequest

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

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

destinations
آرایه ای از مقاصد، که ستون های ماتریس پاسخ را تعیین می کند. مقدار ارسال شده به عنوان یک رشته ممکن است یک آدرس، یک کد مثبت یا نام منبع مکان باشد. مقادیر ارتفاع در نظر گرفته نمی شود.
fields
نوع: Iterable <string>
مجموعه فیلدهایی که باید واکشی شوند. برای همه فیلدها ["*"] را مشخص کنید.
origins
آرایه مبدا، که ردیف های ماتریس پاسخ را تعیین می کند. مقدار ارسال شده به عنوان یک رشته ممکن است یک آدرس، یک کد مثبت یا نام منبع مکان باشد. مقادیر ارتفاع در نظر گرفته نمی شود.

چندین محدودیت اندازه برای اصلی بودن مبدا و مقصد اعمال می شود:
  • تعداد کل مبداها و مقصدهای مشخص شده به عنوان string یا Place نباید بیشتر از 50 باشد.
  • حاصل ضرب تعداد مبدا و تعداد مقصد نباید بیشتر از 625 باشد.
  • اگر ComputeRouteMatrixRequest.routingPreference روی TRAFFIC_AWARE_OPTIMAL تنظیم شده باشد، حاصل ضرب تعداد مبدا و مقصد نباید بیشتر از 100 باشد.
  • اگر ComputeRouteMatrixRequest.travelMode روی TRANSIT تنظیم شده باشد، حاصل ضرب تعداد مبدا و مقصد نباید بیشتر از 100 باشد.
arrivalTime optional
نوع: Date optional
زمان رسیدن.

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

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

توجه: این محاسبات اضافی ممکن است فیلدهای اضافی را در پاسخ بازگرداند. این فیلدهای اضافی نیز باید در ComputeRouteMatrixRequest.fields مشخص شوند تا در پاسخ بازگردانده شوند.
language optional
نوع: string optional
کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان از تنظیمات محلی سازی API جاوا اسکریپت Google Maps شما استنتاج می شود. در غیر این صورت، زبان از محل مبدأ اول استنباط می شود.
region optional
نوع: string optional
کد منطقه که به عنوان یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") مشخص شده است. برای اطلاعات بیشتر به دامنه های سطح بالای کد کشور مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، منطقه از تنظیمات محلی سازی API جاوا اسکریپت Google Maps شما استنتاج می شود. در غیر این صورت، منطقه از محل مبدا اول استنباط می شود.
routingPreference optional
نوع: RoutingPreference optional
نحوه محاسبه ماتریس مسیر را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه ماتریس مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تاخیر طولانی مدت شود، یک خطا برگردانده می شود. شما می توانید این گزینه را فقط زمانی مشخص کنید که ComputeRouteMatrixRequest.travelMode DRIVING یا TWO_WHEELER باشد، در غیر این صورت درخواست با شکست مواجه می شود.
trafficModel optional
نوع: TrafficModel optional
مفروضاتی را برای محاسبه زمان در ترافیک مشخص می کند. این تنظیم بر مقدار بازگشتی در RouteMatrixItem.durationMillis که شامل زمان پیش‌بینی‌شده در ترافیک بر اساس میانگین‌های تاریخی است، تأثیر می‌گذارد. ComputeRouteMatrixRequest.trafficModel فقط برای درخواست هایی در دسترس است که ComputeRouteMatrixRequest.routingPreference را روی TRAFFIC_AWARE_OPTIMAL و ComputeRouteMatrixRequest.travelMode را روی DRIVING تنظیم کرده اند. پیش‌فرض BEST_GUESS است.
transitPreference optional
نوع: TransitPreference optional
تنظیمات برگزیده را مشخص می کند که بر مسیر برگشتی برای مسیرهای TRANSIT تأثیر می گذارد.

توجه: فقط زمانی می توان آن را مشخص کرد که ComputeRouteMatrixRequest.travelMode روی TRANSIT تنظیم شده باشد.
travelMode optional
نوع: TravelMode optional
نحوه حمل و نقل را مشخص می کند.
units optional
نوع: UnitSystem optional
واحدهای اندازه گیری فیلدهای نمایش را مشخص می کند. اگر این مقدار را ارائه نکنید، واحدهای نمایش از محل مبدا اول استنتاج می شوند.

ثابت های ComputeRouteMatrixExtraComputation

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

محاسبات اضافی برای انجام یک درخواست RouteMatrix.computeRouteMatrix .

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

TOLLS اطلاعات عوارض برای آیتم(های) ماتریس.

ثابت های RouteMatrixItemCondition

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

شرایط یک مسیر برای یک جفت مبدا/مقصد معین.

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

ROUTE_EXISTS مسیری پیدا شد.
ROUTE_NOT_FOUND هیچ مسیری پیدا نشد

کلاس RouteMatrixItemError

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

خطایی که در طول RouteMatrix.computeRouteMatrix برای یک جفت مبدا/مقصد خاص رخ داد.

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

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

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

کلاس RouteMatrixItemLocalizedValues

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

نمایش متنی RouteMatrixItem .

با فراخوانی const {RouteMatrixItemLocalizedValues} = 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
مدت زمان، به صورت متن نمایش داده شده و به منطقه پرس و جو بومی سازی شده است. شرایط ترافیکی را در نظر می گیرد.

توجه: اگر اطلاعات ترافیک را درخواست نکرده‌اید، این مقدار همان مقدار RouteMatrixItemLocalizedValues.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».

برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید.
toJSON
toJSON()
پارامترها: ندارد
مقدار بازگشتی: Object
به یک شی تبدیل می شود.

رابط RouteMatrixOrigin

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

یک مبدا واحد برای یک ComputeRouteMatrixRequest .

waypoint
محل مبدا. مقدار ارسال شده به عنوان یک رشته ممکن است یک آدرس یا کد مثبت باشد. مقادیر ارتفاع برای در نظر گرفته نمی شود.
routeModifiers optional
نوع: RouteModifiers optional
اصلاح‌کننده‌ها برای هر مسیری که این را مبدأ می‌گیرد.