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. على العملاء التعامل مع هذا الرمز المميّز على أنّه كائن ثنائي كبير (blob) مبهم.

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)

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