توفّر حزمة Navigation SDK طرقًا مختلفة لدمج تجربة تنقّل في تطبيقك. توضّح هذه الصفحة ماهية تجربة التنقّل المخصّصة واختلافها عن تجارب التنقّل الأخرى المتاحة في حزمة Navigation SDK.
ما هي تجربة التنقّل المخصّصة؟
إنّ الطريقة الأساسية لتنفيذ حزمة تطوير البرامج Navigation SDK هي استخدام تجربة التنقّل من Google، والتي تتيح لك تضمين تجربة تنقّل بالاتّجاهات المفصّلة تستخدم عناصر واجهة المستخدم والمرئيات التي تقدّمها Google، تمامًا مثل تجربة التنقّل في تطبيقات "خرائط Google". إذا كنت بحاجة إلى مزيد من المرونة مقارنةً بتجربة التنقّل في Google، يمكنك تنفيذ تجربة تنقّل مخصّصة. تشير تجربة التنقّل المخصّصة إلى أيّ شيء بدءًا من إزالة إرشادات المنعطفات تمامًا وتشغيل التنقّل كعملية في الخلفية فقط، إلى بث تجربة إرشادات مخصّصة للغاية على شاشة منفصلة عن الجهاز الذي يشغّل التنقّل. من خلال تجربة التنقّل المخصّصة، يستدعي تطبيقك حزمة Navigation SDK لطلب خلاصة اتجاهات مفصّلة، ثم تتمكّن من توفير عناصر واجهة المستخدم والمرئيات التي يراها المستخدم في تجربة التنقّل وإدارتها. على الرغم من أنّ استخدام تجربة التنقّل في Google هو عمومًا أسهل في التنفيذ، إلا أنّ إنشاء تجربة تنقّل مخصّصة تتيح مزيدًا من التخصيص.
عند إنشاء تجربة تنقّل مخصّصة، يستدعي تطبيقك حزمة تطوير البرامج (SDK) لميزة "التنقّل" لبدء التنقّل وتنفيذه وإيقافه، وذلك باستخدام الخطوات التالية:
ابدأ التنقّل. كما هو الحال مع تجربة التنقّل في Google، تظلّ تجربة التنقّل المخصّصة تتطلّب إنشاء مثيل تنقّل وتحديد الوجهة. ومع ذلك، من خلال تجربة تنقّل مخصّصة، يمكنك تحقيق ذلك من خلال إنشاء جلسة تنقّل أولاً باستخدام
GMSNavigationService.createNavigationSession
، وهو عنصر غير مرتبط بواجهة المستخدم يحمل حالة ويمكن تشغيله إما باستخدام وحدة تحكّم في العرض أو بدون استخدام وحدة تحكّم.لمزيد من المعلومات، يُرجى الاطّلاع على تفاصيل عن خلاصة بيانات التوجيهات المفصّلة.
الاطّلاع على الإصدار التجريبي: يتضمّن تنزيل حزمة تطوير البرامج (SDK) لميزة التنقّل إصدارًا تجريبيًا يمكنك تشغيله للاطّلاع على مثال لتجربة تنقّل تتبدّل بين الإرشادات المفصّلة من خلال التنقّل العادي إلى تجربة تنقّل تعرض فقط الموقع الجغرافي للجهاز أثناء التنقّل على طول خط مبني من منحنيات لطريق.
التنقّل النشط: في ما يلي فرق رئيسي آخر بين تجربة التنقّل المقدَّمة من Google وتجربة التنقّل المخصّصة. بدلاً من تسليم الإرشادات إلى مدير الأحداث المضمّن في
GMSNavigatorListener
Navigation SDK، يمكنك إعداد أداة معالجة للتوجيهات التفصيلية من خلال تنفيذ بروتوكولGMSNavigatorListener
، ثم تنفيذGMSNavigatorListener
. يتيح ذلك لتجربتك الاستجابة للأحداث الموضّحة في الاستماع إلى أحداث التنقّل.انتهي من التنقّل. كما هو الحال مع تجربة التنقّل في Google، يتطلّب التنقّل المخصّص أيضًا إنهاء التنقّل بالطريقة الأنسب لتجربة التطبيق.
متى يمكنك استخدام تجربة تنقّل مخصّصة؟
يصف الجدول التالي بعض سيناريوهات التنقّل المخصّصة.
مثال على سيناريو |
الخطوات الأساسية |
---|---|
يجب تقديم إرشادات نصية فقط للسائقين على الأجهزة الصغيرة، مثل المركبات ذات العجلتين. |
أنشئ جهاز التنقّل واضبط الإرشادات المفصّلة للتنقّل كخلاصة بيانات لجهاز شاشة صغيرة أثناء تشغيل جهاز التنقّل على هاتف السائق المحمول خارج نطاق رؤيته المباشرة. |
إذا كنت تريد إتاحة تطبيقك كخدمة للسيارات للسائقين الذين يستخدمون Apple Carplay |
لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل ميزة التنقّل في Carplay. |
يريد السائرون الذين يستخدمون تطبيقك الحصول على خريطة عامة لمعظم رحلاتهم، مع توجيهات بسيطة حول الالتفافات في شوارع المدينة. |
يجب أن يسمح تطبيقك للسائقين بالدخول إلى تجربة تنقّل Google والخروج منها حسب الحاجة، بدون تبديل إعدادات المخطّط للوجهة ووضع الرحلة. |