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

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

الشبكة والاتصال

البيانات

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

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

مُحاكي

Workflows

خدمات النقل

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

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

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

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

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

الشبكة وإمكانية الاتصال

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

بعد بدء التنقل وتلقي حزمة SDK للتنقل إشارة GPS مرة واحدة على الأقل، ستعرض الرسالة "جارٍ البحث عن GPS..." رسالة في المواقف التالية:

  • إذا مرّ أكثر من 10 ثوانٍ على آخر مرة تلقّى فيها الجهاز إشارة نظام تحديد المواقع العالمي (GPS)
  • إذا تحرّك موضع التوجيه أكثر من 500 متر منذ تلقّيه آخر إشارة من نظام تحديد المواقع العالمي (GPS)

وإذا لم تستقبل حزمة SDK إشارة نظام تحديد المواقع العالمي (GPS) لفترة زمنية طويلة، فإن التقدم على طول المسار، والموضح في التطبيق من خلال موضع شارة الرتبة، قد يتباطأ حتى يصل إلى محطة كاملة. في هذه الحالة، ستظل شارة الرتبة على الخريطة في الموقع المشار إليه من خلال آخر إشارة لنظام تحديد المواقع العالمي (GPS). لن تخرج حزمة تطوير البرامج (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 باستخدام عنوان مخصص للوجهة وخط العرض/خط الطول. تعرِض Navigation SDK العنوان المخصّص والإحداثيات على NavigationMap.

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

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

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

نعم. يجب استدعاء طريقة Navigator.stopGuidance() إيقاف التنقل.

مُحاكي

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

نعم. الاتصال بـ simulateLocationsAlongNewRoute من أجل محاكاة رحلة تتضمن تغيير المسار. simulateLocationsAlongExistingRoute تتجاهل التغييرات التي تتم على المسار الحالي.

Workflows

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

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

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

خدمات نقل

كيف يختلف استخدام حزمة تطوير البرامج Navigation SDK عن عملاء Mobility Services؟

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

تتوفّر منتجات التنقّل حاليًا لعملاء محدّدين فقط. يُرجى التواصل مع ممثل المبيعات للحصول على مزيد من المعلومات.

كيف يمكنني معرفة ما إذا كنت من عملاء "خدمات النقل"؟
إذا لم تكن متأكدًا مما إذا كنت تطبق SDK للتنقل حاليًا كعميل "خدمات متنقلة"، فابحث عن مكالمة ReportBillableEvent في رمزك. يجب أن يتصل عملاء "خدمات الجوّال" فقط بطريقة ReportBillableEvent.

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

حزمة SDK للتنقل هل يجب أن يستخدم عملاء "خدمات الجوّال" واجهات برمجة التطبيقات فقط؟

هناك العديد من واجهات برمجة التطبيقات في حزمة تطوير البرامج (SDK) لميزة التنقّل مخصّصة فقط لاستخدام عملاء خدمات النقل الذين تُحصّل Google الرسوم منهم على أساس كل معاملة. إذا لم تكن من عملاء "خدمات النقل"، لن تكون الطرق التالية مفيدة لك:

إذا كنت من عملاء Mobility Services، هل يمكنني أيضًا استخدام حزمة SDK لنظام التنقّل غير المرتبط بخدمات Mobility Services؟

نعم، يمكن لعملاء Mobility Services استخدام حزمة تطوير البرامج (SDK) لنظام التنقّل في كلّ من عمليات التنفيذ التي تستخدم Mobility Services وتلك التي لا تستخدمها. ومع ذلك، يمكنك استخدام نوع تنفيذ واحد فقط في أي تطبيق في الوقت نفسه. وعليك أيضًا إنشاء مشروع جديد على Google Cloud وحساب فوترة ومفتاح واجهة برمجة تطبيقات، بشكل منفصل عن المشاريع التي تستخدمها في تنفيذ "خدمات الجوّال". لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على إعداد حزمة تطوير البرامج (SDK) لنظام التنقّل.

لمزيد من المعلومات عن استخدام حزمة Navigation SDK من خلال عملية تنفيذ غير مرتبطة بخدمات النقل، بما في ذلك نقل تطبيق من نوع تنفيذ إلى آخر، يُرجى التواصل مع ممثل حسابك على Google.

ملاحظة: إذا لم تكن حاليًا من عملاء Mobility Services وكنت مهتمًا بالاطّلاع على مزيد من المعلومات عن مجموعة Mobility Services من واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK)، يُرجى التواصل مع فريق المبيعات في Google Maps Platform.