Route Matrix

فئة RouteMatrix

صف واحد (google.maps.routes.RouteMatrix)

مصفوفة من المسارات المحسوبة لمجموعة من أزواج نقاط الانطلاق/الوجهات حسب RouteMatrix.computeRouteMatrix

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {RouteMatrix} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الطرق الثابتة

computeRouteMatrix

computeRouteMatrix(request) المَعلمات:  request:  ComputeRouteMatrixRequest القيمة المعروضة:  Promise<{matrix:RouteMatrix}> تأخذ هذه الدالة قائمة بنقاط الانطلاق والوجهات وتعرض مصفوفة تحتوي على معلومات المسار لكل مجموعة من نقاط الانطلاق والوجهات. ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الاستجابة في الطلب من خلال ضبط السمة ComputeRouteMatrixRequest.fields. القيمة هي قائمة بمسارات الحقول. على سبيل المثال: قناع الحقل لجميع الحقول المتاحة: fields: ['*'] قناع حقل المدة والمسافة على مستوى المسار: fields: ['durationMillis', 'distanceMeters'] لا يُنصح باستخدام قناع حقل الاستجابة الشامل fields: ['*'] للأسباب التالية: يساعد اختيار الحقول التي تحتاج إليها فقط خادمنا في توفير دورات الحوسبة، ما يتيح لنا عرض النتيجة لك بوقت استجابة أقل. يضمن اختيار الحقول التي تحتاجها فقط في مهمة الإنتاج أداءً مستقرًا لوقت الاستجابة. قد نضيف المزيد من حقول الاستجابة في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. إذا اخترت جميع الحقول، أو إذا اخترت جميع الحقول في المستوى الأعلى، قد ينخفض مستوى الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ. يؤدي اختيار الحقول التي تحتاج إليها فقط إلى حجم استجابة أصغر، وبالتالي تحميل أسرع عبر الشبكة.

الخصائص
rows	النوع:  Array<RouteMatrixRow> صفوف المصفوفة يتوافق كل صف مع نقطة انطلاق ويحتوي على مصفوفة من RouteMatrixItem، يمثّل كل منها مسارًا إلى وجهة.

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى كائن.

فئة RouteMatrixRow

صف واحد (google.maps.routes.RouteMatrixRow)

يتوافق مع مصدر تم تمريره إلى RouteMatrix.computeRouteMatrix. يحتوي على قائمة من RouteMatrixItem، ويمثّل كل عنصر مسارًا إلى وجهة معيّنة.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {RouteMatrixRow} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الخصائص
items	النوع:  Array<RouteMatrixItem> معلومات المسار لكل وجهة

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى كائن.

فئة RouteMatrixItem

صف واحد (google.maps.routes.RouteMatrixItem)

يحتوي على معلومات المسار التي تم احتسابها لزوج من نقطة الانطلاق والوجهة تم تمريره إلى RouteMatrix.computeRouteMatrix.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {RouteMatrixItem} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الخصائص
condition	النوع:  RouteMatrixItemCondition optional يشير إلى ما إذا تم العثور على المسار أم لا.
distanceMeters	النوع:  number optional مسافة السفر للمسار بالأمتار
durationMillis	النوع:  number optional المدة الزمنية اللازمة للتنقّل في المسار بالملي ثانية إذا ضبطت السمة ComputeRouteMatrixRequest.routingPreference على TRAFFIC_UNAWARE، ستكون هذه القيمة مماثلة للسمة RouteMatrixItem.staticDurationMillis. إذا ضبطت ComputeRouteMatrixRequest.routingPreference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL، يتم احتساب هذه القيمة مع مراعاة أحوال حركة المرور. ملاحظة: إذا تجاوزت المدة 2^53 ملي ثانية، تكون هذه القيمة Number.POSITIVE_INFINITY.
error	النوع:  RouteMatrixItemError optional الخطأ الذي حدث أثناء احتساب المسار
fallbackInfo	النوع:  FallbackInfo optional في بعض الحالات التي لا يتمكّن فيها الخادم من احتساب المسار باستخدام الإعدادات المفضّلة المحدّدة لزوج نقطة الانطلاق/الوجهة هذا، قد يعود إلى استخدام وضع احتساب مختلف. عند استخدام ردّ احتياطي، يحتوي هذا الحقل على معلومات تفصيلية عنه. وإلا، لن يتم ضبط هذا الحقل.
localizedValues	النوع:  RouteMatrixItemLocalizedValues optional تمثيلات نصية لسمات RouteMatrixItem
staticDurationMillis	النوع:  number optional مدة السفر عبر المسار بدون أخذ أحوال حركة المرور في الاعتبار ملاحظة: إذا تجاوزت المدة 2^53 ملي ثانية، تكون هذه القيمة Number.POSITIVE_INFINITY.
travelAdvisory	النوع:  RouteTravelAdvisory optional معلومات إضافية حول المسار

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى كائن.

