Distance Matrix (deprecated)

فئة DistanceMatrixService

google.maps.DistanceMatrixService صف
مكتبة "routes" 

const {DistanceMatrixService} = await google.maps.importLibrary("routes");
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
اختياري
النوع: boolean optional
إذا كانت القيمة true، يتم توجيه خدمة Distance Matrix لتجنُّب العبّارات حيثما أمكن. اختيارية:
avoidHighways
اختياري
النوع: boolean optional
إذا كانت القيمة true، يتم توجيه خدمة Distance Matrix لتجنّب الطرق السريعة حيثما أمكن. اختيارية:
avoidTolls
اختياري
النوع: boolean optional
إذا كانت القيمة true، يتم توجيه خدمة Distance Matrix لتجنُّب الطرق برسوم عبور حيثما أمكن. اختيارية:
drivingOptions
اختياري
النوع: DrivingOptions optional
الإعدادات التي تنطبق فقط على الطلبات التي تكون فيها قيمة travelMode هي DRIVING. لن يكون لهذا العنصر أي تأثير في أوضاع السفر الأخرى.
language
اختياري
النوع: string optional
معرّف اللغة التي يجب عرض النتائج بها، إن أمكن ذلك. اطّلِع على قائمة اللغات المتاحة.
region
اختياري
النوع: string optional
رمز المنطقة المستخدَم كتحيّز لطلبات الترميز الجغرافي يقبل رمز المنطقة قيمة ccTLD ("نطاق المستوى الأعلى") المكوّنة من حرفَين. تتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق المستوى الأعلى الذي يمثّل رمز البلد للمملكة المتحدة هو "uk"‏ (.co.uk)، في حين أنّ رمز ISO 3166-1 هو "gb" (من الناحية الفنية لكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
transitOptions
اختياري
النوع: TransitOptions optional
الإعدادات التي تنطبق فقط على الطلبات التي يكون فيها travelMode هو TRANSIT. لن يكون لهذا العنصر أي تأثير في أوضاع السفر الأخرى.
unitSystem
اختياري
النوع: 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 ثوابت
مكتبة "routes"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع DistanceMatrixStatusString.

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

ثوابت DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus ثوابت
مكتبة "routes"

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

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع DistanceMatrixElementStatusString.

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