الملاحة

الواجهة العامة المستكشف

المفرد المفرد الذي يوفر طرقًا للتحكم في التنقل.

نضمن أن تكون جميع الطرق آمنة من سلاسل المحادثات باستثناء الاستراتيجيتَين setAudioGuidance وsetHeadsUpNotificationEnabled التي يجب طلبها في سلسلة محادثات واجهة المستخدم.

ملخص الفئة المدمَجة

واحدة	Navigator.ArrivalListener		تحدِّد هذه السياسة التوقيعات للطرق التي يتم استدعاءها عند وصول السائق إلى نقطة طريق.
@interface	Navigator.AudioGuidance		ميزة AudioGuidance هي مجموعة من العلامات التي تُستخدَم لتحديد أنواع التنبيهات والتوجيهات الصوتية التي يتم استخدامها أثناء التنقّل.
واحدة	Navigator.RemainingTimeOrDistanceChangedListener		تحدد التوقيعات للطرق التي يتم استدعاءها عند تغيير الوقت المتبقي أو المسافة المتبقية إلى الوجهة التالية.
واحدة	Navigator.RouteChangedListener		تحدِّد التوقيعات للطرق التي يتم استدعاءها عند تغيير المسار.
تعداد	Navigator.RouteStatus		حالة المسار هي رمز حالة يمثّل نتيجة حساب المسار، ويتم الوصول إليه من خلال المستقبل الذي يعرضه setDestination(Waypoint).

ملخّص الطريقة العلنية

تجريدي باطلة	cleanup() تنظيف الحالة الداخلية لبرنامج المستكشف.
تجريدي باطلة	clearDestinations() يؤدي هذا الإجراء إلى محو جميع الوجهات التي تم ضبطها سابقًا وإزالة أي مسارات تم احتسابها من الخريطة.
تجريدي باطلة	clearLicensePlateRestrictionInfo() يؤدي هذا الإجراء إلى محو المعلومات الخاصة بالسائق الحالي في لوحة ترخيص المركبة.
تجريدي باطلة	clearRemainingTimeOrDistanceChangedListener() محو المستمِع من التغييرات في الوقت المتبقي أو المسافة المتبقية
تجريدي نقطة الطريق	continueToNextDestination() إزالة الوجهة الحالية
abstract ListenableResultFuture<RouteInfo>	fetchRouteInfo(نقطة مسار Waypoint، وRoutingOptions التوجيه) لعرض معلومات عن المسارات استنادًا إلى كل قيمة من قيم RoutingOptions.RoutingStrategy.
تجريدي RouteSegment	getCurrentRouteSegment() لعرض المرحلة الحالية من الرحلة.
تجريدي TimeAndDistance	getCurrentTimeAndDistance() تعرض المدة والمسافة المقدَّرة من الموضع الحالي إلى الوجهة الحالية.
مجردة قائمة<RouteSegment>	getRouteSegments() تعرض قائمة بأجزاء الطرق.
تجريدي المحاكي	getSimulator() لعرض كائن محاكي لاستخدامه أثناء الاختبار.
ملخص القائمة<TimeAndDistance>	getTimeAndDistanceList() تعرض قائمة بالأوقات والمسافة المقابلة لكل وجهة في المسار الحالي، لتمثل الوقت والمسافة المقدّرة من الموضع الحالي لكل وجهة.
تجريدي قائمة<LatLng>	getTraveledRoute() تعرض المسار الذي تم قطعه حتى الآن أثناء جلسة التوجيه هذه (منذ آخر مكالمة إلى startGuidance()).
تجريدي منطقي	isGuidanceRunning() تعرض true إذا كانت الإرشادات قيد التشغيل حاليًا.
تجريدي باطلة	setArrivalListener(مستمع Navigator.ArrivalListener) لتسجيل مستمِع لأحداث الوصول
تجريدي باطلة	setAudioGuidance(إرشادات int) يحدد هذا الإعداد أنواع الإرشاد الصوتي (بما في ذلك الاهتزاز) التي يتم تفعيلها.
ملخّص ListenableResultFuture<Navigator.RouteStatus>	setDestination(وجهة Waypoint، وRoutingOptions خيارات التوجيه، وDisplayOptions خيارات العرض) لتعيين وجهة واحدة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا.
ملخّص ListenableResultFuture<Navigator.RouteStatus>	setDestination(وجهة Waypoint، خيارات RoutingOptions) لتعيين وجهة واحدة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا.
ملخّص ListenableResultFuture<Navigator.RouteStatus>	setDestination(وجهة في Waypoint) لتعيين وجهة واحدة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا.
ملخّص ListenableResultFuture<Navigator.RouteStatus>	setDestinations(قائمة<Waypoint> الوجهات، خيارات RoutingOptions) تعيين وجهات متعددة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا.
ملخّص ListenableResultFuture<Navigator.RouteStatus>	setDestinations(قائمة<Waypoint> الوجهات، وRoutingOptions خيارات التوجيه، وDisplayOptions خيارات العرض) تعيين وجهات متعددة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا.
ملخّص ListenableResultFuture<Navigator.RouteStatus>	setDestinations(قائمة<Waypoint> الوجهات) تعيين وجهات متعددة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا.
تجريدي باطلة	setHeadsUpNotificationEnabled(تفعيل منطقي) لتعيين ما إذا كان يجب عرض إشعارات التنبيه.
تجريدي باطلة	setLicensePlateRestrictionInfo(int RAW LicensePlateLastDigit, String LicensePlateCountryCode) تحدِّد هذه السياسة معلومات عن السائق الحالي في لوحة ترخيص المركبة.
تجريدي باطلة	setRemainingTimeOrDistanceChangedListener(int timeChangeThresholdSeconds, int spaceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener) يعمل هذا الإعداد على تسجيل مستمع عندما يتغيّر الوقت المتبقي أو المسافة المتبقية إلى الوجهة بأكثر من الحدّ المعيّن.
تجريدي باطلة	setRouteChangedListener(مستمع Navigator.RouteChangedListener) يعمل هذا الإعداد على تسجيل أداة معالجة للأحداث التي تم تغيير مسارها.
تجريدي باطلة	setSpeedingListener(SpeedingListener speedingListener) يؤدي هذا الخيار إلى تسجيل SpeedingListener للنسبة المئوية التي تتجاوز حد السرعة الذي يقودها السائق حاليًا.
تجريدي باطلة	startGuidance(Intent resumeIntent) هذا الحقل مماثل لسياسة startGuidance()، ولكن مع تحديد غرض يمكن استخدامه لاستئناف التطبيق من خلال إشعار شريط الحالة الخاص بأداة التنقّل.
تجريدي باطلة	startGuidance() في حال تحديد وجهة وتم احتساب مسار لها، يبدأ توجيه التنقّل المفصّلة للمسار.
تجريدي باطلة	stopGuidance() إيقاف إرشادات التنقّل باتّجاهات مفصّلة

