Quicknav Quicknav
Links

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

Android Sites

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

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: Ctors | Methods | Inherited Methods | [Expand All]
public class

# SupportMapFragment

extends Fragment

java.lang.Object
↳ | android.support.v4.app.Fragment
| ↳ | com.google.android.gms.maps.SupportMapFragment

## 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.SupportMapFragment"
        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 SupportMapFragment's `onDestroyView()` method is called and the `useViewLifecycleInFragment(boolean)` option is set. When this happens the SupportMapFragment is no longer valid until the view is recreated again later when SupportMapFragment'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.

To use this class, you must include the Android support library in your build path.

### Developer Guide

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

## Summary

Public Constructors
| SupportMapFragment() Creates a map fragment.

Public Methods
final GoogleMap | getMap() Gets the underlying GoogleMap that is tied to the view wrapped by this fragment.
static SupportMapFragment | newInstance() Creates a map fragment, using default options.
static SupportMapFragment | newInstance(GoogleMapOptions options) Creates a map fragment with the given options.
void | onActivityCreated(Bundle savedInstanceState)
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.support.v4.app.Fragment

void | dump(String arg0, FileDescriptor arg1, PrintWriter arg2, String[] arg3)
final boolean | equals(Object arg0)
final FragmentActivity | getActivity()
final Bundle | getArguments()
final FragmentManager | getChildFragmentManager()
final FragmentManager | getFragmentManager()
final int | getId()
LayoutInflater | getLayoutInflater(Bundle arg0)
LoaderManager | getLoaderManager()
final Fragment | getParentFragment()
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 boolean | hasOptionsMenu()
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 | isMenuVisible()
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)
Animation | onCreateAnimation(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(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 | onViewCreated(View arg0, Bundle arg1)
void | onViewStateRestored(Bundle arg0)
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 | startActivityForResult(Intent arg0, int arg1)
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.view.View.OnCreateContextMenuListener

## Public Constructors

#### public SupportMapFragment ()

Creates a map fragment. This constructor is public only for use by an inflater. Use `newInstance()` to create a SupportMapFragment 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 SupportMapFragment newInstance ()

Creates a map fragment, using default options.

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

Creates a map fragment with the given options.

#### public void onActivityCreated (Bundle savedInstanceState)

#### 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)