معالجة الأخطاء

يصف هذا الدليل كيفية تحديد مشاكل أخطاء الحمولة ومشاكل خلاصة البيانات وحلّها عند استخدام Navigation Connect.

لم يتم تلقّي الحالة ENROUTE

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

إذا بقيت الحالة NEW، قد يمنع جهاز السائق المصادقة. بما أنّ Navigation Connect لا يرسل رسائل خطأ في هذه الحالات، تحقَّق من السيناريوهات التالية:

• إذا لم يتمكّن تطبيق التنقّل من العثور على الوجهة، تأكَّد من أنّك مرّرت وجهة صالحة في عنوان URL الخاص بالإطلاق.
• إذا لم يكن هناك مسار صالح، تأكَّد من أنّ نقطة الانطلاق والوجهة صحيحتان ويمكن الوصول إليهما عن طريق البر.
• إذا تعذّرت مصادقة الجلسة، تحقَّق من وجود أخطاء إملائية في مَعلمات واجهة برمجة التطبيقات أو من انتهاء صلاحية رمز الرحلة في ردّ CreateTrip.
• إذا بقيت الحالة NEW بعد التحقّق من السيناريوهات أعلاه، اطلب من السائق تفعيل الموقع الجغرافي الدقيق وقبول طلب الموافقة في "خرائط Google" أو Waze.
• إذا كان السائق في وضع التصفّح المتخفّي في "خرائط Google"، يعرض التطبيق خطأ ويتعذّر بدء الجلسة. اطلب من السائق إيقاف وضع التصفّح المتخفّي.

تم تلقّي الحالة FAILED أو CLIENT_ERROR عند بدء الرحلة

إذا تغيّرت الحالة إلى FAILED أو CLIENT_ERROR عندما يبدأ السائق رحلة، يعني ذلك أنّ هناك مشكلة تمنع مشاركة بيانات الرحلة. تحقَّق من الأسباب التالية:

• مشاكل في اتصال السائق بالشبكة
• يستخدم السائق Android Auto أو Apple CarPlay.
• لم يقبل السائق طلب الموافقة أو ألغى موافقته.
• مشاكل في مصادقة السائق
• بدأ السائق رحلة في الولايات المتحدة، ولكن لم يتم تفعيل مشاركة بيانات الرحلة في الولايات المتحدة في تطبيقك.

لم يتم تلقّي أي تحديثات أخرى للرحلة

إذا لم يتلقَّ موضوع Google Cloud Pub/Sub أو GetTrip طلبات API الحالة FAILED أو أي تحديثات أخرى للرحلة بعد الحالة ENROUTE، يمكن أن تتسبّب المشاكل التالية في عدم تلقّي تحديثات الرحلة:

• إيقاف "خرائط Google" أو Waze بشكل غير متوقّع
• مشاكل في الاتصال بالشبكة على هاتف السائق

لم يتم تلقّي الحمولة المتوقّعة

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

• قد تتسبّب مشاكل الاتصال بالشبكة في فقدان الحمولة.
• إشارة GPS/GNSS ضعيفة: يتطلّب التنقّل موقعًا جغرافيًا دقيقًا من الأقمار الصناعية GPS/GNSS. قد لا يكون ذلك ممكنًا في مواقف السيارات تحت الأرض أو في المناطق الحضرية المزدحمة أو الأنفاق. يمكن أن يؤثر موضع الجهاز في السيارة أيضًا في جودة الإشارة.
• جودة الجهاز وعمره: قد تحتوي الأجهزة القديمة أو الرخيصة على شرائح GPS رديئة الجودة، ما يؤثر في دقة بيانات الموقع الجغرافي.

ملاحظة: من غير المعتاد أن تستمر هذه الحالات لفترة طويلة، خاصةً في رحلات أو مع سائقين متعدّدين. إذا استمرت هذه الحالات مع سائقين أو رحلات متعدّدة، يُرجى التواصل مع فريق الدعم. إذا كانت الحالة مقتصرة على سائق أو هاتف واحد، حاوِل تحديد المشاكل وحلّها داخليًا مع هذا السائق أولاً.