الأسئلة الشائعة

تفاصيل المنتج

الشبكة

البيانات

تخصيص واجهة المستخدم

يتم الآن تخطيط المسار

مُحاكي

Workflows

تفاصيل المنتج

يجب أن يُنفِّذ تطبيقك مربّع حوار يتضمّن إشعار بنود خدمة حزمة تطوير البرامج (SDK) للتنقّل الذي يجب أن يقبله كل مستخدم. يمنح مربع الحوار هذا المستخدم الفرصة للموافقة على بنود الخدمة. يتم توفير ملف نصي للبنود مع حزمة SDK للتنقل. استخدِم الطريقة NavigationApi.showTermsAndConditionsDialog لعرض مربّع الحوار الذي يحتوي على العبارات.
تكون أي لغات متاحة في تطبيق "خرائط Google" للأجهزة الجوّالة متاحة تلقائيًا من خلال حزمة تطوير البرامج (SDK) للتنقّل. يحتوي الجهاز على لغة نظام تلقائية ولا يمكن للتطبيق تغيير هذا الإعداد، ومع ذلك، يمكن للتطبيق الوصول إلى أكثر من 70 لغة.

رائع بعد بدء تشغيل LocationListener، سيتواصل تشغيلها في الخلفية. ويستمر تطبيقك في التقاط الطريق والحفاظ على الاتجاه.

رائع عند إنشاء مسار أو تغييره، توفّر السمة RouteChangeListener الخطوط المتعددة.

لا، إنّ "حزمة تطوير البرامج (SDK) للتنقّل" لا تتطلّب تثبيت تطبيق "خرائط Google" للأجهزة الجوّالة على الجهاز.
لا، لا توفّر "حزمة تطوير البرامج (SDK) للتنقّل" هذه الميزة في الوقت الحالي.
نعم. يكون اتجاه حركة المرور متاحًا وعرضه بشكل تلقائي.
ما هي إصدارات JDK التي تتوافق مع حزمة SDK للتنقل؟
تتوافق "حزمة تطوير البرامج (SDK) للتنقّل" مع إصدارات الدعم الطويل الأمد (LTS) من Java SE التي تتوافق معها Oracle بشكل نشط. يتم إدراج هذه الإصدارات على أنّها توفّر دعمًا مميّزًا في خطة تحقيق أهداف دعم Oracle Java SE.

الشبكة

كيف تتعامل حزمة SDK للتنقل مع الاتصال الضعيف؟
تخزّن حزمة "حزمة تطوير البرامج (SDK) للتنقل" المسار مؤقتًا لكل رحلة. وتتضمن المعلومات المخزَّنة مؤقتًا بشكل مسبق معلومات التوجيه لمدة تتراوح بين 15 و20 دقيقة، بالإضافة إلى بدائل المسار في حال انحرف المستخدم عن المسار. يتم تحديد موضع "حزمة تطوير البرامج (SDK)" للتنقل بشكل تقريبي باستخدام نظام تحديد المواقع العالمي (GPS) وأدوات الاستشعار في الجهاز.
هل وضع عدم الاتصال متاح؟
لا، لا توفّر "حزمة تطوير البرامج (SDK) للتنقل" وضع "بلا اتصال بالإنترنت" في الوقت الحالي، ولكن توفّر "حزمة SDK" معلومات مخزَّنة مؤقتًا بشكل مسبق عن رحلة ما.

البيانات

هل يمكنني استرداد جميع محطات التوقّف/الوجهات في رحلة قبل بدء المسار؟

رائع لاسترداد اتجاهات مسار ما، يمكنك الاتصال بـ Navigator.getRouteSegments().

هل تتوفر الإرشادات المفصّلة على المسار في بداية المسار؟
نعم. توفر حزمة SDK للتنقل قائمة بأجزاء المسارات. بالإضافة إلى ذلك، يمكن للمستخدم التمرير عبر بطاقة الاتجاهات في العنوان لرؤية كل مناورة.
كيف يتم إعلام مستخدمي التطبيق بالوقت المقدر للوصول؟

اتّبِع الخطوات التالية لمنح مستخدمي التطبيق معلومات عن الوقت المقدّر للوصول:

  1. استرِد الوقت والمسافة بين جميع نقاط الطرق باستخدام Navigator.getTimeAndDistanceList().
  2. عليك إعادة توجيه هذه المعلومات إلى تطبيق العميل تمامًا كما تفعل في الوقت المقدّر للوصول للسائق.
هل يمكن استخدام RoadSnappedLocationProvider للحصول على الموقع الجغرافي الحالي الموجز للمستخدم إذا لم يكن شريط التنقّل في المقدّمة؟

رائع يتم تشغيل RoadSnappedLocationProvider في الخلفية تلقائيًا.

هل تدعم حزمة تطوير البرامج (SDK) للتنقل تحديد الموقع الجغرافي؟

