MapFragment | Android Developers

Quicknav Quicknav
Links

- Google Play Developer Console
- Android Developers Blog
- About Android

Android Sites

- Android.com
- Android Developers
- Android Open Source Project

Language
close

- - Get Started
  - Style
  - Patterns
  - Building Blocks
  - Downloads
  - Videos
- - Training
  - API Guides
  - Reference
  - Tools
    - Get the SDK
  - Google Services
- - Google Play
  - Publishing
  - Promoting
  - App Quality
  - Spotlight
  - Open Distribution

## Results

Loading...
Summary: Inherited Constants | Ctors | Methods | Inherited Methods | [Expand All]
public class

# MapFragment

extends Fragment

java.lang.Object
↳ | android.app.Fragment
| ↳ | com.google.android.gms.maps.MapFragment

## Class Overview

A Map component in an app. This fragment is the simplest way to place a map in an application. It's a wrapper around a view of a map to automatically handle the necessary life cycle needs. Being a fragment, this component can be added to an activity's layout file simply with the XML below.

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

A `GoogleMap` can only be acquired using `getMap()` when the underlying maps system is loaded and the underlying view in the fragment exists. This class automatically initializes the maps system and the view; however you cannot be guaranteed when it will be ready because this depends on the availability of the Google Play services APK. If a `GoogleMap` is not available, `getMap()` will return `null`.

A view can be removed when the MapFragment's `onDestroyView()` method is called and the `useViewLifecycleInFragment(boolean)` option is set. When this happens the MapFragment is no longer valid until the view is recreated again later when MapFragment's `onCreateView(LayoutInflater, ViewGroup, Bundle)` method is called.

Any objects obtained from the `GoogleMap` is associated with the view. It's important to not hold on to objects (e.g. `Marker`) beyond the view's life. Otherwise it will cause a memory leak as the view cannot be released.

Use this class only if you are targeting API 12 and above. Otherwise, use SupportMapFragment.

### Developer Guide

For more information, read the Google Maps Android API v2 developer guide.

## Summary

[Expand] Inherited Constants
From interface 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 |

Public Constructors
| MapFragment() Creates a map fragment.

Public Methods
final GoogleMap | getMap() Gets the underlying GoogleMap that is tied to the view wrapped by this fragment.
static MapFragment | newInstance() Creates a map fragment, using default options.
static MapFragment | newInstance(GoogleMapOptions options) Creates a map fragment with the given options.
void | onAttach(Activity activity)
void | onCreate(Bundle savedInstanceState)
View | onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
void | onDestroy()
void | onDestroyView()
void | onInflate(Activity activity, AttributeSet attrs, Bundle savedInstanceState) Parse attributes during inflation from a view hierarchy into the arguments we handle.
void | onLowMemory()
void | onPause()
void | onResume()
void | onSaveInstanceState(Bundle outState)
void | setArguments(Bundle args)

