RouteMatrixElement

تُحاط معلومات المسار المحسوبة لزوج من نقاط المصدر/الوجهة في ComputeRouteMatrix API. يمكن بث هذا الإجراء إلى العميل.

تمثيل JSON 
{
  "originIndex": integer,
  "destinationIndex": integer,
  "status": {
    object (Status)
  },
  "condition": enum (RouteMatrixElementCondition),
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "fallbackInfo": {
    object (FallbackInfo)
  }
}
الحقول
originIndex

integer

فهرس مبني على صفر للمنشأ في الطلب.
destinationIndex

integer

فهرس يستند إلى صفر للوجهة في الطلب.
status

object (Status)

رمز حالة الخطأ لهذا العنصر.
condition

enum (RouteMatrixElementCondition)

يشير إلى ما إذا كان قد تم العثور على المسار أم لا. مستقلة عن الحالة.
distanceMeters

integer

مسافة السفر للمسار، بالأمتار.
duration

string (Duration format)

طول الفترة الزمنية اللازمة للتنقل في المسار. إذا ضبطت القيمة routingPreference على TRAFFIC_UNAWARE، ستكون هذه القيمة هي نفسها القيمة staticDuration. إذا تم ضبط routingPreference على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL، سيتم احتساب هذه القيمة مع مراعاة أحوال حركة المرور.

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
staticDuration

string (Duration format)

مدة التنقّل خلال المسار بدون مراعاة أحوال حركة المرور.

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
travelAdvisory

object (RouteTravelAdvisory)

معلومات إضافية حول المسار على سبيل المثال: معلومات القيود ومعلومات الرسوم
fallbackInfo

object (FallbackInfo)

في بعض الحالات عندما لا يتمكن الخادم من حساب المسار باستخدام التفضيلات المحددة لهذا الزوج من نقطة الانطلاق/الوجهة، قد يعود إلى استخدام وضع حساب مختلف. عند استخدام الوضع الاحتياطي، يحتوي هذا الحقل على معلومات تفصيلية حول الاستجابة الاحتياطية. وبخلاف ذلك، يتم إلغاء ضبط هذا الحقل.

الحالة

يحدِّد نوع Status نموذج خطأ منطقيًا مناسبًا لبيئات البرمجة المختلفة، بما في ذلك واجهات برمجة التطبيقات REST وRPC. وتُستخدَم من قِبل gRPC. تحتوي كل رسالة Status على ثلاث قطع من البيانات: رمز الخطأ ورسالة الخطأ وتفاصيل الخطأ.

يمكنك الاطّلاع على مزيد من المعلومات عن نموذج الأخطاء هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات.

تمثيل JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
الحقول
code

integer

رمز الحالة الذي يجب أن يكون قيمة google.rpc.Code في التعداد
message

string

رسالة خطأ موجّهة للمطوّرين، ويجب أن تكون باللغة الإنجليزية. يجب ترجمة أي رسالة خطأ تظهر للمستخدم وإرسالها في الحقل google.rpc.Status.details، أو ترجمتها من خلال البرنامج.
details[]

object

قائمة بالرسائل التي تتضمّن تفاصيل الخطأ هناك مجموعة شائعة من أنواع الرسائل لاستخدام واجهات برمجة التطبيقات.

عنصر يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي "@type" على معرف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }