Distance Matrix

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

DISTANCEMatrixService فئة

google.maps.DistanceMatrixService الصف الدراسي

خدمة لحوسبة المسافات بين الأصول والوجهات المتعددة.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {DistanceMatrixService} = await google.map.importLibrary("routes"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
DistanceMatrixService
DistanceMatrixService()
المعلّمات: بدون
لإنشاء مثيل جديد من DistanceMatrixService يرسل طلبات بحث مصفوفة المسافة إلى خوادم Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
المعلّمات:
قيمة الإرجاع: Promise<DistanceMatrixResponse>
إصدار طلب مصفوفة المسافة

واجهة MomtrixRequest

واجهة 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
نظام الوحدة المفضل لاستخدامه عند عرض المسافة. اختياري، ويتم تعيينه تلقائيًا على المقياس.

واجهة MartrixResponse

واجهة google.maps.DistanceMatrixResponse

تمثل هذه الخاصية الاستجابة لطلب DistanceMatrixService، وتتألف من عنوان URL الأصلي وعنوان الوجهة، وتسلسل 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.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {DistanceMatrixStatus} = await google.map.importLibrary("routes"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
INVALID_REQUEST الطلب المقدم غير صالح.
MAX_DIMENSIONS_EXCEEDED يحتوي الطلب على أكثر من 25 نقطة انطلاق أو أكثر من 25 وجهة.
MAX_ELEMENTS_EXCEEDED يتجاوز ناتج الأصول والوجهات الحدّ الأقصى المسموح به لكل طلب بحث.
OK تحتوي الاستجابة على نتيجة صالحة.
OVER_QUERY_LIMIT تم طلب عدد كبير جدًا من العناصر خلال الفترة الزمنية المسموح بها. من المفترض أن ينجح الطلب في حال إعادة المحاولة بعد فترة من الوقت.
REQUEST_DENIED رفضت الخدمة استخدام خدمة مصفوفة المسافات في صفحتك على الويب.
UNKNOWN_ERROR تعذرت معالجة طلب مصفوفة المسافة بسبب حدوث خطأ في الخادم. قد ينجح الطلب في حال إعادة المحاولة.

ثوابت مسافةMatrixElementStatus

google.maps.DistanceMatrixElementStatus ثوابت

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {DistanceMatrixElementStatus} = await google.map.importLibrary("routes"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
NOT_FOUND تعذر إجراء ترميز جغرافي لمنشأ و/أو وجهة هذا الإقران.
OK تحتوي الاستجابة على نتيجة صالحة.
ZERO_RESULTS تعذر العثور على أي مسار بين نقطة الانطلاق والوجهة.