رسالة الاستجابة v1alpha.computeCustomRoutes.
تمثيل JSON |
---|
{ "routes": [ { object ( |
الحقول | |
---|---|
routes[] |
"أفضل" المسارات لهدف مسار الإدخال. |
fastestRoute |
أسرع مسار مرجعي. |
shortestRoute |
أقصر مسار مرجعي. |
fallbackInfo |
المعلومات الاحتياطية للمسارات المخصصة |
CustomRoute
يتضمّن هذا القسم مسارًا مخصّصًا تم احتسابه استنادًا إلى هدف المسار الذي حدّده العميل. يحتوي CustomRoute على مسار ورمز مميز للمسار، يمكن تمريرهما إلى NavSDK لإعادة إنشاء المسار المخصص للتنقل منعطفًا بمنعطف.
تمثيل JSON |
---|
{
"route": {
object ( |
الحقول | |
---|---|
route |
المسار الذي يُعتبر "الأفضل" لهدف مسار الإدخال. |
token |
رمز المسار المشفر base64 الآمن على الويب الذي يمكن تمريره إلى NavSDK، والذي يسمح NavSDK بإعادة إنشاء المسار أثناء التنقل، وفي حال إعادة التوجيه، يتم الالتزام بالهدف الأصلي عند استدعاء RoutesPreferred v1alpha.computeCustomRoutes. ويجب أن يتعامل العملاء مع هذا الرمز المميّز على أنّه كائن ثنائي كبير مبهم. |
FallbackInfo
يتضمّن هذا القسم معلومات احتياطية لـ v1alpha.computeCustomRoutes. ينفذ v1alpha.computeCustomRoutes نوعين من الإجراءات الاحتياطية:
وفي حال لم يتمكّن المطوّر من احتساب المسار باستخدام الإعدادات المفضَّلة التي يطلبها العميل، سيتم الرجوع إلى وضع توجيه آخر. في هذه الحالة، يتم استخدام fallback_routing_mode وroute_mode_fallback_reason للإشارة إلى وضع التوجيه الاحتياطي المستخدم، بالإضافة إلى سبب التراجع.
إذا لم تتمكن من حساب قيمة "الأفضل" لهدف المسار الذي حدده العميل، فقد يرجع إلى هدف آخر. يتم استخدام fallback_route_objective للإشارة إلى هدف المسار الاحتياطي.
تمثيل JSON |
---|
{ "routingMode": enum ( |
الحقول | |
---|---|
routingMode |
وضع التوجيه المستخدم للاستجابة. إذا تم تفعيل إجراء احتياطي، قد يختلف الوضع عن الإعدادات المفضّلة للتوجيه التي تم ضبطها في طلب العميل الأصلي. |
routingModeReason |
السبب في استخدام الردّ الاحتياطي بدلاً من الردّ الأصلي. لا تتم تعبئة هذا الحقل إلا عند تفعيل الوضع الاحتياطي وعرض الاستجابة الاحتياطية. |
routeObjective |
هدف المسار المستخدم للرد. في حال تفعيل إجراء احتياطي، قد يكون الهدف مختلفًا عن هدف المسار المقدَّم في طلب العميل الأصلي. |