Distance Matrix

کلاس DistanceMatrixService

google.maps . DistanceMatrixService کلاس google.maps . DistanceMatrixService

سرویسی برای محاسبه فاصله بین مبدا و مقصد چندگانه.

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

DistanceMatrixService
DistanceMatrixService()
پارامترها: ندارد
یک نمونه جدید از DistanceMatrixService ایجاد می کند که پرس و جوهای ماتریس فاصله را به سرورهای Google ارسال می کند.
getDistanceMatrix
getDistanceMatrix(request[, callback])
مولفه های:
مقدار بازگشتی: Promise < DistanceMatrixResponse >
درخواست ماتریس فاصله را صادر می کند.

رابط DistanceMatrixRequest

google.maps . DistanceMatrixRequest رابط google.maps . DistanceMatrixRequest

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

destinations
نوع: Array <string| LatLng | LatLngLiteral | Place >
آرایه‌ای حاوی رشته‌های آدرس مقصد، یا LatLng ، یا اشیاء Place ، که فاصله و زمان به آن محاسبه می‌شود. ضروری.
origins
نوع: Array <string| LatLng | LatLngLiteral | Place >
آرایه ای حاوی رشته های آدرس مبدا، یا LatLng ، یا اشیاء Place ، که از آن می توان فاصله و زمان را محاسبه کرد. ضروری.
travelMode
نوع: TravelMode
نوع مسیریابی درخواستی ضروری.
avoidFerries optional
نوع: boolean optional
اگر true ، به خدمات ماتریس فاصله دستور می دهد تا در صورت امکان از کشتی اجتناب کند. اختیاری.
avoidHighways optional
نوع: boolean optional
در صورت true ، به سرویس Distance Matrix دستور می دهد تا در صورت امکان از بزرگراه ها اجتناب کند. اختیاری.
avoidTolls optional
نوع: boolean optional
در صورت true ، به سرویس Distance Matrix دستور می دهد تا در صورت امکان از جاده های عوارضی اجتناب کند. اختیاری.
drivingOptions optional
نوع: DrivingOptions optional
تنظیماتی که فقط برای درخواست‌هایی اعمال می‌شوند که در آن travelMode DRIVING است. این شی هیچ تاثیری برای سایر حالت های سفر نخواهد داشت.
language optional
نوع: string optional
شناسه زبان برای زبانی که نتایج باید در صورت امکان به آن بازگردانده شوند. لیست زبان های پشتیبانی شده را ببینید.
region optional
نوع: string optional
کد منطقه به عنوان یک سوگیری برای درخواست های کدگذاری جغرافیایی استفاده می شود. کد منطقه یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") را می پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی").
transitOptions optional
نوع: TransitOptions optional
تنظیماتی که فقط برای درخواست‌هایی اعمال می‌شوند که در آن‌ها travelMode TRANSIT است. این شی هیچ تاثیری برای سایر حالت های سفر نخواهد داشت.
unitSystem optional
نوع: UnitSystem optional
سیستم واحد ترجیحی برای استفاده هنگام نمایش فاصله. اختیاری؛ پیش فرض متریک است.

رابط DistanceMatrixResponse

google.maps . DistanceMatrixResponse رابط google.maps . DistanceMatrixResponse

پاسخ به یک درخواست DistanceMatrixService ، شامل آدرس های مبدا و مقصد قالب بندی شده، و دنباله ای از DistanceMatrixResponseRow ، یکی برای هر آدرس مبدا مربوطه.

destinationAddresses
نوع: Array <string>
آدرس های مقصد فرمت شده
originAddresses
نوع: Array <string>
آدرس های مبدا قالب بندی شده
rows
ردیف های ماتریس، مربوط به آدرس های مبدا.

رابط DistanceMatrixResponseRow

google.maps . DistanceMatrixResponseRow رابط google.maps . DistanceMatrixResponseRow

ردیفی از پاسخ به درخواست DistanceMatrixService ، متشکل از دنباله ای از DistanceMatrixResponseElement ها، یکی برای هر آدرس مقصد مربوطه.

elements
عناصر ردیف، مربوط به آدرس های مقصد.

رابط DistanceMatrixResponseElement

google.maps . DistanceMatrixResponseElement رابط google.maps . DistanceMatrixResponseElement

یک عنصر واحد از پاسخ به یک درخواست DistanceMatrixService که شامل مدت زمان و فاصله از یک مبدا تا یک مقصد است.

distance
نوع: Distance
فاصله برای این جفت شدن مبدا-مقصد. این ویژگی ممکن است تعریف نشده باشد زیرا ممکن است فاصله ناشناخته باشد.
duration
نوع: Duration
مدت زمان این جفت شدن مبدا-مقصد. این ویژگی ممکن است تعریف نشده باشد زیرا ممکن است مدت زمان آن ناشناخته باشد.
duration_in_traffic
نوع: Duration
مدت زمان این جفت شدن مبدا-مقصد، با در نظر گرفتن شرایط ترافیکی که توسط ویژگی trafficModel نشان داده شده است. این ویژگی ممکن است undefined باشد زیرا ممکن است مدت زمان آن ناشناخته باشد. فقط زمانی در دسترس مشتریان طرح Premium است که در هنگام درخواست drivingOptions تعریف شده باشد.
fare
نوع: TransitFare
کل کرایه برای این جفت مبدا-مقصد. فقط برای درخواست های حمل و نقل قابل اجرا است.
status
وضعیت این جفت مبدا-مقصد خاص.

ثابت های DistanceMatrixStatus

google.maps . DistanceMatrixStatus ثابت های google.maps . DistanceMatrixStatus

وضعیت سطح بالای درخواست به طور کلی توسط DistanceMatrixService پس از تکمیل درخواست ماتریس فاصله بازگردانده می شود. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'OK' یا google.maps.DistanceMatrixStatus.OK .

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

INVALID_REQUEST درخواست ارائه شده نامعتبر بود.
MAX_DIMENSIONS_EXCEEDED درخواست شامل بیش از 25 مبدا یا بیش از 25 مقصد است.
MAX_ELEMENTS_EXCEEDED محصول مبدا و مقصد از حد درخواستی فراتر رفته است.
OK پاسخ حاوی یک نتیجه معتبر است.
OVER_QUERY_LIMIT عناصر زیادی در بازه زمانی مجاز درخواست شده است. اگر بعد از مدتی دوباره تلاش کنید، درخواست باید با موفقیت انجام شود.
REQUEST_DENIED این سرویس استفاده از سرویس ماتریس فاصله توسط صفحه وب شما را رد کرد.
UNKNOWN_ERROR درخواست ماتریس فاصله به دلیل خطای سرور قابل پردازش نیست. اگر دوباره تلاش کنید ممکن است درخواست با موفقیت انجام شود.

ثابت های DistanceMatrixElementStatus

google.maps . DistanceMatrixElementStatus ثابت های google.maps . DistanceMatrixElementStatus

وضعیت سطح عنصر در مورد یک جفت مبدا-مقصد خاص که توسط DistanceMatrixService پس از تکمیل درخواست ماتریس فاصله بازگردانده می شود. این مقادیر به عنوان رشته ها مشخص می شوند، به عنوان مثال، 'OK' .

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

NOT_FOUND مبدا و/یا مقصد این جفت‌سازی را نمی‌توان جغرافیایی کدگذاری کرد.
OK پاسخ حاوی یک نتیجه معتبر است.
ZERO_RESULTS هیچ مسیری بین مبدا و مقصد یافت نشد.