ComputeRouteMatrixRequest

واجهة google.maps.routes.ComputeRouteMatrixRequest

طلب مصفوفة مسارات

الخصائص
destinations	النوع:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint> مصفوفة من الوجهات تحدّد أعمدة مصفوفة الاستجابة قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز Plus Code أو اسم مورد مكان. لا يتم أخذ قيم الارتفاع في الاعتبار.
fields	النوع:  Iterable<string> مجموعة من الحقول المطلوب جلبها حدِّد ["*"] لجميع الحقول.
origins	النوع:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint> مصفوفة من نقاط الانطلاق، والتي تحدّد صفوف مصفوفة الاستجابة. قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز Plus Code أو اسم مورد مكان. لا يتم أخذ قيم الارتفاع في الاعتبار. تنطبق عدة قيود على حجم عدد القيم الفريدة لنقاط الانطلاق والوجهات: يجب ألا يزيد إجمالي عدد نقاط الانطلاق والوجهات المحدّدة على شكل string أو Place عن 50. يجب ألا يزيد حاصل ضرب عدد نقاط الانطلاق في عدد الوجهات عن 625. يجب ألا يزيد حاصل ضرب عدد نقاط الانطلاق والوجهات عن 100 إذا تم ضبط ComputeRouteMatrixRequest.routingPreference على TRAFFIC_AWARE_OPTIMAL. يجب ألا يزيد حاصل ضرب عدد نقاط الانطلاق والوجهات عن 100 إذا تم ضبط ComputeRouteMatrixRequest.travelMode على TRANSIT.
arrivalTime optional	النوع:  Date optional وقت الوصول ملاحظة: لا يمكن ضبط هذه السمة إلا عند ضبط ComputeRouteMatrixRequest.travelMode على TRANSIT. يمكنك تحديد ComputeRouteMatrixRequest.departureTime أو ComputeRouteMatrixRequest.arrivalTime، ولكن ليس كليهما. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل.
departureTime optional	النوع:  Date optional وقت المغادرة إذا لم تضبط هذه القيمة، يتم ضبطها تلقائيًا على وقت تقديم الطلب. ملاحظة: يمكنك تحديد وقت في الماضي فقط عندما يتم ضبط ComputeRouteMatrixRequest.travelMode على TRANSIT. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل.
extraComputations optional	النوع:  Iterable<ComputeRouteMatrixExtraComputation> optional قائمة بالعمليات الحسابية الإضافية التي يمكن استخدامها لإكمال الطلب ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في ComputeRouteMatrixRequest.fields ليتم عرضها في الاستجابة.
language optional	النوع:  string optional رمز اللغة المستخدَمة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على معرّف لغة Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتوافقة. في حال عدم تقديم هذه القيمة، يتم استنتاج اللغة من إعدادات الأقلمة في Google Maps JavaScript API. وإلا، يتم استنتاج اللغة من الموقع الجغرافي للمصدر الأول.
region optional	النوع:  string optional رمز المنطقة، ويتم تحديده كقيمة مكوّنة من حرفَين لنطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد. في حال عدم تقديم هذه القيمة، يتم استنتاج المنطقة من إعدادات الأقلمة في Google Maps JavaScript API. وإلا، يتم استنتاج المنطقة من الموقع الجغرافي للمصدر الأول.
routingPreference optional	النوع:  RoutingPreference optional تحدّد هذه السمة كيفية حساب مصفوفة المسارات. يحاول الخادم استخدام الإعداد المفضّل للمسار المحدّد لحساب مصفوفة المسار. إذا أدّى خيار التوجيه المفضّل إلى حدوث خطأ أو وقت استجابة طويل جدًا، يتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة ComputeRouteMatrixRequest.travelMode هي DRIVING أو TWO_WHEELER، وإلا سيتعذّر تنفيذ الطلب.
trafficModel optional	النوع:  TrafficModel optional تحدّد هذه المَعلمة الافتراضات التي يجب استخدامها عند احتساب الوقت في حركة المرور. يؤثر هذا الإعداد في القيمة المعروضة في RouteMatrixItem.durationMillis التي تحتوي على الوقت المتوقّع في حركة المرور استنادًا إلى المتوسطات السابقة. لا يتوفّر ComputeRouteMatrixRequest.trafficModel إلا للطلبات التي تم ضبط ComputeRouteMatrixRequest.routingPreference فيها على TRAFFIC_AWARE_OPTIMAL وComputeRouteMatrixRequest.travelMode على DRIVING. القيمة التلقائية هي BEST_GUESS.
transitPreference optional	النوع:  TransitPreference optional تحدّد هذه السمة الإعدادات المفضّلة التي تؤثّر في المسار الذي يتم عرضه لمسارات TRANSIT. ملاحظة: لا يمكن تحديد هذه السمة إلا عند ضبط ComputeRouteMatrixRequest.travelMode على TRANSIT.
travelMode optional	النوع:  TravelMode optional تحدّد هذه السمة وسيلة النقل.
units optional	النوع:  UnitSystem optional يحدّد هذا الإعداد وحدات القياس لحقول العرض. إذا لم تقدّم هذه القيمة، يتم استنتاج وحدات العرض من الموقع الجغرافي للمصدر الأول.

