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

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

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

البيانات

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

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

مُحاكي

Workflows

خدمات النقل

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

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

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

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

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

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

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

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

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

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

هل يتوفّر وضع بلا إنترنت؟
لا، لا توفّر حزمة SDK لميزة التنقّل حاليًا وضع عدم الاتّصال بالإنترنت، ولكنّها توفّر معلومات محفوظة مؤقتًا لرحلة معيّنة.

البيانات

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

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

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

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

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

نعم، يعمل تطبيق RoadSnappedLocationProvider في الخلفية تلقائيًا.

هل تتوافق حزمة Navigation SDK مع ميزة وضع حدود جغرافية؟

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

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

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

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

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

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

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

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

هل يمكنني استخدام ترميز ألوان لأفضل خيار مسار؟
لا، لا يمكن حاليًا استخدام ترميز الألوان لتحديد خيار مسار معيّن.
هل يمكن لحزمة Navigation 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" مجموعة من واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) للمساعدة في تلبية احتياجات المؤسسات في مجال النقل والخدمات اللوجستية. بالنسبة إلى عملاء "خدمات النقل"، يتم استخدام حزمة تطوير البرامج (SDK) لميزة التنقّل عادةً مع الخدمات ذات الصلة لتحسين المسار والإرسال وتتبُّع المهام وتحليلات الأسطول وغير ذلك. يتم أيضًا إصدار فواتير مختلفة لعملاء "خدمات التنقّل" مقابل حزمة تطوير البرامج Navigation SDK. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات خدمات التنقّل.

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

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

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

ما هي واجهات برمجة التطبيقات لـ Navigation SDK التي يجب أن يستخدمها عملاء Mobility Services فقط؟

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

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

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

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

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