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 |
النوع:
Array<DistanceMatrixResponseRow> صفوف المصفوفة المقابلة لعناوين المصدر. |
واجهة DISTANCEMatrixResponseRow
واجهة
google.maps.DistanceMatrixResponseRow
صف من الاستجابة لطلب DistanceMatrixService
، يتكون من تسلسل DistanceMatrixResponseElement
، واحد لكل عنوان وجهة مقابل.
أماكن إقامة | |
---|---|
elements |
النوع:
Array<DistanceMatrixResponseElement> عناصر الصف المقابلة لعناوين الوجهة. |
واجهة DISTANCEMatrixResponseElement
واجهة
google.maps.DistanceMatrixResponseElement
عنصر واحد في الرد على طلب DistanceMatrixService
يحتوي على المدة والمسافة من أصل واحد إلى وجهة واحدة.
أماكن إقامة | |
---|---|
distance |
النوع:
Distance المسافة لإقران نقطة الانطلاق هذه قد تكون هذه الخاصية غير معرفة لأن المسافة قد تكون غير معروفة. |
duration |
النوع:
Duration مدة إقران نقطة الانطلاق هذه. قد تكون هذه الخاصية غير معرفة لأن المدة قد تكون غير معروفة. |
duration_in_traffic |
النوع:
Duration مدة هذا الإقران للوجهة الأصلية، مع مراعاة ظروف الزيارات المُشار إليها من خلال السمة trafficModel . قد تكون هذه الخاصية undefined لأن المدة قد تكون غير معروفة. لا يتوفّر العرض إلا لعملاء الخطة المميزة عند تحديد drivingOptions عند تقديم الطلب. |
fare |
النوع:
TransitFare السعر الإجمالي لإقران نقطة الانطلاق هذه ينطبق فقط على طلبات النقل العام. |
status |
النوع:
DistanceMatrixElementStatus حالة هذا الإقران المحدّد أصل الوجهة. |
ثوابت 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 |
تعذر العثور على أي مسار بين نقطة الانطلاق والوجهة. |