רכיב מפה באפליקציה. המקטע הזה הוא הדרך הפשוטה ביותר למקם מפה באפליקציה. זהו wrapper מסביב לתצוגה של מפה כדי לטפל באופן אוטומטי בצרכים הדרושים של מחזור החיים. מאחר שהרכיב הזה הוא מקטע, ניתן להוסיף אותו לקובץ פריסה של פעילות באמצעות ה-XML שבהמשך.
<fragment class="com.google.android.libraries.maps.MapFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>חובה לצרף
GoogleMap
באמצעות getMapAsync(OnMapReadyCallback)
. סיווג זה מפעיל באופן אוטומטי את מערכת המפות ואת התצוגה.
אפשר להסיר תצוגה על ידי קריאה ל-method onDestroyView()
של MapFragment והאפשרות useViewLifecycleInFragment(boolean)
מוגדרת. במצב כזה,
MapFragment כבר לא תקף עד שהתצוגה נוצרת מחדש מאוחר יותר, אחרי הפעלת השיטה onCreateView(LayoutInflater, ViewGroup, Bundle)
של MapFragment.
כל האובייקטים שהתקבלו מ-GoogleMap
משויכים לתצוגה המפורטת. חשוב לא לתפוס אובייקטים (למשל Marker
) מחוץ לגבולות החיים של התצוגה. אחרת, הדבר יגרום לדליפת זיכרון כי לא ניתן לשחרר את התצוגה.
יש להשתמש במחלקה הזו רק אם אתם מטרגטים לגרסה 12 ואילך של API. אחרת, אפשר להשתמש ב-SupportMapFragment על ידי הוספת ספריית התמיכה של Android לנתיב ה-build.
מדריך למפתחים
לקבלת מידע נוסף, אפשר לקרוא את המדריך למפתחים של Google Maps SDK ל-Android .
סיכום של ערכים קבועים בירושה
סיכום של הבנייה הציבורית
MapFragment()
יוצר מקטע של מפה.
|
סיכום אמצעי תשלום ציבורי
void |
getMapAsync(OnMapReadyCallback callback)
מגדיר אובייקט של קריאה חוזרת (callback) שיופעל כשהמכונה
GoogleMap תהיה מוכנה לשימוש. |
MapFragment סטטי | |
MapFragment סטטי |
newInstance()
יוצר קטע מפה, באמצעות אפשרויות ברירת המחדל.
|
void |
onActivityCreated(Bundle savedInstanceState)
|
void |
onAttach(פעילות פעילות)
|
void |
onConfigurationChanged(הגדרת תצורה)
|
void |
onCreate(Bundle savedInstanceState)
|
מעבר למצב תצוגה |
onCreateView(LayoutInflater Predictionr, מאגר ViewGroup, Bundle savedInstanceState)
|
void | |
void | |
תוקף סופי |
onEnterAmbient(Bundle ambientDetails)
צריך לקרוא לשיטה הזו מהשיטה המתאימה של גרסת ההורה WearableActivity.
|
תוקף סופי |
onExitAmbient()
צריך לקרוא לשיטה הזו מהשיטה המתאימה של גרסת ההורה WearableActivity.
|
void |
onInflate(Activity activity, AttributeSet attrs, Bundle savedInstanceState)
נתחו מאפיינים במהלך אינפלציה מהיררכיית תצוגות מפורטות לארגומנטים שבהם אנחנו מטפלים.
|
void | |
void |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(Bundle outState)
מספק
Bundle לאחסון מצב המקטע לפני שהוא נהרס. |
void |
onStart()
|
void |
onStop()
|
void |
setArguments(Bundle args)
|
סיכום שיטות שעברו בירושה
בניינים ציבוריים
ציבורי MapFragment ()
יוצר מקטע של מפה. הבנאי הזה ציבורי לשימוש רק על ידי נופח. יש להשתמש ב-newInstance()
כדי ליצור MapFragment באופן פרוגרמטי.
שיטות ציבוריות
Public void getMapAsync (OnMapReadyCallback קריאה חוזרת)
מגדיר אובייקט של קריאה חוזרת (callback) שיופעל כשהמכונה GoogleMap
תהיה מוכנה לשימוש.
הערה:
- צריך לקרוא לשיטה הזו מה-thread הראשי.
- הקריאה החוזרת תתבצע ב-thread הראשי.
- אם Google Play Services לא מותקנים במכשיר של המשתמש, הקריאה החוזרת (callback) לא תופעל עד שהמשתמש יתקין אותה.
- במקרים הנדירים שבהם מפות Google מושמדת מיד לאחר יצירתה, הקריאה החוזרת (callback) לא תופעל.
- האובייקט
GoogleMap
שסופק על ידי הקריאה החוזרת אינו null.
פרמטרים
קריאה חוזרת (callback) | אובייקט הקריאה החוזרת שיופעל כשהמפה תהיה מוכנה לשימוש. |
---|
ציבורי סטטי MapFragment newInstance (אפשרויות שלGoogleMapOptions)
יוצר קטע מפה עם האפשרויות הנתונות.
פרמטרים
אפשרויות |
---|
Public void onActivityCreated (Bundle savedInstanceState)
פרמטרים
savedInstanceState |
---|
Public void onAttach (פעילות הפעילות)
פרמטרים
פעילות |
---|
Public void onConfigurationChanged (Configuration config)
פרמטרים
הגדרה |
---|
Public void onCreate (Bundle savedInstanceState)
פרמטרים
savedInstanceState |
---|
Public View onCreateView (LayoutInflater Predictionr, ViewGroup container, bundle savedInstanceState)
פרמטרים
מנופחת | |
---|---|
מאגר | |
savedInstanceState |
Public void onDestroy ()
Public void onDestroyView ()
ציבורי סופי ריק onEnterAmbient (Bundle ambientDetails)
צריך לקרוא לשיטה הזו מהשיטה המתאימה של גרסת ההורה WearableActivity.
פרמטרים
ambientDetails |
---|
ציבורי סופי ריק onExitAmbient ()
צריך לקרוא לשיטה הזו מהשיטה המתאימה של גרסת ההורה WearableActivity.
Public void onInflate (Activity activity, AttributeSet attrs, Bundle savedInstanceState)
נתחו מאפיינים במהלך אינפלציה מהיררכיית תצוגות מפורטות לארגומנטים שבהם אנחנו מטפלים.
פרמטרים
פעילות | |
---|---|
attrs | |
savedInstanceState |
Public void onLowMemory ()
Public void onPause ()
Public void onResume ()
Public void onSaveInstanceState (Bundle outState)
מספק Bundle
לאחסון מצב המקטע לפני שהוא נהרס. אפשר
לאחזר אותה מאוחר יותר כשתתבצע שיחה חוזרת אל onCreate(Bundle)
.
פרמטרים
outState |
---|
Public void onStart ()
Public void onStop ()
Public void setArguments (Bundle args)
פרמטרים
args |
---|