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
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 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.app.Fragment
From class java.lang.Object
From interface android.content.ComponentCallbacks
From interface android.content.ComponentCallbacks2
From interface android.view.View.OnCreateContextMenuListener

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

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