جزء من الخريطة

الفئة العامة MapFragment تعمل على توسيع Fragment

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

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

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

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

لا تستخدِم هذا الصف إلا إذا كنت تستهدف واجهة برمجة التطبيقات 12 والإصدارات الأحدث. وبخلاف ذلك، يمكنك استخدام SupportMapFragment من خلال إضافة مكتبة دعم Android إلى مسار الإصدار.

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

للحصول على مزيد من المعلومات، اطّلع على دليل مطوّري البرامج SDK لخرائط Google لنظام التشغيل Android .

ملخّص ثابت مكتسَب

ملخّص عام للمنشئ

MapFragment()
ينشئ جزءًا من الخريطة.

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

void
getMapAsync(OnMapReadyCallback callback)
تعمل هذه السياسة على ضبط كائن استدعاء يتم تشغيله عندما يكون المثيل GoogleMap جاهزًا للاستخدام.
MapFragment ثابتة
newInstance(خيارات GoogleMapOptions)
تنشئ جزءًا من الخريطة باستخدام الخيارات المحددة.
MapFragment ثابتة
newInstance()
إنشاء جزء من الخريطة، باستخدام الخيارات التلقائية.
void
onActivityCreated(Bundle savedInstanceState)
void
onAttach(نشاط النشاط)
void
onConfigurationChanged(Configuration config)
void
onCreate(Bundle savedInstanceState)
عرض
onCreateView(LayoutInflater inflater, ViewGroup, Bundle savedInstanceState)
void
void
الفراغ الأخير
onEnterAmbient(حزمة ambiaDetails)
يجب استدعاء هذه الطريقة من الطريقة المقابلة في تطبيق WearableActivity الرئيسي.
الفراغ الأخير
onExitAmbient()
يجب استدعاء هذه الطريقة من الطريقة المقابلة في تطبيق WearableActivity الرئيسي.
void
onInflate(Activity activity, AttributeSet attrs, Bundle savedInstanceState)
تحليل السمات أثناء التضخم من العرض الهرمي لطريقة العرض إلى الوسيطات التي نتعامل معها.
void
void
void
void
onSaveInstanceState(حزمة outState)
توفر هذه السياسة Bundle لتخزين حالة الجزء قبل تدميره.
void
void
onStop()
void
setArguments(وسيطات الحزمة)

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

مقاولات عامة

عامة MapFragment ()

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

الطرق العامة

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

تعمل هذه السياسة على ضبط كائن استدعاء يتم تشغيله عندما يكون المثيل GoogleMap جاهزًا للاستخدام.

ملاحظات:

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

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

عامة ثابتة MapFragment newInstance (خيارات GoogleMapOptions)

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

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

public static MapFragment newInstance ()

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

إبطال عام onActivityCreated (Bundle savedInstanceState)

المَعلمات
savedInstanceState

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

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

إبطال عام onConfigurationChanged (Configuration config)

المَعلمات
config

إبطال عام onCreate (Bundle savedInstanceState)

المَعلمات
savedInstanceState

عامة عرض onCreateView (LayoutInflater inflater, ViewGroup, Bundle savedInstanceState)

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

إلغاء عام onDestroy ()

إلغاء عام onDestroyView ()

إلغاء علني نهائي onEnterAmbient (حزمة الأذن تفاصيل المنتج)

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

المَعلمات
ambientDetails

إلغاء عام أخير onExitAmbient ()

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

public void onInflate (Activity activity, AttributeSet attrs, Bundle savedInstanceState)

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

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

فارغ علني onLowMemory ()

إلغاء علني onPause ()

فارغ أمام الجمهور onResume ()

إبطال عام onSaveInstanceState (حزمة outState)

توفر هذه السياسة Bundle لتخزين حالة الجزء قبل تدميره. ويمكن استرداده لاحقًا عند طلب "onCreate(Bundle)" مرة أخرى.

المَعلمات
outState

فارغ علني onStart ()

إلغاء علني onStop ()

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

المَعلمات
args