الأسئلة الشائعة
تفاصيل المنتج
- كيف يجب عرض إشعار بنود خدمة حزمة تطوير البرامج للتنقّل؟
- ما هي اللغات التي تتوفّر بها الإرشادات الصوتية؟
- هل يتم الحفاظ على الاتجاه عند استخدام هل تريد الخروج من وضع التنقّل؟
- هل تتوفّر الخطوط المتعددة عند بدء مسيرة أو تغيير مسار؟
- هل يحتاج مستخدمو التطبيق إلى توفُّر "خرائط Google" على الجهاز الجوّال؟
- هل يمكن لحزمة تطوير البرامج (SDK) الخاصة بالتنقّل تحديد مواقف السيارات بالقرب من المطاعم والوجهات الأخرى؟
- هل تعرِض حزمة Navigation SDK اتجاه حركة المرور في المسارات عند الاقتراب من نقطة انعطاف؟
- ما هي إصدارات JDK التي تتوافق معها حزمة تطوير البرامج (SDK) لنظام التنقّل؟
الشبكة والاتصال
- كيف تؤثر هل تتعامل حزمة تطوير البرامج (SDK) للتنقّل مع الاتصال بالشبكة الضعيف؟
- كيف تؤثر هل تتعامل حزمة تطوير البرامج (SDK) للتنقّل مع إشارات نظام تحديد المواقع العالمي (GPS) الضعيفة أو المفقودة؟
- هل وضع عدم الاتصال بالإنترنت متاح؟
البيانات
- هل يمكنني استرداد جميع المحطات/الوجهات في رحلة قبل بدء المسار؟
- هل تتوفر ميزة الإرشادات المفصّلة على المسار؟ في بداية المسار؟
- ما هو الوقت المقدّر للوصول؟ (ETA) التي تم إبلاغ مستخدمي التطبيق بها؟
- هل يمكن استخدام
RoadSnappedLocationProvider
للحصول على الموقع الجغرافي المُجمَّع الحالي للمستخدم إذا لم تكن ميزة التنقّل في المقدّمة؟ - هل تعمل حزمة SDK المخصصة للتنقل أتاحت وضع حدود جغرافية؟
- هل يمكنني إيقاف الإشعارات عندما يكون تطبيق "التنقّل" في الخلفية؟
- كيف يمكنني الاطّلاع على سجلّ المعاملات التي تحتفظ بها Google؟
تخصيص واجهة المستخدم
- هل يمكنني ترميز أفضل لون أو خيار المسار؟
- هل يمكن لحزمة Navigation SDK عرض وقت الوصول المقدَّر إلى الوجهة النهائية؟
- كيف يمكنني إخفاء تعديلات وقت الوصول المقدَّر؟
- عمليات تخصيص واجهة المستخدم متوفّر لبطاقات الرؤوس والتذييلات؟
يتم الآن تخطيط المسار
- هل يمكنني تقديم مسار محدد؟ للمستخدم أو إزالة المسارات البديلة؟
- هل يمكنني عرض تصنيف مختلف للوجهة على المستخدم غير الموقع الجغرافي التلقائي للوجهة؟
- هل يمكنني استخدام حزمة تطوير البرامج (SDK) لميزة التنقّل لتتبُّع الانحرافات عن مسار محدّد؟
- هل يمكن للمستخدم الخروج من التنقل بدون إكمال المسار
مُحاكي
Workflows
خدمات النقل
- ما هي أوجه الاختلاف بين استخدام حزمة تطوير البرامج Navigation SDK وعملاء Mobility Services؟
- كيف يمكنني معرفة ما إذا كنتُ من عملاء "خدمات النقل"؟
- كيف يتم تحصيل فواتير حزمة تطوير البرامج (SDK) للتنقل بالنسبة إلى عملاء "خدمات الجوّال"؟
- حزمة SDK للتنقّل هل يجب أن يقتصر استخدام واجهات برمجة التطبيقات على عملاء "خدمات الجوّال"؟
- إذا كنت أحد عملاء "خدمات الجوّال"، هل يمكنني أيضًا استخدام تطبيق لـ "حزمة SDK الخاصة بالتنقل" بخلاف "خدمات التنقل"؟
تفاصيل المنتج
-
يجب أن يُنفِّذ تطبيقك مربّع حوار مع حزمة تطوير البرامج (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 لميزة التنقّل قائمة بمقاطع المسار. بالإضافة إلى ذلك، يمكن للمستخدم التمرير سريعًا خلال بطاقة الاتجاهات في العنوان لرؤية كل مناورة.
- كيف يتم إبلاغ مستخدمي التطبيق بالوقت المقدَّر للوصول؟
-
اتّبِع الخطوات التالية لمنح مستخدمي التطبيق معلومات عن الوقت المقدّر للوصول:
- استرجع الوقت والمسافة لجميع نقاط الطريق باستخدام
Navigator.getTimeAndDistanceList()
- يمكنك إعادة توجيه هذه المعلومات إلى تطبيق العميل أثناء فعله في الوقت المقدّر للوصول للسائق.
- استرجع الوقت والمسافة لجميع نقاط الطريق باستخدام
-
هل يمكن استخدام
RoadSnappedLocationProvider
للحصول على الموقع الجغرافي المُجمَّع الحالي للمستخدم إذا لم يكن التنقّل في المقدّمة؟ -
نعم. يتم تشغيل "
RoadSnappedLocationProvider
" في الخلفية تلقائيًا. - هل تدعم حزمة تطوير البرامج (SDK) للتنقل تحديد الموقع الجغرافي؟
-
لا. في سياق التنقّل،
remainingTimeOrdistanceChangeListener
له ميزة على السياج الجغرافي. قد لا يأخذ الحدود الجغرافية في الحسبان هندسة الطرق، وقد لا يتم تركيزها على النقطة الدقيقة التي تنقل المستخدم.يمكنك تقريب هذه الميزة باستخدام
remainingTimeOrdistanceChangeListener
.- اضبط الحدّ الأدنى لتحديد معدّل تكرار عمليات تسجيل المكالمات.
- تحقَّق من المسافة المتبقية إلى الوجهة.
على سبيل المثال، إذا ضبطت الحدّ الأدنى على 100 متر، ستتلقّى مكالمة هاتفية عند تغيُّر المسافة إلى الوجهة بمقدار 100 متر. مع انخفاض المسافة، يمكنك تعديل هذا الحدّ الأدنى إلى قيمة أصغر والحصول على مكالمات هاتفية متكرّرة. بعد ذلك، تحقَّق من المسافة المتبقية لتحديد ما إذا كنت قريبًا بما يكفي من موقع الاستلام/الإرجاع.
- هل يمكنني إيقاف الإشعارات عندما يكون تطبيق "التنقّل" في الخلفية؟
-
نعم. استخدِم
Navigator.setHeadsUpNotificationEnabled
للتحكّم في الإشعارات. تحتوي هذه الطريقة على وسيطة منطقية. يؤدي النقر علىFALSE
إلى إيقاف الإشعارات، بينما يؤدي النقر علىTRUE
إلى تفعيلها. -
يتتبّع مُسجِّل المعاملات عمليات الاستلام والتسليم باستخدام معرّف فريد، تسجّله Google لأغراض إحصاءات المنتجات. إذا كنت أحد عملاء خدمات التنقّل، تستخدم Google يوصي بتنفيذ
NavigationTransactionRecorder
إلى تسجيل سجلّ بالمعاملات التي أجريتها
تخصيص واجهة المستخدم
- هل يمكنني ترميز أفضل خيار للمسار؟
- لا، لا يمكن حاليًا استخدام ترميز الألوان لتحديد خيار مسار معيّن.
- هل يمكن أن تعرض حزمة SDK للتنقل الوقت المقدّر للوصول للوجهة النهائية؟
-
نعم. استخدِم الطرق التالية:
- استرداد الوقت والمسافة لجميع نقاط الالتفاف باستخدام
Navigator.getTimeAndDistanceList()
- إخفاء الوقت المقدر للوصول للنقطة الحالية باستخدام
NavigationFragment.setEtaCardEnabled(false)
- اعرض الوقت المقدّر للوصول النهائي.
- استرداد الوقت والمسافة لجميع نقاط الالتفاف باستخدام
- كيف يمكنني إخفاء تعديلات الوقت المقدر للوصول؟
-
يمكنك إيقاف بطاقات الوقت المقدر للوصول من خلال الاتصال بالرقم
navigationView.setEtaCardEnabled(false)
. -
استخدِم
StylingOptions
لضبط الخلفية. ونمط الألوان. لإخفاء العنوان وإظهاره التذييل، استخدمsetHeaderEnabled
setFooterEnabled
من الدوال الأعضاء فيNavigationFragment
يتم الآن تخطيط المسار
- هل يمكنني توفير مسار معيّن لمستخدم أو إزالة مسارات بديلة؟
- لا، يتم تلقائيًا توفير مسارات متعددة، ويكون للمسار الأسرع الأولوية. يمكنك التأثير على المسار الافتراضي عن طريق إضافة تفضيلات، مثل "تجنب والطرق السريعة ورسوم العبور"، على طلبك. تؤثر إضافة نقاط الطريق أيضًا على المسار.
- هل يمكنني عرض تصنيف للوجهة لمستخدم التطبيق يختلف عن التصنيف التلقائي للوجهة؟ موقع الوجهة؟
-
نعم. إنشاء
Marker
باستخدام عنوان مخصص للوجهة وخط العرض/خط الطول. تعرِض Navigation SDK العنوان المخصّص والإحداثيات علىNavigationMap
. - هل يمكنني استخدام حزمة تطوير البرامج (SDK) للتنقل لتتبُّع الانحرافات عن مسار محدَّد؟
-
نعم. استخدِم
Navigator.setRouteChangedListener
لتلقّي إشعارات عند تغيُّر مسار أو اقتراح مسار جديد:- سجِّل مستمعًا يتحقّق من موضع الجهاز على طول المسار
باستخدام طريقة
Navigator.setRouteChangedListener
. - أضِف رمزًا إلى معالج حدث ردّ الاتصال،
onRouteChanged
:- أرسِل رسالة إلى مستخدم التطبيق تتضمّن معلومات محدّثة عن الوقت المقدَّر للوصول والمسافة.
- تتبُّع الموقع الجغرافي للجهاز
- [اختياري] أضِف ميزات أخرى يتطلبها تطبيقك للتعامل مع الحالات التي يكون فيها المستخدم خارج المسار المحدّد.
- سجِّل مستمعًا يتحقّق من موضع الجهاز على طول المسار
باستخدام طريقة
-
نعم. يجب استدعاء طريقة
Navigator.stopGuidance()
إيقاف التنقل.
مُحاكي
- هل يتوافق المحاكي مع تغييرات المسار؟
-
نعم. الاتصال بـ
simulateLocationsAlongNewRoute
من أجل محاكاة رحلة تتضمن تغيير المسار.simulateLocationsAlongExistingRoute
تتجاهل التغييرات التي تتم على المسار الحالي.
Workflows
- كيف يمكنني إغلاق الإشعار بعد إغلاق نشاط يحتوي على جزء تنقّل؟
-
يظل إشعار التنقل مرئيًا أثناء التنقل، عندما يكون النشاط مغلقًا. عند وصول المركبة إلى الوجهة، تتوقف عملية التنقّل ويختفي الإشعار.
لمعالجة النقرات على الإشعار، استخدِم الرمز
Navigator.startGuidance(intent resumeIntent)
. يتم تشغيل الإجراءresume intent
عندما ينقر مستخدم التطبيق على الإشعار. يتم عادةً استدعاءNavigator.startguidance(getIntent())
من النشاط الرئيسي، الذي يسترجع النشاط عندما ينقر مستخدم التطبيق على الإشعار.
خدمات نقل
توفّر "خدمات الجوّال على Google Maps Platform مجموعة من واجهات برمجة التطبيقات وحزم تطوير البرامج (SDK)" للمساعدة في دعم احتياجات المؤسسات لشركات النقل والخدمات اللوجستية. بالنسبة إلى عملاء "خدمات النقل"، يتم استخدام حزمة تطوير البرامج (SDK) لميزة التنقّل عادةً مع الخدمات ذات الصلة لتحسين المسار والإرسال وتتبُّع المهام وتحليلات الأسطول وغير ذلك. يتم أيضًا إصدار فواتير مختلفة لعملاء "خدمات النقل" مقابل حزمة SDK لنظام التنقّل. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات خدمات التنقّل.
تتوفّر منتجات التنقّل حاليًا لعملاء محدّدين فقط. يُرجى التواصل مع ممثل المبيعات للحصول على مزيد من المعلومات.
ReportBillableEvent
في رمزك. يجب أن يتصل عملاء "خدمات الجوّال" فقط بطريقة ReportBillableEvent
.
هناك العديد من واجهات برمجة التطبيقات في حزمة تطوير البرامج (SDK) لميزة التنقّل مخصّصة فقط لاستخدام عملاء خدمات النقل الذين تُحصّل Google الرسوم منهم على أساس كل معاملة. إذا لم تكن من عملاء "خدمات النقل"، لن تكون الطرق التالية مفيدة لك:
نعم، يمكن لعملاء Mobility Services استخدام حزمة تطوير البرامج (SDK) لنظام التنقّل في كلّ من عمليات التنفيذ التي تستخدم Mobility Services وتلك التي لا تستخدمها. ومع ذلك، يمكنك استخدام نوع تنفيذ واحد فقط في أي تطبيق في الوقت نفسه. وعليك أيضًا إنشاء مشروع جديد على Google Cloud وحساب فوترة ومفتاح واجهة برمجة تطبيقات، بشكل منفصل عن المشاريع التي تستخدمها في تنفيذ "خدمات الجوّال". لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على إعداد حزمة تطوير البرامج (SDK) لنظام التنقّل.
لمزيد من المعلومات عن استخدام حزمة Navigation SDK من خلال عملية تنفيذ غير مرتبطة بخدمات النقل، بما في ذلك نقل تطبيق من نوع تنفيذ إلى آخر، يُرجى التواصل مع ممثل حسابك على Google.
ملاحظة: إذا لم تكن حاليًا من عملاء Mobility Services وكنت مهتمًا بالاطّلاع على مزيد من المعلومات عن مجموعة Mobility Services من واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK)، يُرجى التواصل مع فريق المبيعات في Google Maps Platform.