Distance Matrix

فئة DistanceMatrixService

google.maps.DistanceMatrixService class

خدمة لاحتساب المسافات بين نقاط الانطلاق والوجهات المتعددة

يمكنك الوصول إليه من خلال الاتصال بالرقم const {DistanceMatrixService} = await google.maps.importLibrary("routes"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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، تُوجّه خدمة Distance Matrix إلى تجنُّب العبّارات كلما أمكن ذلك. اختيارية:
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) المكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
INVALID_REQUEST الطلب المقدَّم غير صالح.
MAX_DIMENSIONS_EXCEEDED يحتوي الطلب على أكثر من 25 نقطة انطلاق أو أكثر من 25 وجهة.
MAX_ELEMENTS_EXCEEDED يتجاوز حاصل نقاط الانطلاق والوجهات الحدّ الأقصى لكلّ طلب بحث.
OK يحتوي الردّ على نتيجة صالحة.
OVER_QUERY_LIMIT تم طلب عدد كبير جدًا من العناصر خلال الفترة الزمنية المسموح بها. من المفترض أن ينجح الطلب إذا حاولت مرة أخرى بعد مرور بعض الوقت.
REQUEST_DENIED رفضت الخدمة استخدام صفحة الويب لخدمة Distance Matrix.
UNKNOWN_ERROR تعذّرت معالجة طلب مصفوفة المسافات بسبب خطأ في الخادم. قد ينجح الطلب إذا حاولت مرة أخرى.

DistanceMatrixElementStatus الثوابت

google.maps.DistanceMatrixElementStatus الثوابت

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

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