لا، في سياق التنقّل، تتمتع remainingTimeOrdistanceChangeListener بالأفضلية على الحدود الجغرافية. قد لا يأخذ السياج الجغرافي في الاعتبار هندسة الطرق، وقد لا يتم تركيزه على النقطة الدقيقة التي يتنقل إليها المستخدم.

يمكنك تقريب هذه الميزة باستخدام remainingTimeOrdistanceChangeListener.

  1. اضبط الحدّ الأدنى لتحديد معدّل تكرار معاودة الاتصال.
  2. تحقَّق من المسافة المتبقية إلى الوجهة.

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

هل يمكنني إيقاف الإشعارات عندما يكون تطبيق "التنقل" في الخلفية؟

رائع يمكنك استخدام Navigator.setHeadsUpNotificationEnabled للتحكّم في الإشعارات. تحتوي هذه الطريقة على وسيطة منطقية. يوقف FALSE الإشعارات، ويفعِّل TRUE الإشعارات.

يتتبّع مسجّل المعاملات عمليات الاستلام والانسحاب من خلال معرّف فريد تسجّله Google لأغراض إحصاءات المنتجات. إذا كنت أحد عملاء خدمات التنقّل، تقترح Google تنفيذ NavigationTransactionRecorder لتسجيل سجلّ معاملاتك.

تخصيص واجهة المستخدم

هل يمكنني ترميز أفضل خيار للمسار؟
لا، لا يمكن حاليًا استخدام الترميز اللوني لخيار مسار معيّن.
هل يمكن أن تعرض حزمة SDK للتنقل الوقت المقدّر للوصول للوجهة النهائية؟

رائع استخدِم الطرق التالية:

  1. استرِد الوقت والمسافة بين جميع نقاط الطرق باستخدام Navigator.getTimeAndDistanceList().
  2. إخفاء الوقت المقدّر للوصول للنقطة الحالية باستخدام NavigationFragment.setEtaCardEnabled(false)
  3. اعرض الوقت المقدّر للوصول النهائي.
كيف يمكنني إخفاء تعديلات الوقت المقدر للوصول؟

يمكنك إيقاف بطاقات الوقت المقدر للوصول من خلال الاتصال بالرقم navigationView.setEtaCardEnabled(false).

ما هي تخصيصات واجهة المستخدم المتوفرة لبطاقات الرأس والتذييل؟

استخدِم StylingOptions لضبط نمط لون الخلفية. لإخفاء الرأس والتذييل أو إظهارهما، استخدِم الدالتين setHeaderEnabled وsetFooterEnabled للأعضاء في NavigationFragment.

يتم الآن تخطيط المسار

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

رائع أنشئ Marker بعنوان مخصّص للوجهة وخط العرض/خط الطول. تعرض حزمة تطوير البرامج (SDK) للتنقل العنوان المخصّص والإحداثيات في NavigationMap.

هل يمكنني استخدام حزمة تطوير البرامج (SDK) للتنقل لتتبُّع الانحرافات عن مسار محدَّد؟

رائع يمكنك استخدام Navigator.setRouteChangedListener لتلقّي إشعارات عند تغيير مسار أو اقتراح مسار جديد:

  1. يمكنك استخدام طريقة Navigator.setRouteChangedListener لتسجيل جهاز استماع يتحقّق من موضع الجهاز على طول المسار.
  2. إضافة رمز إلى معالج حدث معاودة الاتصال، onRouteChanged:
    • يمكنك إرسال رسالة إلى مستخدم التطبيق تتضمّن معلومات محدّثة حول الوقت المقدّر للوصول والمسافة.
    • يمكنك تتبُّع الموقع الجغرافي للجهاز.
    • [اختياري] يمكنك إضافة الميزات الأخرى التي يتطلبها تطبيقك لمعالجتها عندما يكون المستخدم خارج المسار الموصوف.
هل يمكن للمستخدم الخروج من التنقل بدون إكمال المسار؟

رائع ويمكنك استدعاء طريقة Navigator.stopGuidance() لإيقاف التنقّل.

مُحاكي

هل يتوافق المحاكي مع تغييرات المسار؟

رائع يمكنك طلب simulateLocationsAlongNewRoute لمحاكاة رحلة تتضمن تغيير المسار. تتجاهل الطريقة simulateLocationsAlongExistingRoute التغييرات التي تتم على المسار الحالي.

Workflows

كيف يمكنني إغلاق الإشعار بعد إغلاق نشاط يحتوي على جزء من التنقّل؟

يظل إشعار التنقل مرئيًا أثناء التنقل، عندما يكون النشاط مغلقًا. عندما تصل المركبة إلى الوجهة، يتوقف التنقل، ويختفي الإشعار.

لمعالجة النقرات على الإشعار، استخدِم Navigator.startGuidance(intent resumeIntent). يتم تنشيط resume intent عندما ينقر مستخدِم التطبيق على الإشعار. ويتم عادةً استدعاء Navigator.startguidance(getIntent()) من النشاط الرئيسي، ما يؤدي إلى استرجاع النشاط عندما ينقر مستخدم التطبيق على الإشعار.