ثوابت ComputeRouteMatrixExtraComputation

ذكرياتك الثابتة في شهر google.maps.routes.ComputeRouteMatrixExtraComputation

عمليات حسابية إضافية يجب إجراؤها لطلب RouteMatrix.computeRouteMatrix.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الثوابت
TOLLS	معلومات رسوم المرور لعناصر المصفوفة

ثوابت RouteMatrixItemCondition

ذكرياتك الثابتة في شهر google.maps.routes.RouteMatrixItemCondition

حالة المسار لزوج معيّن من نقطة الانطلاق والوجهة

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الثوابت
ROUTE_EXISTS	تم العثور على مسار.
ROUTE_NOT_FOUND	تعذّر العثور على أي مسار.

فئة RouteMatrixItemError

صف واحد (google.maps.routes.RouteMatrixItemError)

خطأ حدث أثناء RouteMatrix.computeRouteMatrix لزوج محدّد من المصدر والوجهة

هذه الفئة هي امتداد لـ Error.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى كائن.

فئة RouteMatrixItemLocalizedValues

صف واحد (google.maps.routes.RouteMatrixItemLocalizedValues)

تمثيلات نصية لـ RouteMatrixItem.

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.

الخصائص
distance	النوع:  string optional تمثّل هذه السمة مسافة السفر لعنصر مصفوفة المسارات في شكل نصي.
distanceLanguage	النوع:  string optional رمز اللغة المستخدَمة في نص المسافة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration	النوع:  string optional تمثّل هذه السمة المدة في شكل نصي ومترجَمة إلى لغة منطقة طلب البحث. يأخذ أحوال حركة المرور في الاعتبار. ملاحظة: إذا لم تطلب معلومات عن حركة المرور، ستكون هذه القيمة هي نفسها قيمة RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage	النوع:  string optional رمز اللغة المستخدَمة في نص المدة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration	النوع:  string optional المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم تمثيلها في شكل نصي
staticDurationLanguage	النوع:  string optional رمز اللغة المستخدَمة في نص المدة الثابت وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn".
transitFare	النوع:  string optional تمثّل هذه السمة أجرة النقل العام في شكل نص.
transitFareLanguage	النوع:  string optional رمز اللغة BCP-47 لنص أجرة النقل العام، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

الطُرق
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Object يتم تحويله إلى كائن.

واجهة RouteMatrixOrigin

واجهة google.maps.routes.RouteMatrixOrigin

مصدر واحد لـ ComputeRouteMatrixRequest

الخصائص
waypoint	النوع:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint الموقع الجغرافي لنقطة الانطلاق قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز Plus Code. لا يتم أخذ قيم الارتفاع في الاعتبار.
routeModifiers optional	النوع:  RouteModifiers optional معدِّلات لكل مسار يتّخذ هذا الموقع الجغرافي كنقطة انطلاق