ComputeCustomRoutesResponse

رسالة استجابة 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 ComputeCustomRoutes. يجب أن يتعامل العملاء مع هذا الرمز المميّز على أنّه كتلة غير شفافة.

FallbackInfo

تُستخدم لتضمين معلومات النسخ الاحتياطي لـ ComputeCustomRoutes. تُجري ComputeCustomRoutes نوعَين من عمليات النسخ الاحتياطي:

  1. وإذا لم يتمكّن من احتساب المسار باستخدام routingPreference الذي طلبه العميل، سيتم الرجوع إلى وضع توجيه آخر. في هذه الحالة، يتم استخدام fallback_routing_mode وrouting_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)

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