עיצוב מפות חדש יתווסף בקרוב לפלטפורמה של מפות Google. העדכון הזה בסגנון המפה כולל לוח צבעים חדש שמוגדר כברירת מחדל ושיפורים בחוויית השימוש במפות ובנוחות השימוש. כל סגנונות המפה יעודכנו באופן אוטומטי במרץ 2025. אפשר לקרוא מידע נוסף על זמינות ועל האפשרות להצטרף בשלב מוקדם יותר במאמר בנושא סגנון מפה חדש לפלטפורמה של מפות Google.

דף זה תורגם על ידי Cloud Translation API.

מקטע מפה

מחלקה ציבורית MapFragment מרחיבה את Fragment

רכיב מפה באפליקציה. המקטע הזה הוא הדרך הפשוטה ביותר למקם מפה באפליקציה. זהו 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 .

סיכום של ערכים קבועים בירושה

מהממשק android.content.ComponentCallbacks2

int	TRIM_MEMORY_BACKGROUND
int	TRIM_MEMORY_COMPLETE
int	TRIM_MEMORY_MODERATE
int	TRIM_MEMORY_RUNNING_CRITICAL
int	TRIM_MEMORY_RUNNING_LOW
int	TRIM_MEMORY_RUNNING_MODERATE
int	TRIM_MEMORY_UI_HIDDEN

סיכום של הבנייה הציבורית

MapFragment()

יוצר מקטע של מפה.

סיכום אמצעי תשלום ציבורי

void	getMapAsync(OnMapReadyCallback callback) מגדיר אובייקט של קריאה חוזרת (callback) שיופעל כשהמכונה `GoogleMap` תהיה מוכנה לשימוש.
MapFragment סטטי	newInstance(אפשרויות ל-GoogleMapOptions) יוצר קטע מפה עם האפשרויות הנתונות.
MapFragment סטטי	newInstance() יוצר קטע מפה, באמצעות אפשרויות ברירת המחדל.
void	onActivityCreated(Bundle savedInstanceState)
void	onAttach(פעילות פעילות)
void	onConfigurationChanged(הגדרת תצורה)
void	onCreate(Bundle savedInstanceState)
מעבר למצב תצוגה	onCreateView(LayoutInflater Predictionr, מאגר ViewGroup, Bundle savedInstanceState)
void	onDestroy()
void	onDestroyView()
תוקף סופי	onEnterAmbient(Bundle ambientDetails) צריך לקרוא לשיטה הזו מהשיטה המתאימה של גרסת ההורה WearableActivity.
תוקף סופי	onExitAmbient() צריך לקרוא לשיטה הזו מהשיטה המתאימה של גרסת ההורה WearableActivity.
void	onInflate(Activity activity, AttributeSet attrs, Bundle savedInstanceState) נתחו מאפיינים במהלך אינפלציה מהיררכיית תצוגות מפורטות לארגומנטים שבהם אנחנו מטפלים.
void	onLowMemory()
void	onPause()
void	onResume()
void	onSaveInstanceState(Bundle outState) מספק `Bundle` לאחסון מצב המקטע לפני שהוא נהרס.
void	onStart()
void	onStop()
void	setArguments(Bundle args)

סיכום שיטות שעברו בירושה

מהכיתה android.app.Fragment