الطرق العامة

متاح للجميع محتوى تجريدي لاغٍ تنظيف ()

تنظيف الحالة الداخلية لبرنامج المستكشف.

ملاحظة: سيؤدي استدعاء هذه الطريقة إلى إلغاء أي طلبات في انتظار المراجعة إلى setDestinations(List).

متاح للجميع محتوى تجريدي لاغٍ clearDestinations ()

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

متاح للجميع محتوى تجريدي لاغٍ clearLicensePlateRestrictionInfo ()

يؤدي هذا الإجراء إلى محو المعلومات الخاصة بالسائق الحالي في لوحة ترخيص المركبة. سيتم تطبيق هذا فقط على طلبات setDestination التي يتم إجراؤها بعد ضبط هذه القيمة.

عام ملخص لاغٍ clearRemainingTimeOrDistanceChangedListener ()

محو المستمِع من التغييرات في الوقت المتبقي أو المسافة المتبقية

عام ملخّص Waypoint continueToNextDestination ()

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

المرتجعات

• توجيه نقطة الطريق تتجه إليه الآن، أو قيمة فارغة إذا لم تكن هناك المزيد من نقاط الطريق المتبقية

Public مجرّد ListenableResultFuture<RouteInfo> fetchRouteInfo (Waypoint نقطة طريق، RoutingOptions توجيه

لعرض معلومات عن المسارات استنادًا إلى كل قيمة من قيم RoutingOptions.RoutingStrategy. تم تجاهل RoutingOptions.RoutingStrategy لأنّ هذه الطريقة تعرض معلومات المسار لجميع استراتيجيات التوجيه.

ملاحظة: تتم إعادة احتساب هذا العدد عند كل مكالمة وقد لا يتطابق مع المسارات التي يستخدمها التنقّل حاليًا بسبب تعديل حركة المرور وعوامل أخرى في الوقت الحالي.

المَعلمات

نقطة الطريق	نقطة الطريق الوجهة للمسار
routingOptions	الخيارات المستخدمة لاسترجاع معلومات المسار

المرتجعات

• المستقبل العائد

متاح للجميع ملخّص RouteSegment getCurrentRouteSegment ()

لعرض المرحلة الحالية من الرحلة. وسيكون موضع بداية جزء المسار هذا أحدث موضع معروف (الانقطاع على الطريق) للجهاز.

المرتجعات

• كائن جزء من المسار، أو null في حالة عدم وجود مسار حالي

متاح للجميع مجرّد TimeAndDistance getCurrentTimeAndDistance ()

تعرض المدة والمسافة المقدَّرة من الموضع الحالي إلى الوجهة الحالية.

المرتجعات

• كائن وقت ومسافة، أو null في حال عدم وجود مسار حالي

متاح للجميع ملخّص قائمة<RouteSegment> getRouteSegments ()

تعرض قائمة بأجزاء الطرق. تتوافق وجهة كل قسم يتم عرضه مع وجهة تم ضبطها من خلال setDestination(الوجهات)

عام تجريدي محاكي getSimulator ()

لعرض كائن محاكي لاستخدامه أثناء الاختبار.

عام TimeAndDistance getTimeAndDistanceList()

تعرض قائمة بالأوقات والمسافة المقابلة لكل وجهة في المسار الحالي، لتمثل الوقت والمسافة المقدّرة من الموضع الحالي لكل وجهة.

عام تجريدي قائمة<LatLng> getTraveledRoute ()

لعرض المسار الذي تم قطعه حتى الآن أثناء جلسة التوجيه هذه (منذ آخر اتصال تم إجراؤه إلى startGuidance()). يتألف المسار من المواقع الموجزة بالطريق كما قد يعرضها RoadSnappedLocationProvider، مع تبسيطه لإزالة النقاط المتكررة، على سبيل المثال، تحويل النقاط الخطية المتتالية إلى جزء من خط واحد.

عام تجريدي منطقي isGuidanceRunning ()

تعرض true إذا كانت الإرشادات قيد التشغيل حاليًا. يُرجى العِلم أنّه لن يتم تنفيذ الإرشادات إلا بعد احتساب مسار إلى وجهة ما واستدعاء startGuidance().

public مجرّد باطلة setArrivalListener (Navigator.ArrivalListener مستمع)

لتسجيل مستمِع لأحداث الوصول تلغي هذه الإعدادات أي أدوات استماع تم تسجيلها سابقًا.

ملاحظة: لتجنُّب تسرُّب الذاكرة، يجب استدعاء setNavArrivalListener(null) عندما لا يكون المستمع مطلوبًا.

المَعلمات

أداة معالجة الحدث	المستمع للتسجيل. يمكن ضبط السياسة على null لمحو مستمع مسجّل سابقًا.

متاح للجميع محتوى تجريدي لاغٍ setAudioGuidance (إرشادات int Guidelines)

يحدد هذا الإعداد أنواع الإرشاد الصوتي (بما في ذلك الاهتزاز) التي يتم تفعيلها. يتم تلقائيًا تفعيل الاهتزاز والصوت والصوت عبر البلوتوث (في حال توفّره).

يجب طلب هذه الطريقة في سلسلة محادثات واجهة المستخدم.

المَعلمات

الإرشادات	مجموعة من علامات Navigator.AudioGuidance التي تحدد أنواع الإرشادات الصوتية التي يجب تفعيلها

متاح للجميع مجرّد ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint destination, RoutingOptions redirectOptions, DisplayOptions displayOptions)

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

