MapView

  • MapView is an Android View that displays a Google Map and handles user interactions.

  • You must forward lifecycle methods from the hosting Activity or Fragment to the MapView.

  • Use getMapAsync(OnMapReadyCallback) to get a GoogleMap instance to work with.

  • For a simpler map display, consider using MapFragment or SupportMapFragment.

  • Avoid adding child views directly to a MapView.
public class MapView extends FrameLayout

A View which displays a map (with data obtained from the Google Maps service). When focused, it will capture keypresses and touch gestures to move the map.

Users of this class must forward all the life cycle methods from the Activity or Fragment containing this view to the corresponding ones in this class. In particular, you must forward on the following methods:

A GoogleMap must be acquired using getMapAsync(OnMapReadyCallback). The MapView automatically initializes the maps system and the view.

For a simpler method of displaying a Map use MapFragment (or SupportMapFragment) if you are looking to target earlier platforms.

Note: You are advised not to add children to this view.

Developer Guide

For more information, read the Google Maps SDK for Android developer guide.

Inherited Constant Summary

Inherited Field Summary

Public Constructor Summary

MapView(Context context)
MapView(Context context, AttributeSet attrs)
MapView(Context context, AttributeSet attrs, int defStyle)
MapView(Context context, GoogleMapOptions options)
Constructs MapView with GoogleMapOptions.

Public Method Summary

void
getMapAsync(OnMapReadyCallback callback)
Returns a instance of the GoogleMap through the callback, ready to be used.
void
onCreate(Bundle savedInstanceState)
You must call this method from the parent Activity/Fragment's corresponding method.
void
onDestroy()
You must call this method from the parent Activity/Fragment's corresponding method.
void
onEnterAmbient(Bundle ambientDetails)
You must call this method from the parent WearableActivity's corresponding method.
void
onExitAmbient()
You must call this method from the parent WearableActivity's corresponding method.
void
onLowMemory()
You must call this method from the parent Activity/Fragment's corresponding method.
void
onPause()
You must call this method from the parent Activity/Fragment's corresponding method.
void
onResume()
You must call this method from the parent Activity/Fragment's corresponding method.
void
onSaveInstanceState(Bundle outState)
You must call this method from the parent Activity/Fragment's corresponding method.
void
onStart()
You must call this method from the parent Activity/Fragment's corresponding method.
void
onStop()
You must call this method from the parent Activity/Fragment's corresponding method.

Inherited Method Summary

Public Constructors

public MapView (Context context)

public MapView (Context context, AttributeSet attrs)

public MapView (Context context, AttributeSet attrs, int defStyle)

public MapView (Context context, GoogleMapOptions options)

Constructs MapView with GoogleMapOptions.

Parameters
context
options configuration GoogleMapOptions for a GoogleMap, or null to use the default options.

Public Methods

public void getMapAsync (OnMapReadyCallback callback)

Returns a instance of the GoogleMap through the callback, ready to be used.

Note that:

  • This method must be called from the main thread.
  • The callback will be executed in the main thread.
  • In the case where Google Play services is not installed on the user's device, the callback will not be triggered until the user installs it.
  • The GoogleMap object provided by the callback is never null.
Parameters
callback The callback object that will be triggered when the map is ready to be used.

public void onCreate (Bundle savedInstanceState)

You must call this method from the parent Activity/Fragment's corresponding method.

public void onDestroy ()

You must call this method from the parent Activity/Fragment's corresponding method.

public void onEnterAmbient (Bundle ambientDetails)

You must call this method from the parent WearableActivity's corresponding method.

public void onExitAmbient ()

You must call this method from the parent WearableActivity's corresponding method.

public void onLowMemory ()

You must call this method from the parent Activity/Fragment's corresponding method.

public void onPause ()

You must call this method from the parent Activity/Fragment's corresponding method.

public void onResume ()

You must call this method from the parent Activity/Fragment's corresponding method.

public void onSaveInstanceState (Bundle outState)

You must call this method from the parent Activity/Fragment's corresponding method.

Provides a Bundle to store the state of the View before it gets destroyed. It can later be retrieved when onCreate(Bundle) is called again.

public void onStart ()

You must call this method from the parent Activity/Fragment's corresponding method.

public void onStop ()

You must call this method from the parent Activity/Fragment's corresponding method.