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

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

SupportMapsFragment

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

רכיב מפה באפליקציה. המקטע הזה הוא הדרך הפשוטה ביותר למקם מפה באפליקציה. זהו wrapper מסביב לתצוגה של מפה כדי לטפל באופן אוטומטי בצרכים הדרושים של מחזור החיים. מאחר שהרכיב הזה הוא מקטע, ניתן להוסיף אותו לקובץ פריסה של פעילות באמצעות ה-XML שבהמשך.

 <fragment
    class="com.google.android.libraries.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

חובה לצרף GoogleMap באמצעות getMapAsync(OnMapReadyCallback). סיווג זה מפעיל באופן אוטומטי את מערכת המפות ואת התצוגה.

אפשר להסיר תצוגה כשמתבצעת קריאה ל-method onDestroyView() של SupportMapFragment והאפשרות useViewLifecycleInFragment(boolean) מוגדרת. במצב כזה, SupportMapFragment לא תקף יותר עד שהתצוגה נוצרת מחדש מאוחר יותר, אחרי הפעלת השיטה onCreateView(LayoutInflater, ViewGroup, Bundle) של SupportMapFragment.

כל האובייקטים שהתקבלו מ-GoogleMap משויכים לתצוגה המפורטת. חשוב לא לתפוס אובייקטים (למשל Marker) מחוץ לגבולות החיים של התצוגה. אחרת, הדבר יגרום לדליפת זיכרון כי לא ניתן לשחרר את התצוגה.

כדי להשתמש בשיעור הזה, צריך לכלול את ספריית התמיכה של Android בנתיב ה-build.

מדריך למפתחים

לקבלת מידע נוסף, אפשר לקרוא את המדריך למפתחים של Google Maps SDK ל-Android .

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

SupportMapFragment()

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

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

void	getMapAsync(OnMapReadyCallback callback) מגדיר אובייקט של קריאה חוזרת (callback) שיופעל כשהמכונה `GoogleMap` תהיה מוכנה לשימוש.
SupportMapFragment	newInstance(אפשרויות ל-GoogleMapOptions) יוצר קטע מפה עם האפשרויות הנתונות.
SupportMapFragment	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.support.v4.app.Fragment