المَعلمات

الوجهة	الوجهة الجديدة التي سيتم تحديدها
routingOptions	الخيارات التي سيتم استخدامها لإنشاء المسار
displayOptions	الخيارات التي سيتم استخدامها لعرض المسار

المرتجعات

• المستقبل العائد

الرميات

NullPointerException	إذا كانت الوجهة المحددة فارغة

متاح للجميع ملخّص ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint destination, RoutingOptions خيارات)

لتعيين وجهة واحدة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا. وسيتم ضبط سياسة الإرجاع المستقبلية على OK إذا تم العثور على مسار من الموقع الجغرافي للمستخدم إلى الوجهة المحددة. سيتم استخدام DisplayOptions التلقائي لعرض المسار.

المَعلمات

الوجهة	الوجهة الجديدة التي سيتم تحديدها
الخيارات	الخيارات التي سيتم استخدامها لإنشاء المسار

المرتجعات

• المستقبل العائد

الرميات

NullPointerException	إذا كانت الوجهة المحددة فارغة

متاح للجميع ملخّص ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint destination)

لتعيين وجهة واحدة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا. وسيتم ضبط سياسة الإرجاع المستقبلية على OK إذا تم العثور على مسار من الموقع الجغرافي للمستخدم إلى الوجهة المحددة. سيتم استخدام علامة RoutingOptions التلقائية للعثور على المسار، في حين سيتم استخدام القيمة التلقائية DisplayOptions لعرضها.

