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 interface

طلب بحث عن مصفوفة المسافة أرسله 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، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز ccTLD الخاص بالمملكة المتحدة هو "uk" (.co.uk)، بينما رمز ISO 3166-1 هو "gb" (وهو يشير من الناحية الفنية إلى "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
transitOptions optional
النوع:  TransitOptions optional
الإعدادات التي تنطبق فقط على الطلبات التي تكون فيها قيمة travelMode هي TRANSIT لن يكون لهذا العنصر أي تأثير في وسائل النقل الأخرى.
unitSystem optional
النوع:  UnitSystem optional
نظام الوحدات المفضّل استخدامه عند عرض المسافة اختياري، ويتم ضبطه تلقائيًا على المقياس.

DistanceMatrixResponse interface

google.maps.DistanceMatrixResponse interface

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

DistanceMatrixResponseRow interface

google.maps.DistanceMatrixResponseRow interface

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

DistanceMatrixResponseElement interface

google.maps.DistanceMatrixResponseElement interface

عنصر واحد من الردّ على طلب 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 لم يتم العثور على أي مسار بين نقطة الانطلاق والوجهة.