أحد مكونات التنقل في تطبيق ما. هذا الجزء هو أبسط طريقة لاستخدام التنقل في التطبيق. وهو عبارة عن برنامج تضمين حول عرض خريطة تنقُّل لمعالجة الاحتياجات الضرورية لدورة الحياة تلقائيًا. يمكن إضافة هذا المكوِّن إلى ملف تنسيق نشاط باستخدام ملف XML أدناه، وذلك لأنّه جزء من الملف.
<fragment class="com.google.android.libraries.navigation.SupportNavigationFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>
ملخّص عام للمنشئ
ملخّص الطريقة العلنية
الكاميرا |
getCamera()
تعرض كائن الكاميرا الذي يمكن استخدامه لتغيير إطار العرض للخريطة.
|
NavigationMap |
getMap()
تعرض كائنًا يمكن استخدامه لإضافة محتوى إلى الخريطة.
|
void |
onConfigurationChanged(Configuration config)
|
عرض |
onCreateView(LayoutInflater inflater, ViewGroup, Bundle savedInstanceState)
|
void | |
void | |
void |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(حزمة outState)
|
void |
onStart()
|
void |
onStop()
|
void |
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode replaceInfoDisplayModeOverride)
تلغي هذه العلامة وضع العرض التلقائي لوسائل شرح الإعلان النصي الموسَّع أثناء التنقّل.
|
void |
setCalloutInfoFormatOverride(RouteCalloutInfoFormatوسيلة الشرحInfoFormatOverride)
لضبط وضع تنسيق معلومات وسائل الشرح لوسائل شرح المسار.
|
void |
setCompassEnabled(تفعيل منطقي)
لتحديد ما إذا كانت البوصلة مرئية أم لا.
|
void |
setCustomControl(عرض عنصر التحكّم، الموضع CustomControlPosition)
يعين طريقة عرض تحكم مخصصة والتي ستظهر في الموضع المحدد في واجهة مستخدم التنقل.
|
void |
setEtaCardEnabled(تفعيل منطقي)
لتحديد ما إذا كانت بطاقة الوقت المقدر للوصول ستظهر أثناء التنقل.
|
void |
setForceNightMode(int forceNightMode)
|
void |
setHeaderEnabled(تفعيل منطقي)
تحدِّد هذه السياسة ما إذا كان رأس التنقّل باتّجاهات مفصّلة مرئيًا أثناء التنقّل.
|
void |
setOnNightModeChangedListener(NavigationView.OnNightModeChangedListener مستمع)
يساعد هذا الإعداد على ضبط المستمع الذي سيتم إرسال إشعار إليه عند دخول واجهة المستخدم في الوضع الليلي أو الخروج منه.
|
void |
setOnRecenterButtonClickedListener(NavigationView.OnRecenterButtonClickedListener مستمع)
لضبط مستمع سيتم إرسال إشعار إليه عند النقر على زر إعادة التوسيط.
|
void |
setRecenterButtonEnabled(تفعيل منطقي)
يحدّد هذا الإعداد ما إذا كان يجب عرض زر إعادة التوسيط.
|
void |
setSpeedAlertOptions(SpeedAlertOptions speedAlertOptions)
تضبط هذه السياسة
SpeedAlertOptions لتخصيص حدود التشغيل لـ SpeedAlertSeverity . |
void |
setSpeedLimitIconEnabled(تفعيل منطقي)
يحدِّد هذا الإعداد ما إذا كان سيتم عرض رمز حدّ السرعة.
|
void |
setSpeedometerIconEnabled(تم تفعيل منطقية)
تحدِّد هذه السياسة ما إذا كان سيتم عرض رمز عدّاد السرعة.
|
void |
setSpeedometerUiOptions(SpeedometerUiOptions speedAlertUiOptions)
تضبط هذه السياسة إعدادات واجهة المستخدم لعدّاد السرعة على
SpeedometerUiOptions استنادًا إلى SpeedAlertSeverity . |
void | |
void |
setTrafficIncidentCardsEnabled(تفعيل منطقية)
لتحديد ما إذا كان يجب عرض بطاقات حوادث المرور عندما ينقر المستخدم على رمز حادث المرور.
|
void |
setTrafficPromptsEnabled(تفعيل منطقي)
يحدّد هذا الإعداد ما إذا كان يجب عرض مطالبات بشأن حركة المرور أم لا.
|
ملخّص الطريقة المكتسبة
مقاولات عامة
عام SupportNavigationFragment ()
الطرق العامة
متاح للجميع الكاميرا getCamera ()
تعرض كائن الكاميرا الذي يمكن استخدامه لتغيير إطار العرض للخريطة.
المرتجعات
- كائن
Camera
المرتبط بهذا الجزء
عامة إلغاء onConfigurationChanged (Configuration config)
المَعلمات
config |
---|
public عرض onCreateView (LayoutInflater inflater, ViewGroup بدءًا من حفظ الحِزمة InstanceState)
المَعلمات
أداة نفخ | |
---|---|
الحاوية | |
savedInstanceState |
عام إلغاء onDestroyView ()
عام فارغ onLowMemory ()
عامة إلغاء onPause ()
متاح للجميع لاغٍ onResume ()
public إلغاء onSaveInstanceState (Bundle outState)
المَعلمات
outState |
---|
عام فارغ onStart ()
عام إلغاء onStop ()
عامة إلغاء setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode قَوْلْInfoDisplayModeOverride)
تلغي هذه العلامة وضع العرض التلقائي لوسائل شرح الإعلان النصي الموسَّع أثناء التنقّل. يؤدي تمرير القيمة "فارغ" إلى إعادة ضبط وضع العرض التلقائي.
المَعلمات
calloutInfoDisplayModeOverride | وضع العرض الجديد المطلوب. |
---|
عام إلغاء setCalloutInfoFormatOverride (RouteCalloutInfoFormat قَوْلْInfoFormatOverride)
لضبط وضع تنسيق معلومات وسائل الشرح لوسائل شرح المسار. في حال عدم استدعاء هذه الطريقة، ستتبع وسائل الشرح السلوك المحدّد في RouteCalloutInfoFormat.DEFAULT.
المَعلمات
calloutInfoFormatOverride | شكل وسيلة الشرح الجديد المطلوب |
---|
عام إلغاء setCompassEnabled (boolean enabled)
لتحديد ما إذا كانت البوصلة مرئية أم لا. يجب طلب هذه الطريقة فقط في سلسلة واجهة المستخدم.
المَعلمات
مفعّلة |
---|
عام إلغاء setCustomControl (عرض عنصر التحكّم، الموضع CustomControlPosition)
يعين طريقة عرض تحكم مخصصة والتي ستظهر في الموضع المحدد في واجهة مستخدم التنقل. سيتم استبدال أي عنصر تحكّم مخصّص في الموضع المحدّد. سيؤدي استدعاء هذه الطريقة بقيمة تحكّم فارغة إلى إزالة عنصر التحكّم المخصّص في الموضع المحدّد. في حال تمت إضافة عنصر التحكّم في موضع مختلف أو سبق أن تمت إضافة عنصر رئيسي له، سيتم تجاهله. يجب طلب هذه الطريقة فقط في سلسلة واجهة المستخدم.
المَعلمات
تحكم | عرض سيتم وضعه داخل واجهة مستخدم التنقل |
---|---|
الموضع | يحدد مكان وضع عنصر التحكم المخصص في واجهة المستخدم بالنسبة إلى عناصر التحكم المضمنة. |
public إلغاء setEtaCardEnabled (boolean enabled)
لتحديد ما إذا كانت بطاقة الوقت المقدر للوصول ستظهر أثناء التنقل. ويجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.
المَعلمات
مفعّلة |
---|
متاح للجميع إلغاء setForceNightMode (int forceNightMode)
المَعلمات
forceNightMode |
---|
public إلغاء setHeaderEnabled (boolean enabled)
تحدِّد هذه السياسة ما إذا كان رأس التنقّل باتّجاهات مفصّلة مرئيًا أثناء التنقّل. يجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.
المَعلمات
مفعّلة |
---|
عامة إلغاء setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener مستمع)
يساعد هذا الإعداد على ضبط المستمع الذي سيتم إرسال إشعار إليه عند دخول واجهة المستخدم في الوضع الليلي أو الخروج منه. يجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.
ملاحظة: لتجنُّب تسرُّب الذاكرة، يجب استدعاء setOnNightModeChangedListener(null)
عندما لا يكون المستمع مطلوبًا.
المَعلمات
أداة معالجة الحدث | مستمِع يتم إرسال إشعار إليه عند دخول واجهة المستخدم في الوضع الليلي أو الخروج منه |
---|
public باطلة setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener مستمع)
لضبط مستمع سيتم إرسال إشعار إليه عند النقر على زر إعادة التوسيط. يجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.
ملاحظة: لتجنُّب تسرُّب الذاكرة، يجب استدعاء setOnRecenterButtonClickedListener(null)
عندما لا يكون المستمع مطلوبًا.
المَعلمات
أداة معالجة الحدث | المستمع الذي سيتم إرسال إشعار إليه عند النقر على زر إعادة التوسيط |
---|
متاح للجميع إلغاء setRecenterButtonEnabled (boolean enabled)
يحدّد هذا الإعداد ما إذا كان يجب عرض زر إعادة التوسيط. ويجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.
المَعلمات
مفعّلة |
---|
عامة إلغاء setSpeedAlertOptions (SpeedAlertOptions speedAlertOptions)
تضبط هذه السياسة SpeedAlertOptions
لتخصيص حدود التشغيل لـ SpeedAlertSeverity
.
يمكنك استخدام هذه الطريقة لتخصيص حدود تشغيل تنبيه السرعة بالنسبة المئوية
لكل من تنبيهَي MINOR
وMAJOR
. يمكنك أيضًا
استخدام هذه الطريقة لضبط الوقت بالثواني اللازم لترقية تنبيهات السرعة من MINOR
إلى MAJOR
.
عند ضبط null
SpeedAlertOptions
أو عدم ضبطها، سيعرض تنبيه السرعة التلقائي
الخاص بـ NavSDK: يعرض تنبيه السرعة نصًا أحمر بخلفية بيضاء/داكنة للوضع النهاري/الليلي على التوالي عندما تكون السرعة أقل من 5 ميل في الساعة أو 10 كم/ساعة عند تجاوز الحد الأقصى للسرعة، ويعرض
نصًا أبيض في الخلفية الحمراء عند زيادة السرعة التي تزيد عن 5 ميل في الساعة أو 10 كم/ساعة.
المَعلمات
speedAlertOptions |
---|
متاح للجميع إلغاء setSpeedLimitIconEnabled (boolean enabled)
يحدِّد هذا الإعداد ما إذا كان سيتم عرض رمز حدّ السرعة. استدعِ هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.
عند تفعيل هذه الميزة، يظهر رمز حدّ السرعة الذي يشير إلى حدّ سرعة الطريق في الزاوية السفلية من البداية أثناء التوجيه. لا يظهر الرمز إلا في المواقع الجغرافية التي تتوفّر فيها بيانات موثوقة عن حدود السرعة. عند ظهور رمز عدّاد السرعة، يتم إرفاقها.
في حال تفعيل زر إعادة التوسيط، يكون رمز حد السرعة مخفيًا مؤقتًا عند عرض زر إعادة الضبط.
ملاحظة: على السائقين اتّباع جميع اللافتات المنشورة على الطريق واستخدام رمز حدّ السرعة كمرجع فقط. لا يمكن ضمان دقة بيانات حد السرعة. يمكنك الإبلاغ عن عدم دقة في بيانات حدود السرعة من خلال تقديم طلب في بوابة دعم Google Cloud.
المَعلمات
مفعّلة |
---|
متاح للجميع إلغاء setSpeedometerIconEnabled (boolean enabled)
تحدِّد هذه السياسة ما إذا كان سيتم عرض رمز عدّاد السرعة. استدعِ هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.
عندما تكون هذه الميزة مفعّلة، يظهر رمز عدّاد السرعة الذي يشير إلى سرعة المركبة في أسفل زاوية البداية أثناء اتّباع الإرشادات. عندما يظهر رمز حدّ السرعة، يتم إرفاقه، وبعد ذلك يمكن أن يتضمّن عدّاد السرعة ألوانًا مختلفة للنص والخلفية، ويعتمد ذلك على مدى خطورة السرعة.
يؤدي تفعيل رمز مقياس السرعة إلى تفعيل رمز الحدّ الأقصى للسرعة أيضًا، ولكن يمكنك استخدام
setSpeedLimitIconEnabled(boolean)
لإيقاف أو تفعيل رمز حدّ السرعة بشكل منفصل.
إذا كان زر إعادة الضبط مفعّلاً، يكون رمز عدّاد السرعة مخفيًا مؤقتًا عند ظهور زر إعادة الضبط.
المَعلمات
مفعّلة |
---|
متاح للجميع إلغاء setSpeedometerUiOptions (SpeedometerUiOptions speedAlertUiOptions)
تضبط هذه السياسة إعدادات واجهة المستخدم لعدّاد السرعة على SpeedometerUiOptions
استنادًا إلى SpeedAlertSeverity
. استدعِ هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.
من خلال ضبط null
SpeedometerUiOptions
، يتم محو الإجراء السابق في حال ضبطه. في حال عدم ضبط أي SpeedometerUiOptions
، يتم الرجوع إلى واجهة مستخدم عدّاد السرعة إلى إعدادات NavSDK التلقائية
لتنبيهات السرعة لمختلف SpeedAlertSeverity
:
المَعلمات
speedAlertUiOptions |
---|
عامة إلغاء setStylingOptions (StylingOptions styleOptions)
تعيين بعض خيارات التصميم لواجهة مستخدم التنقل. ويجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.
المَعلمات
stylingOptions |
---|
public إلغاء setTrafficIncidentCardsEnabled (boolean enabled)
لتحديد ما إذا كان يجب عرض بطاقات حوادث المرور عندما ينقر المستخدم على رمز حادث المرور. يجب طلب هذه الطريقة فقط في سلسلة واجهة المستخدم.
المَعلمات
مفعّلة |
---|
عامة إلغاء setTrafficPromptsEnabled (boolean enabled)
يحدّد هذا الإعداد ما إذا كان يجب عرض مطالبات بشأن حركة المرور أم لا. تظهر رسائل المطالبة المتعلّقة بالزيارات بشكل دوري لإعلام المستخدم بأحوال حركة المرور أثناء التنقّل. ويجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.
المَعلمات
مفعّلة |
---|