[Expand] Inherited Methods
From class android.app.Fragment
void | dump(String arg0, FileDescriptor arg1, PrintWriter arg2, String[] arg3)
final boolean | equals(Object arg0)
final Activity | getActivity()
final Bundle | getArguments()
final FragmentManager | getFragmentManager()
final int | getId()
LoaderManager | getLoaderManager()
final Resources | getResources()
final boolean | getRetainInstance()
final String | getString(int arg0)
final String | getString(int arg0, Object... arg1)
final String | getTag()
final Fragment | getTargetFragment()
final int | getTargetRequestCode()
final CharSequence | getText(int arg0)
boolean | getUserVisibleHint()
View | getView()
final int | hashCode()
static Fragment | instantiate(Context arg0, String arg1)
static Fragment | instantiate(Context arg0, String arg1, Bundle arg2)
final boolean | isAdded()
final boolean | isDetached()
final boolean | isHidden()
final boolean | isInLayout()
final boolean | isRemoving()
final boolean | isResumed()
final boolean | isVisible()
void | onActivityCreated(Bundle arg0)
void | onActivityResult(int arg0, int arg1, Intent arg2)
void | onAttach(Activity arg0)
void | onConfigurationChanged(Configuration arg0)
boolean | onContextItemSelected(MenuItem arg0)
void | onCreate(Bundle arg0)
Animator | onCreateAnimator(int arg0, boolean arg1, int arg2)
void | onCreateContextMenu(ContextMenu arg0, View arg1, ContextMenu.ContextMenuInfo arg2)
void | onCreateOptionsMenu(Menu arg0, MenuInflater arg1)
View | onCreateView(LayoutInflater arg0, ViewGroup arg1, Bundle arg2)
void | onDestroy()
void | onDestroyOptionsMenu()
void | onDestroyView()
void | onDetach()
void | onHiddenChanged(boolean arg0)
void | onInflate(AttributeSet arg0, Bundle arg1)
void | onInflate(Activity arg0, AttributeSet arg1, Bundle arg2)
void | onLowMemory()
boolean | onOptionsItemSelected(MenuItem arg0)
void | onOptionsMenuClosed(Menu arg0)
void | onPause()
void | onPrepareOptionsMenu(Menu arg0)
void | onResume()
void | onSaveInstanceState(Bundle arg0)
void | onStart()
void | onStop()
void | onTrimMemory(int arg0)
void | onViewCreated(View arg0, Bundle arg1)
void | registerForContextMenu(View arg0)
void | setArguments(Bundle arg0)
void | setHasOptionsMenu(boolean arg0)
void | setInitialSavedState(Fragment.SavedState arg0)
void | setMenuVisibility(boolean arg0)
void | setRetainInstance(boolean arg0)
void | setTargetFragment(Fragment arg0, int arg1)
void | setUserVisibleHint(boolean 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)
String | toString()
void | unregisterForContextMenu(View arg0)
From class java.lang.Object
Object | clone()
boolean | equals(Object arg0)
void | finalize()
final Class<?> | getClass()
int | hashCode()
final void | notify()
final void | notifyAll()
String | toString()
final void | wait()
final void | wait(long arg0, int arg1)
final void | wait(long arg0)
From interface android.content.ComponentCallbacks
abstract void | onConfigurationChanged(Configuration arg0)
abstract void | onLowMemory()
From interface android.content.ComponentCallbacks2
abstract void | onTrimMemory(int arg0)
From interface android.view.View.OnCreateContextMenuListener
abstract void | onCreateContextMenu(ContextMenu arg0, View arg1, ContextMenu.ContextMenuInfo arg2)

## Public Constructors

#### public MapFragment ()

Creates a map fragment. This constructor is public only for use by an inflater. Use `newInstance()` to create a MapFragment programmatically.

## Public Methods

#### public final GoogleMap getMap ()

Gets the underlying GoogleMap that is tied to the view wrapped by this fragment.

##### Returns

- the GoogleMap. Null if the view of the fragment is not yet ready. This can happen if the fragment lifecyle have not gone through `onCreateView(LayoutInflater, ViewGroup, Bundle)` yet. This can also happen if Google Play services is not available. If Google Play services becomes available afterwards and the fragment have gone through `onCreateView(LayoutInflater, ViewGroup, Bundle)`, calling this method again will initialize and return the GoogleMap.

#### public static MapFragment newInstance ()

Creates a map fragment, using default options.

#### public static MapFragment newInstance (GoogleMapOptions options)

Creates a map fragment with the given options.

#### public void onAttach (Activity activity)

#### public void onCreate (Bundle savedInstanceState)

#### public View onCreateView (LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)

#### public void onDestroy ()

#### public void onDestroyView ()

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

Parse attributes during inflation from a view hierarchy into the arguments we handle.

#### public void onLowMemory ()

#### public void onPause ()

#### public void onResume ()

#### public void onSaveInstanceState (Bundle outState)

#### public void setArguments (Bundle args)