Distance Matrix

الفئة 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

طلب بحث في مصفوفة مسافة تم إرساله من قِبل 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، يجب توجيه خدمة مصفوفة المسافة لتجنُّب الطرق السريعة قدر الإمكان. اختياريّ.
avoidTolls optional
النوع:  boolean optional
في حال استخدام true، يجب توجيه خدمة "مصفوفة المسافة" إلى خدمة تجنُّب الطرق ذات الرسوم قدر الإمكان. اختياريّ.
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

الردّ على طلب DistanceMatrixService، والذي يتألف من عنوانَي المصدر والوجهة المنسَّقين، وتسلسل من DistanceMatrixResponseRow عنوان لكل عنوان مصدر مطابق.
destinationAddresses
النوع:  Array<string>
عناوين الوجهة المنسَّقة.
originAddresses
النوع:  Array<string>
عناوين المصدر المنسَّقة
rows
صفوف المصفوفة المقابلة لعناوين المصدر.

واجهة DistanceMatrixResponseRow

واجهة google.maps.DistanceMatrixResponseRow

صف من الردّ على طلب DistanceMatrixService يتألف من تسلسل DistanceMatrixResponseElement، واحد لكل عنوان وجهة مطابق.
elements
عناصر الصف، بما يتوافق مع عناوين الوجهة.

واجهة DistanceMatrixResponseElement

واجهة google.maps.DistanceMatrixResponseElement

عنصر واحد لاستجابة لطلب DistanceMatrixService يحتوي على المدة والمسافة من مصدر واحد إلى وجهة واحدة.
distance
النوع:  Distance
المسافة للإقران بين وجهة الأصل هذا. قد تكون هذه السمة غير معرَّفة لأنّ المسافة قد تكون غير معروفة.
duration
النوع:  Duration
مدة إقران الوجهة المصدر هذا. قد تكون هذه السمة غير معرَّفة لأنّ المدة قد تكون غير معروفة.
duration_in_traffic
النوع:  Duration
مدة إقران الوجهة والمنشأ هذا، مع الأخذ في الاعتبار ظروف الزيارات التي تشير إليها السمة trafficModel. قد تكون هذه السمة undefined لأنّ المدة قد تكون غير معروفة. تتوفر فقط لعملاء الخطة المميزة عند تحديد drivingOptions عند تقديم الطلب.
fare
النوع:  TransitFare
السعر الإجمالي للإقران بين نقطة الانطلاق والوجهة. ينطبق فقط على طلبات النقل العام.
status
حالة هذا إقران الوجهة المصدر تحديدًا.

ثابت 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 ثابت

الحالة على مستوى العنصر لإقران وجهة معيّنة بين المصدر والوجهة التي تعرضها السمة DistanceMatrixService عند إكمال طلب مصفوفة المسافة. ويتم تحديد هذه القيم كسلاسل، مثل 'OK'.

يمكنك الوصول من خلال الاتصال على الرقم const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
NOT_FOUND تعذر الترميز الجغرافي لأصل و/أو وجه هذا الاقتران.
OK ويحتوي الرد على نتيجة صالحة.
ZERO_RESULTS تعذر العثور على مسار بين نقطة الانطلاق والوجهة.