يتضمّن هذا القسم معلومات المسار المحسوبة لزوج المصدر/الوجهة في واجهة برمجة التطبيقات v1alpha.computeRouteMatrix. يمكن بث هذا النموذج الأولي إلى العميل.
تمثيل JSON |
---|
{ "originIndex": integer, "destinationIndex": integer, "status": { object ( |
الحقول | |
---|---|
originIndex |
فهرس مبني على صفر للمنشأ في الطلب. |
destinationIndex |
فهرس يستند إلى صفر للوجهة في الطلب. |
status |
رمز حالة خطأ لهذا العنصر. |
condition |
يشير إلى ما إذا كان قد تم العثور على المسار أم لا. مستقلة عن الحالة. |
distanceMeters |
مسافة السفر للمسار، بالأمتار. |
duration |
طول الفترة الزمنية اللازمة للتنقل في المسار. في حال ضبط مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
staticDuration |
مدة التنقّل خلال المسار بدون مراعاة أحوال حركة المرور. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
travelAdvisory |
معلومات إضافية حول المسار على سبيل المثال: معلومات عن القيود المفروضة على رسوم العبور ومعلومات عن رسوم العبور |
fallbackInfo |
في بعض الحالات عندما لا يتمكن الخادم من حساب المسار باستخدام التفضيلات المحددة لهذا الزوج من نقطة الانطلاق/الوجهة، قد يعود إلى استخدام وضع حساب مختلف. عند استخدام الوضع الاحتياطي، يحتوي هذا الحقل على معلومات تفصيلية حول الاستجابة الاحتياطية. وبخلاف ذلك، يتم إلغاء ضبط هذا الحقل. |
الحالة
يحدّد النوع Status
نموذج خطأ منطقي مناسبًا لبيئات البرمجة المختلفة، بما في ذلك واجهات برمجة تطبيقات REST وواجهات برمجة تطبيقات RPC. وتُستخدَم من قِبل gRPC. تحتوي كل رسالة Status
على ثلاث بيانات: رمز الخطأ ورسالة الخطأ وتفاصيل الخطأ.
يمكنك معرفة المزيد من المعلومات عن نموذج الخطأ هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات.
تمثيل JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
الحقول | |
---|---|
code |
رمز الحالة، الذي يجب أن يكون قيمة تعداد بقيمة |
message |
رسالة خطأ مواجهة للمطوِّر، ويجب أن تكون باللغة الإنجليزية يجب ترجمة أي رسالة خطأ تظهر للمستخدم وإرسالها في الحقل |
details[] |
قائمة بالرسائل التي تتضمّن تفاصيل الخطأ. وهناك مجموعة شائعة من أنواع الرسائل التي يمكن لواجهات برمجة التطبيقات استخدامها. كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي |