مكوِّن خرائط في تطبيق. هذا الجزء هو أبسط طريقة لوضع خريطة في أحد التطبيقات. وهو برنامج تضمين حول عرض خريطة للتعامل تلقائيًا مع احتياجات دورة الحياة الضرورية. يمكن إضافة هذا المكوِّن إلى ملف تنسيق نشاط باستخدام ملف 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)
لـ SupportMapFragment.
وتكون أي عناصر تم الحصول عليها من GoogleMap
مرتبطة بالملف الشخصي. من المهم
عدم الاحتفاظ بالعناصر (مثل Marker
) خارج
مدة العرض. وإلا فسيتسبب ذلك في تسرب الذاكرة حيث لا يمكن تحرير العرض.
لاستخدام هذا الصف، عليك تضمين مكتبة دعم Android في مسار الإصدار الخاص بك.
دليل المطوِّر
للحصول على مزيد من المعلومات، اطّلع على دليل مطوّري البرامج SDK لخرائط Google لنظام التشغيل Android .
ملخّص عام للمنشئ
SupportMapFragment()
ينشئ جزءًا من الخريطة.
|
ملخّص الطريقة العلنية
void |
getMapAsync(OnMapReadyCallback callback)
تعمل هذه السياسة على ضبط كائن استدعاء يتم تشغيله عندما يكون المثيل
GoogleMap جاهزًا للاستخدام. |
SupportMapFragment ثابت | |
SupportMapFragment ثابت |
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 |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(حزمة outState)
توفر هذه السياسة
Bundle لتخزين حالة الجزء قبل تدميره. |
void |
onStart()
|
void |
onStop()
|
void |
setArguments(وسيطات الحزمة)
|
ملخّص الطريقة المكتسبة
مقاولات عامة
عامة SupportMapFragment ()
ينشئ جزءًا من الخريطة. إنّ طريقة الإنشاء هذه متاحة للجميع فقط، ولا يمكن استخدامها إلا من قِبل شخص يشتعل. استخدام newInstance()
لإنشاء SupportMapFragment بشكل آلي.
الطرق العامة
إلغاء علني getMapAsync (معاودة الاتصال في OnMapReadyCallback)
تعمل هذه السياسة على ضبط كائن استدعاء يتم تشغيله عندما يكون المثيل GoogleMap
جاهزًا للاستخدام.
ملاحظات:
- يجب طلب هذه الطريقة من سلسلة التعليمات الرئيسية.
- سيتم تنفيذ رد الاتصال في سلسلة التعليمات الرئيسية.
- في حال عدم تثبيت "خدمات Google Play" على جهاز المستخدم، لن يتم بدء معاودة الاتصال حتى يثبّتها المستخدم.
- في الحالات النادرة التي يتم فيها تدمير "خريطة Google" بعد إنشائها مباشرةً، لا يتم تشغيل معاودة الاتصال.
- لا يتوفّر كائن
GoogleMap
الذي يوفّره استدعاء الدالة.
المَعلمات
رد الاتصال | كائن معاودة الاتصال الذي سيتم تشغيله عندما تكون الخريطة جاهزة للاستخدام. |
---|
عامة ثابتة SupportMapFragment newInstance (خيارات GoogleMapOptions)
تنشئ جزءًا من الخريطة باستخدام الخيارات المحددة.
المَعلمات
الخيارات |
---|
إبطال عام 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 |
---|