المَعلمات

الوجهة	الوجهة الجديدة التي سيتم تحديدها

المرتجعات

• المستقبل العائد

الرميات

NullPointerException	إذا كانت الوجهة المحددة فارغة

متاح للجميع ملخّص ListenableResultFuture<Navigator.RouteStatus> setDestinations (قائمة<Waypoint> الوجهات، RoutingOptions)

تعيين وجهات متعددة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا. وسيتم ضبط سياسة الإرجاع المستقبلية على OK إذا تم العثور على مسار من الموقع الجغرافي للمستخدم إلى الوجهة المحددة. سيتم استخدام DisplayOptions التلقائي لعرض المسار.

المَعلمات

الوجهات	قائمة الوجهات الجديدة التي سيتم تحديدها
الخيارات	الخيارات التي سيتم استخدامها لإنشاء المسار

المرتجعات

• المستقبل العائد

متاح للجميع مجرّد ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> destination, RoutingOptionstargetingOptions, DisplayOptions displayOptions)

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

المَعلمات

الوجهات	قائمة الوجهات الجديدة التي سيتم تحديدها
routingOptions	الخيارات التي سيتم استخدامها لإنشاء المسار
displayOptions	الخيارات التي سيتم استخدامها لعرض المسار

المرتجعات

• المستقبل العائد

عامة ملخّص ListenableResultFuture<Navigator.RouteStatus> setDestinations (قائمة<Waypoint> الوجهات)

تعيين وجهات متعددة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا. وسيتم ضبط سياسة الإرجاع المستقبلية على OK إذا تم العثور على مسار من الموقع الجغرافي للمستخدم إلى الوجهة المحددة. سيتم استخدام علامة RoutingOptions التلقائية للعثور على المسار، في حين سيتم استخدام القيمة التلقائية DisplayOptions لعرضها.

المَعلمات

الوجهات	قائمة الوجهات الجديدة التي سيتم تحديدها

المرتجعات

• المستقبل العائد

متاح للجميع محتوى تجريدي باطل setHeadsUpNotificationEnabled (boolean enabled)

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

يجب طلب هذه الطريقة في سلسلة محادثات واجهة المستخدم.

المَعلمات

مفعّلة	علامة للإشارة إلى ما إذا كان يجب تفعيل إشعارات التنبيه

public مجرّد لاغ setLicensePlateRestrictionInfo (int RAW LicensePlateLastDigit, String LicensePlateCountryCode)

تحدِّد هذه السياسة معلومات عن السائق الحالي في لوحة ترخيص المركبة. ويتيح لنا ذلك أيضًا التحرك حول أنواع معيّنة من القيود المفروضة على الطرق استنادًا إلى رقم لوحة الترخيص. سيتم تطبيق هذا فقط على طلبات setDestination التي يتم إجراؤها بعد ضبط هذه القيمة. ويُفضَّل أن يطلق عليها اسم أداة التنقّل مباشرةً بعد الحصول على أداة التنقّل.

المَعلمات

