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

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

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

البيانات

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

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

مُحاكي

Workflows

خدمات التنقّل

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

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

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

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

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

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

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

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

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

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

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

البيانات

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

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

هل تتوفّر إرشادات مفصّلة للمسار في بداية الرحلة؟
نعم. توفِّر حزمة Navigation 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 باستخدام عنوان سفارشي للوجهة وخط العرض/خط الطول. تعرِض NavigationMap Navigation SDK العنوان المخصّص والإحداثيات في NavigationMap.

هل يمكنني استخدام حزمة Navigation SDK لتتبُّع الانحرافات عن مسار محدّد؟

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

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

نعم. استخدِم طريقة Navigator.stopGuidance() ل إيقاف التنقّل.

مُحاكي

هل يتيح المحاكي تغييرات المسار؟

نعم. يُرجى الاتصال على simulateLocationsAlongNewRoute لمحاولة محاكاة رحلة تتضمّن تغيير مسار. تتجاهل طريقة simulateLocationsAlongExistingRoute التغييرات التي تطرأ على المسار الحالي.

Workflows

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

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

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

خدمات التنقّل

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

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

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

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

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

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

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

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

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

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

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