Route Matrix

فئة RouteMatrix

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

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

يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم ‎const {RouteMatrix} = await google.maps.importLibrary("routes").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
computeRouteMatrix
computeRouteMatrix(request)
المَعلمات: 
القيمة المعروضة:  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
مصفوفة من الوجهات تحدّد أعمدة مصفوفة الاستجابة قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز Plus Code أو اسم مورد مكان. لا يتم أخذ قيم الارتفاع في الاعتبار.
fields
النوع:  Iterable<string>
مجموعة من الحقول المطلوب جلبها حدِّد ["*"] لجميع الحقول.
origins
مصفوفة من نقاط الانطلاق، والتي تحدّد صفوف مصفوفة الاستجابة. قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز 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
قائمة بالعمليات الحسابية الإضافية التي يمكن استخدامها لإكمال الطلب

ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في 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
الموقع الجغرافي لنقطة الانطلاق قد تكون القيمة التي تم تمريرها كسلسلة عنوانًا أو رمز Plus Code. لا يتم أخذ قيم الارتفاع في الاعتبار.
routeModifiers optional
النوع:  RouteModifiers optional
معدِّلات لكل مسار يتّخذ هذا الموقع الجغرافي كنقطة انطلاق