دعم SupportmapFragment

حصة علنية SupportMapFragment توسيع الجزء

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

 <fragment
    class="com.google.android.libraries.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>
يجب الحصول على GoogleMap باستخدام getMapAsync(OnMapReadyCallback). هذا الصف يقوم تلقائيًا بتهيئة نظام الخرائط والعرض.

يمكن إزالة طريقة عرض عند استدعاء طريقة onDestroyView() في SupportMapFragment تم ضبط الخيار "useViewLifecycleInFragment(boolean)". وعند حدوث ذلك، لم تعد SupportMapFragment صالحة حتى تتم إعادة إنشاء العرض مرة أخرى لاحقًا عندما يكون يتم استدعاء طريقة onCreateView(LayoutInflater, ViewGroup, Bundle).

وتكون أيّ عناصر تم الحصول عليها من GoogleMap مرتبطة بالملف الشخصي. من المهم عدم الاحتفاظ بأشياء (مثل Marker) خارج حياة العرض. وإلّا سيؤدي ذلك إلى حدوث تسرُّب للذاكرة بسبب عدم إمكانية إلغاء العرض.

لاستخدام هذه الفئة، يجب تضمين مكتبة دعم Android في مسار الإصدار.

دليل المطوِّر

للحصول على مزيد من المعلومات، يُرجى الاطّلاع على حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android دليل المطوِّر.

ملخّص الإنشاء العام

SupportMapFragment()
لإنشاء جزء من الخريطة.

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

فراغ
getMapAsync(OnMapReadyCallback callback)
تحدّد هذه السياسة كائن معاودة الاتصال الذي سيتم تشغيله عندما يكون المثيل GoogleMap جاهزًا تنبؤي.
ثابتة SupportMapFragment
newInstance(خيارات GoogleMapOptions)
تنشئ جزءًا على الخريطة بالخيارات المحددة.
ثابتة SupportMapFragment
newInstance()
تنشئ جزءًا من الخريطة باستخدام الخيارات التلقائية.
فراغ
onActivityCreated(Bundle savedInstanceState)
فراغ
onAttach(نشاط النشاط)
فراغ
onConfigurationChanged(ضبط الإعدادات)
فراغ
onCreate(Bundle savedInstanceState)
عرض
onCreateView(مضخّم LayoutInflater، وحاوية ViewGroup، و Bundle savedInstanceState)
فراغ
onDestroy()
فراغ
onDestroyView()
النِّهَائِي فراغ
onEnterAmbient(حزمة الاستراحة)
يجب استدعاء هذه الطريقة من الطريقة المقابلة لـ WearableActivity الرئيسية.
النِّهَائِي فراغ
onExitAmbient()
يجب استدعاء هذه الطريقة من الطريقة المقابلة لـ WearableActivity الرئيسية.
فراغ
onInflate(نشاط النشاط، AttributeSet attrs، و Bundle savedInstanceState)
تحليل السمات أثناء التضخم من تسلسل هرمي لطريقة العرض إلى الوسيطات التي نتعامل معها.
فراغ
onLowMemory()
فراغ
onPause()
فراغ
onResume()
فراغ
onSaveInstanceState(Bundle outState)
يتم توفير Bundle لتخزين حالة الجزء قبل إتلافه.
فراغ
onStart()
فراغ
onStop()
فراغ
setArguments(وسيطات الحِزم)

ملخّص الطرق المكتسبة

الشركات المصنّعة العامة

علنية SupportMapFragment ()

لإنشاء جزء من الخريطة. هذه الدالة الإنشائية عامة فقط ولا يمكن استخدامها بواسطة أداة نفخ. استخدِم newInstance() لإنشاء SupportMapFragment آليًا.

الطرق العامة

علنية فراغ getMapAsync (معاودة الاتصال على OnMapReadyCallback)

تحدّد هذه السياسة كائن معاودة الاتصال الذي سيتم تشغيله عندما يكون المثيل GoogleMap جاهزًا تنبؤي.

تجدر الإشارة إلى ما يلي:

  • يجب طلب هذه الطريقة من سلسلة التعليمات الرئيسية.
  • سيتم تنفيذ عملية الاستدعاء في سلسلة المحادثات الرئيسية.
  • في حال عدم تثبيت "خدمات Google Play" على جهاز المستخدم لن يتم تشغيل معاودة الاتصال حتى يثبّتها المستخدم.
  • في هذه الحالة النادرة حيث يتم إتلاف خريطة Google بعد إنشائها مباشرةً، عدم تشغيل معاودة الاتصال.
  • الكائن GoogleMap الذي توفره ميزة الاستدعاء غير فارغ.

المعلمات
رد الاتصال عنصر معاودة الاتصال الذي سيتم تشغيله عندما تكون الخريطة جاهزة للاستخدام.

علنية ثابتة SupportMapFragment newInstance (GoogleMapOptions الخيارات)

تنشئ جزءًا على الخريطة بالخيارات المحددة.

المعلمات
الخيارات

علنية ثابتة SupportMapFragment newInstance ()

تنشئ جزءًا من الخريطة باستخدام الخيارات التلقائية.

علنية فراغ onActivityCreated (Bundle savedInstanceState)

المعلمات
savedInstanceState

علنية فراغ onAttach (نشاط النشاط)

المعلمات
النشاط

علنية فراغ onConfigurationChanged (ضبط الإعدادات)

المعلمات
config

علنية فراغ onCreate (Bundle savedInstanceState)

المعلمات
savedInstanceState

علنية عرض onCreateView (مضخّم LayoutInflater، حاوية ViewGroup، حزمة savedInstanceState)

المعلمات
نفخ
الحاوية
savedInstanceState

علنية فراغ onDestroy ()

علنية فراغ onDestroyView ()

علنية النِّهَائِي فراغ onEnterAmbient (الحِزمة المحيطة/التفاصيل)

يجب استدعاء هذه الطريقة من الطريقة المقابلة لـ WearableActivity الرئيسية.

المعلمات
ambientDetails

علنية النِّهَائِي فراغ onExitAmbient ()

يجب استدعاء هذه الطريقة من الطريقة المقابلة لـ WearableActivity الرئيسية.

علنية فراغ onInflate (نشاط النشاط، AttributeSet attrs، و Bundle savedInstanceState)

تحليل السمات أثناء التضخم من تسلسل هرمي لطريقة العرض إلى الوسيطات التي نتعامل معها.

المعلمات
النشاط
attrs
savedInstanceState

علنية فراغ onLowMemory ()

علنية فراغ onPause ()

علنية فراغ onResume ()

علنية فراغ onSaveInstanceState (Bundle outState)

يتم توفير Bundle لتخزين حالة الجزء قبل أن يتم إتلافه. مُمْكِنْ استردادها لاحقًا عند استدعاء الدالة onCreate(Bundle) مجددًا.

المعلمات
outState

علنية فراغ onStart ()

علنية فراغ onStop ()

علنية فراغ setArguments (وسيطات الحزم)

المعلمات
الوسيط