ComputeCustomRoutesResponse

رسالة الاستجابة v1alpha.computeCustomRoutes.

تمثيل JSON 
{
  "routes": [
    {
      object (CustomRoute)
    }
  ],
  "fastestRoute": {
    object (CustomRoute)
  },
  "shortestRoute": {
    object (CustomRoute)
  },
  "fallbackInfo": {
    object (FallbackInfo)
  }
}
الحقول
routes[]

object (CustomRoute)

"أفضل" المسارات لهدف مسار الإدخال.
fastestRoute

object (CustomRoute)

أسرع مسار مرجعي.
shortestRoute

object (CustomRoute)

أقصر مسار مرجعي.
fallbackInfo

object (FallbackInfo)

المعلومات الاحتياطية للمسارات المخصصة

CustomRoute

يتضمّن هذا القسم مسارًا مخصّصًا تم احتسابه استنادًا إلى هدف المسار الذي حدّده العميل. يحتوي CustomRoute على مسار ورمز مميز للمسار، يمكن تمريرهما إلى NavSDK لإعادة إنشاء المسار المخصص للتنقل منعطفًا بمنعطف.

تمثيل JSON 
{
  "route": {
    object (Route)
  },
  "token": string
}
الحقول
route

object (Route)

المسار الذي يُعتبر "الأفضل" لهدف مسار الإدخال.
token

string

رمز المسار المشفر base64 الآمن على الويب الذي يمكن تمريره إلى NavSDK، والذي يسمح NavSDK بإعادة إنشاء المسار أثناء التنقل، وفي حال إعادة التوجيه، يتم الالتزام بالهدف الأصلي عند استدعاء RoutesPreferred v1alpha.computeCustomRoutes. ويجب أن يتعامل العملاء مع هذا الرمز المميّز على أنّه كائن ثنائي كبير مبهم.

FallbackInfo

يتضمّن هذا القسم معلومات احتياطية لـ v1alpha.computeCustomRoutes. ينفذ v1alpha.computeCustomRoutes نوعين من الإجراءات الاحتياطية:

  1. وفي حال لم يتمكّن المطوّر من احتساب المسار باستخدام الإعدادات المفضَّلة التي يطلبها العميل، سيتم الرجوع إلى وضع توجيه آخر. في هذه الحالة، يتم استخدام fallback_routing_mode وroute_mode_fallback_reason للإشارة إلى وضع التوجيه الاحتياطي المستخدم، بالإضافة إلى سبب التراجع.

  2. إذا لم تتمكن من حساب قيمة "الأفضل" لهدف المسار الذي حدده العميل، فقد يرجع إلى هدف آخر. يتم استخدام fallback_route_objective للإشارة إلى هدف المسار الاحتياطي.

تمثيل JSON 
{
  "routingMode": enum (FallbackRoutingMode),
  "routingModeReason": enum (FallbackReason),
  "routeObjective": enum (FallbackRouteObjective)
}
الحقول
routingMode

enum (FallbackRoutingMode)

وضع التوجيه المستخدم للاستجابة. إذا تم تفعيل إجراء احتياطي، قد يختلف الوضع عن الإعدادات المفضّلة للتوجيه التي تم ضبطها في طلب العميل الأصلي.
routingModeReason

enum (FallbackReason)

السبب في استخدام الردّ الاحتياطي بدلاً من الردّ الأصلي. لا تتم تعبئة هذا الحقل إلا عند تفعيل الوضع الاحتياطي وعرض الاستجابة الاحتياطية.
routeObjective

enum (FallbackRouteObjective)

هدف المسار المستخدم للرد. في حال تفعيل إجراء احتياطي، قد يكون الهدف مختلفًا عن هدف المسار المقدَّم في طلب العميل الأصلي.