المفرد المفرد الذي يوفر طرقًا للتحكم في التنقل.
نضمن أن تكون جميع الطرق آمنة من سلاسل المحادثات باستثناء الاستراتيجيتَين 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 إذا كانت الإرشادات قيد التشغيل حاليًا. |
تجريدي باطلة | |
تجريدي باطلة |
setAudioGuidance(إرشادات int)
يحدد هذا الإعداد أنواع الإرشاد الصوتي (بما في ذلك الاهتزاز) التي يتم تفعيلها.
|
ملخّص ListenableResultFuture<Navigator.RouteStatus> |
setDestination(وجهة Waypoint، وRoutingOptions خيارات التوجيه، وDisplayOptions خيارات العرض)
لتعيين وجهة واحدة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا.
|
ملخّص ListenableResultFuture<Navigator.RouteStatus> |
setDestination(وجهة Waypoint، خيارات RoutingOptions)
لتعيين وجهة واحدة للتنقل، وتجاوز أي وجهات تم تحديدها مسبقًا.
|
ملخّص ListenableResultFuture<Navigator.RouteStatus> | |
ملخّص 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(الوجهات)
عام 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 ()
إيقاف إرشادات التنقّل باتّجاهات مفصّلة