void	dump(String arg0, FileDescriptor arg1, PrintWriter arg2, String[] arg3)
ערך בוליאני סופי	equals(Object arg0)
FragmentActivity סופי	getActivity()
boolean	getAllowEnterTransitionOverlap()
boolean	getAllowReturnTransitionOverlap()
חבילה סופית	getArguments()
FragmentManager	getChildFragmentManager()
הקשר	getContext()
ViewModelProvider.Factory	getDefaultViewModelProviderFactory()
אובייקט	getEnterTransition()
אובייקט	getExitTransition()
FragmentManager	getFragmentManager()
אובייקט סופי	getHost()
INT	getId()
LayoutInflater	getLayoutInflater(Bundle arg0)
סופית LayoutInflater	getLayoutInflater()
מחזור חיים	getLifecycle()
LoaderManager	getLoaderManager()
מקטע סופי	getParentFragment()
FragmentManager	getParentFragmentManager()
אובייקט	getReenterTransition()
משאבים סופיים	getResources()
ערך בוליאני סופי	getRetainInstance()
אובייקט	getReturnTransition()
סופי savedStateRegistry	getSavedStateRegistry()
אובייקט	getSharedElementEnterTransition()
אובייקט	getSharedElementReturnTransition()
מחרוזת סופית	getString(int arg0, Object... arg1)
מחרוזת סופית	getString(int arg0)
מחרוזת סופית	getTag()
מקטע סופי	getTargetFragment()
INT	getTargetRequestCode()
סיום CcharSequence	getText(int arg0)
boolean	getUserVisibleHint()
מעבר למצב תצוגה	getView()
LifecycleOwner	getViewLifecycleOwner()
LiveData<LifecycleOwner>	getViewLifecycleOwnerLiveData()
ViewModelStore	getViewModelStore()
ערך בוליאני סופי	hasOptionsMenu()
INT	hashCode()
מקטע סטטי	instantiate(Context arg0, String arg1)
מקטע סטטי	instantiate(Context arg0, String arg1, Bundle arg2)
ערך בוליאני סופי	isAdded()
ערך בוליאני סופי	isDetached()
ערך בוליאני סופי	isHidden()
ערך בוליאני סופי	isInLayout()
ערך בוליאני סופי	isMenuVisible()
ערך בוליאני סופי	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)
Animation	onCreateAnimation(int arg0, boolean arg1, int arg2)
אנימטורים	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(Activity arg0, AttributeSet arg1, Bundle arg2)
void	onInflate(Context arg0, AttributeSet arg1, Bundle arg2)
void	onLowMemory()
void	onMultiWindowModeChanged(boolean arg0)
boolean	onOptionsItemSelected(menuItem arg0)
void	onOptionsMenuClosed(תפריט arg0)
void	onPause()
void	onPictureInPictureModeChanged(boolean arg0)
void	onPrepareOptionsMenu(תפריט arg0)
void	onPrimaryNavigationFragmentChanged(boolean arg0)
void	onRequestPermissionsResult(int arg0, String[] arg1, int[] arg2)
void	onResume()
void	onSaveInstanceState(Bundle arg0)
void	onStart()
void	onStop()
void	onViewCreated(View arg0, Bundle arg1)
void	onViewStateRestored(Bundle arg0)
void	postponeEnterTransition()
תוקף סופי	postponeEnterTransition(long arg0, TimeUnit arg1)
סופי <I, O> ActivityResultsLauncher<I>	registerForActivityResult(ActivityActivityContract<I, O> arg0, ActivityResultCallback<O> arg1)
סופי <I, O> ActivityResultsLauncher<I>	registerForActivityResult(ActivityActivityContract<I, O> arg0, ActivityResultRegistry arg1, ActivityResultCallback<O> arg2)
void	registerForContextMenu(הצגת arg0)
תוקף סופי	requestPermissions(String[] arg0, int arg1)
FragmentActivity סופי	requireActivity()
חבילה סופית	requireArguments()
הקשר סופי	requireContext()
FragmentManager	requireFragmentManager()
אובייקט סופי	requireHost()
מקטע סופי	requireParentFragment()
תצוגה סופית	requireView()
void	setAllowEnterTransitionOverlap(boolean arg0)
void	setAllowReturnTransitionOverlap(boolean arg0)
void	setArguments(Bundle arg0)
void	setEnterSharedElementCallback(SharedElementCallback arg0)
void	setEnterTransition(Object arg0)
void	setExitSharedElementCallback(SharedElementCallback arg0)
void	setExitTransition(אובייקט arg0)
void	setHasOptionsMenu(boolean arg0)
void	setInitialSavedState(Fragment.SavedState arg0)
void	setMenuVisibility(boolean arg0)
void	setReenterTransition(Object arg0)
void	setRetainInstance(boolean arg0)
void	setReturnTransition(Object 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.ComponentCallbacks

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

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

מופשט וריק

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

מהממשק android.arch.lifecycle.LifecycleOwner

מחזור חיים מופשט

getLifecycle()

מהממשק android.arch.lifecycle.ViewModelStoreOwner

מופשט ViewModelStore

getViewModelStore()

מהממשק android.arch.lifecycle.HasDefaultViewModelProviderFactory

מופשט ViewModelProvider.Manufacturer

getDefaultViewModelProviderFactory()

מהממשק androidx.savedstate.SavedStateRegistryOwner

מופשט SaveStateRegistry

getSavedStateRegistry()

מהממשק androidx.activity.result.ActivityResultCaller

מופשט <I, O> ActivityResultsLauncher<I>	registerForActivityResult(ActivityActivityContract<I, O> arg0, ActivityResultCallback<O> arg1)
מופשט <I, O> ActivityResultsLauncher<I>	registerForActivityResult(ActivityActivityContract<I, O> arg0, ActivityResultRegistry arg1, ActivityResultCallback<O> arg2)

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

Public SupportMapFragment ()

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

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

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

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

הערה:

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

פרמטרים

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

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

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

פרמטרים

אפשרויות

Public סטטי SupportMapFragment 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