rawLicensePlateLastDigit	الرقم الأخير من لوحة الترخيص (يجب أن يكون الرقم بين 0 و9).
licensePlateCountryCode	نتيح حاليًا الدعم في إندونيسيا (ID) والبرازيل (BZ)، ويمكن أن نتيحهما في المستقبل ويمكنك تقديم هذه المعلومات بشكل استباقي.

عام مجرّد باطلة setRemainingTimeOrDistanceChangedListener (int timeChangeThresholdSeconds, int spaceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener مستمع)

يعمل هذا الإعداد على تسجيل مستمع عندما يتغيّر الوقت المتبقي أو المسافة المتبقية إلى الوجهة بأكثر من الحدّ المعيّن. تلغي هذه الإعدادات أي أدوات استماع تم تسجيلها سابقًا.

قد يتم استدعاء المستمع نتيجة حركة المستخدم (على سبيل المثال) أو نتيجة لتغيير في أحوال حركة المرور أو تغيير في المسار أو تغيير في الوجهة أو عندما يصبح الوقت والمسافة المتبقية معروفين لأول مرة.

ملاحظة: لتجنُّب تسرُّب الذاكرة، يجب استدعاء clearNavProgressionListener() عندما لا يكون المستمع مطلوبًا.

المَعلمات

timeChangeThresholdSeconds	وإذا كان التغيير المطلق في الوقت المتبقي بالثواني أكبر من هذه القيمة أو يساويها، يتم استدعاء المستمع. ويجب ألا يكون هذا الحدّ سالبًا.
distanceChangeThresholdMeters	إذا كان التغيّر المطلق في المسافة المتبقية بالمتر أكبر من هذه القيمة أو مساويًا لها، يتم استدعاء أداة معالجة الحدث. ويجب ألا يكون هذا الحدّ سالبًا.
أداة معالجة الحدث	المستمع للتسجيل. يجب ألا يكون null.

عام موجز لاغ setRouteChangedListener (Navigator.RouteChangedListener مستمع)

يعمل هذا الإعداد على تسجيل أداة معالجة للأحداث التي تم تغيير مسارها. تلغي هذه الإعدادات أي أدوات استماع تم تسجيلها سابقًا.

ملاحظة: لتجنُّب تسرُّب الذاكرة، يجب استدعاء setNavRouteChangeListener(null) عندما لا يكون المستمع مطلوبًا.

المَعلمات

أداة معالجة الحدث	المستمع للتسجيل. يمكن ضبط السياسة على null لمحو مستمع مسجّل سابقًا.

public موجز خالٍ setSpeedingListener (SpeedingListener speedListener)

يؤدي هذا الخيار إلى تسجيل SpeedingListener للنسبة المئوية التي تتجاوز حد السرعة الذي يقودها السائق حاليًا.

وعند ضبط null SpeedingListener أو عدم ضبطها، لن تتلقّى أي بيانات خلاصة مسرَّعة.

المَعلمات

speedingListener

علني محتوى موجز لاغٍ startGuidance (IntentCVIntent)

هذا الحقل مماثل لسياسة startGuidance()، ولكن مع تحديد غرض يمكن استخدامه لاستئناف التطبيق من خلال إشعار شريط الحالة الخاص بأداة التنقّل. وبدون هذا الغرض، لن يمكن استئناف الطلب من شريط الحالة.

المَعلمات

resumeIntent	الغرض من استئناف التطبيق. في معظم الحالات، تكون القيمة التي تعرضها السمة android.app.Activity#getIntent() مناسبة.

متاح للجميع محتوى تجريدي فارغ startGuidance ()

في حال تحديد وجهة وتم احتساب مسار لها، يبدأ توجيه التنقّل المفصّلة للمسار. إذا لم يتم احتساب المسار بعد، سيبدأ التوجيه المفصّلة بعد ذلك.

يجب عليك استدعاء StopGuidance() بشكل صريح لإيقاف خدمة التنقل. لن تتوقّف خدمة التنقّل تلقائيًا عند الوصول. إذا أردت إيقاف خدمة التنقّل عند الوصول، عليك استدعاء offGuidance() في NavArrivalListener.

ملاحظة: لا تؤدي هذه الطريقة إلى تغيير موضع Camera.

متاح للجميع محتوى تجريدي فارغ stopGuidance ()

إيقاف إرشادات التنقّل باتّجاهات مفصّلة