void	dump(String arg0, FileDescriptor arg1, PrintWriter arg2, String[] arg3)
ערך בוליאני סופי	equals(Object arg0)
פעילות סופית	getActivity()
boolean	getAllowEnterTransitionOverlap()
boolean	getAllowReturnTransitionOverlap()
חבילה סופית	getArguments()
FragmentManager	getChildFragmentManager()
הקשר	getContext()
מעבר	getEnterTransition()
מעבר	getExitTransition()
FragmentManager	getFragmentManager()
אובייקט סופי	getHost()
INT	getId()
סופית LayoutInflater	getLayoutInflater()
LoaderManager	getLoaderManager()
מקטע סופי	getParentFragment()
מעבר	getReenterTransition()
משאבים סופיים	getResources()
ערך בוליאני סופי	getRetainInstance()
מעבר	getReturnTransition()
מעבר	getSharedElementEnterTransition()
מעבר	getSharedElementReturnTransition()
מחרוזת סופית	getString(int arg0, Object... arg1)
מחרוזת סופית	getString(int arg0)
מחרוזת סופית	getTag()
מקטע סופי	getTargetFragment()
INT	getTargetRequestCode()
סיום CcharSequence	getText(int arg0)
boolean	getUserVisibleHint()
מעבר למצב תצוגה	getView()
INT	hashCode()
מקטע סטטי	instantiate(Context arg0, String arg1)
מקטע סטטי	instantiate(Context arg0, String arg1, Bundle arg2)
ערך בוליאני סופי	isAdded()
ערך בוליאני סופי	isDetached()
ערך בוליאני סופי	isHidden()
ערך בוליאני סופי	isInLayout()
ערך בוליאני סופי	isRemoving()
ערך בוליאני סופי	isResumed()
ערך בוליאני סופי	isStateSaved()
ערך בוליאני סופי	isVisible()
void	onActivityCreated(Bundle arg0)
void	onActivityResult(int arg0, int arg1, Intent arg2)
void	onAttach(פעילות arg0)
void	onAttach(הקשר arg0)
void	onAttachFragment(Fragment arg0)
void	onConfigurationChanged(Configuration arg0)
boolean	onContextItemSelected(תפריטItem arg0)
void	onCreate(Bundle arg0)
אנימטורים	onCreateAnimator(int arg0, boolean arg1, int arg2)
void	onCreateContextMenu(Contextmenu arg0, View arg1, Contextmenu.ContextmenuInfo arg2)
void	onCreateOptionsMenu(תפריט arg0, MenuInflater arg1)
מעבר למצב תצוגה	onCreateView(LayoutInflater arg0, ViewGroup arg1, Bundle arg2)
void	onDestroy()
void	onDestroyOptionsMenu()
void	onDestroyView()
void	onDetach()
LayoutInflater	onGetLayoutInflater(Bundle arg0)
void	onHiddenChanged(boolean arg0)
void	onInflate(AttributeSet arg0, Bundle arg1)
void	onInflate(Activity arg0, AttributeSet arg1, Bundle arg2)
void	onInflate(Context arg0, AttributeSet arg1, Bundle arg2)
void	onLowMemory()
void	onMultiWindowModeChanged(boolean arg0)
void	onMultiWindowModeChanged(boolean arg0, Configuration arg1)
boolean	onOptionsItemSelected(menuItem arg0)
void	onOptionsMenuClosed(תפריט arg0)
void	onPause()
void	onPictureInPictureModeChanged(boolean arg0, Configuration arg1)
void	onPictureInPictureModeChanged(boolean arg0)
void	onPrepareOptionsMenu(תפריט arg0)
void	onRequestPermissionsResult(int arg0, String[] arg1, int[] arg2)
void	onResume()
void	onSaveInstanceState(Bundle arg0)
void	onStart()
void	onStop()
void	onTrimMemory(int arg0)
void	onViewCreated(View arg0, Bundle arg1)
void	onViewStateRestored(Bundle arg0)
void	postponeEnterTransition()
void	registerForContextMenu(הצגת arg0)
תוקף סופי	requestPermissions(String[] arg0, int arg1)
void	setAllowEnterTransitionOverlap(boolean arg0)
void	setAllowReturnTransitionOverlap(boolean arg0)
void	setArguments(Bundle arg0)
void	setEnterSharedElementCallback(SharedElementCallback arg0)
void	setEnterTransition(מעבר arg0)
void	setExitSharedElementCallback(SharedElementCallback arg0)
void	setExitTransition(מעבר arg0)
void	setHasOptionsMenu(boolean arg0)
void	setInitialSavedState(Fragment.SavedState arg0)
void	setMenuVisibility(boolean arg0)
void	setReenterTransition(מעבר arg0)
void	setRetainInstance(boolean arg0)
void	setReturnTransition(מעבר arg0)
void	setSharedElementEnterTransition(מעבר arg0)
void	setSharedElementReturnTransition(מעבר arg0)
void	setTargetFragment(Fragment arg0, int arg1)
void	setUserVisibleHint(boolean arg0)
boolean	shouldShowRequestPermissionRationale(מחרוזת arg0)
void	startActivity(Intent arg0)
void	startActivity(Intent arg0, Bundle arg1)
void	startActivityForResult(Intent arg0, int arg1)
void	startActivityForResult(Intent arg0, int arg1, Bundle arg2)
void	startIntentSenderForResult(IntentSender arg0, int arg1, Intent arg2, int arg3, int arg4, int arg5, Bundle arg6)
void	startPostponedEnterTransition()
מחרוזת	toString()
void	unregisterForContextMenu(הצגת arg0)

מכיתה java.lang.Object

boolean	equals(Object arg0)
סופי כיתה<?>	getClass()
int	hashCode()
תוקף סופי	notify()
תוקף סופי	notifyAll()
מחרוזת	toString()
תוקף סופי	wait(long arg0, int arg1)
תוקף סופי	wait(long arg0)
תוקף סופי	wait()

מהממשק android.content.ComponentCallbacks2

מופשט וריק

onTrimMemory(int arg0)

מהממשק android.view.View.OnCreateContextmenuListener

מופשט וריק

onCreateContextMenu(Contextmenu arg0, View arg1, Contextmenu.ContextmenuInfo arg2)

מהממשק android.content.ComponentCallbacks

מופשט וריק	onConfigurationChanged(Configuration arg0)
מופשט וריק	onLowMemory()

בניינים ציבוריים

ציבורי MapFragment ()

יוצר מקטע של מפה. הבנאי הזה ציבורי לשימוש רק על ידי נופח. יש להשתמש ב-newInstance() כדי ליצור MapFragment באופן פרוגרמטי.

שיטות ציבוריות

Public void getMapAsync (OnMapReadyCallback קריאה חוזרת)

מגדיר אובייקט של קריאה חוזרת (callback) שיופעל כשהמכונה GoogleMap תהיה מוכנה לשימוש.

הערה:

צריך לקרוא לשיטה הזו מה-thread הראשי.
הקריאה החוזרת תתבצע ב-thread הראשי.
אם Google Play Services לא מותקנים במכשיר של המשתמש, הקריאה החוזרת (callback) לא תופעל עד שהמשתמש יתקין אותה.
במקרים הנדירים שבהם מפות Google מושמדת מיד לאחר יצירתה, הקריאה החוזרת (callback) לא תופעל.
האובייקט GoogleMap שסופק על ידי הקריאה החוזרת אינו null.

פרמטרים

קריאה חוזרת (callback)	אובייקט הקריאה החוזרת שיופעל כשהמפה תהיה מוכנה לשימוש.

ציבורי סטטי MapFragment newInstance (אפשרויות שלGoogleMapOptions)

יוצר קטע מפה עם האפשרויות הנתונות.

פרמטרים

אפשרויות

Public סטטי MapFragment newInstance ()

יוצר קטע מפה, באמצעות אפשרויות ברירת המחדל.

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