MapFragment

公共类 MapFragment 扩展了 Fragment

应用中的地图组件。此 fragment 是在应用中放置地图的最简单方法。它是地图视图的封装容器,可自动处理必要的生命周期需求。作为 Fragment,只需使用下面的 XML 即可将其添加到 Activity 的布局文件中。

 <fragment
    class="com.google.android.libraries.maps.MapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>
必须使用 getMapAsync(OnMapReadyCallback) 获取 GoogleMap。此类会自动初始化地图系统和视图。

调用 MapFragment 的 onDestroyView() 方法并设置 useViewLifecycleInFragment(boolean) 选项后,便可移除视图。发生这种情况时,MapFragment 将不再有效,直到之后在调用 MapFragment 的 onCreateView(LayoutInflater, ViewGroup, Bundle) 方法时再次重新创建视图。

GoogleMap 获取的所有对象都与该视图相关联。请勿在视图的生命周期内保留其他对象(例如 Marker)。否则,由于视图无法释放,这会导致内存泄漏。

仅在以 API 12 及更高版本为目标平台时使用此类。否则,通过将 Android 支持库添加到您的构建路径来使用 SupportMapFragment。

开发者指南

如需了解详情,请参阅 Google Maps SDK for Android 开发者指南。

继承的常量摘要

公共构造函数摘要

MapFragment()
创建地图 fragment。

公共方法摘要

无效
getMapAsyncOnMapReadyCallback 回调)
设置会在 GoogleMap 实例可供使用时触发的回调对象。
static MapFragment
newInstanceGoogleMapOptions 选项)
使用指定选项创建地图 fragment。
static MapFragment
newInstance()
使用默认选项创建地图 fragment。
无效
onActivityCreated(软件包 savedInstanceState)
无效
onAttach(activity 活动)
无效
onConfigurationChanged(配置配置)
无效
onCreate(软件包 savedInstanceState)
查看
onCreateView(LayoutInflater 膨胀器、ViewGroup 容器、Bundle savedInstanceState)
无效
无效
final void
onEnterAmbient(软件包 AmbientDetails)
您必须从父级 WearableActivity 的相应方法调用此方法。
final void
onExitAmbient()
您必须从父级 WearableActivity 的相应方法调用此方法。
无效
onInflate(Activity 活动、AttributeSet 属性、Bundle savedInstanceState)
在膨胀过程中从视图层次结构解析属性到我们处理的参数中。
无效
无效
无效
无效
onSaveInstanceState(软件包 outState)
提供 Bundle,用于在 Fragment 销毁之前存储其状态。
无效
无效
无效
setArguments(软件包参数)

继承的方法摘要

公共构造函数

public MapFragment ()

创建地图 fragment。此构造函数是公开的,仅供膨胀器使用。使用 newInstance() 以编程方式创建 MapFragment。

公共方法

public void getMapAsync (OnMapReadyCallback callback)

设置会在 GoogleMap 实例可供使用时触发的回调对象。

请注意:

  • 必须从主线程调用此方法。
  • 回调将在主线程中执行。
  • 如果用户设备上未安装 Google Play 服务,则用户安装该回调后才会触发回调。
  • 在极少数情况下,GoogleMap 会在创建后立即销毁,因此不会触发回调。
  • 回调提供的 GoogleMap 对象为非 null。

参数
callback 在地图可供使用时触发的回调对象。

public static MapFragment newInstance (GoogleMapOptions options)

使用指定选项创建地图 fragment。

参数
选项

public static MapFragment newInstance ()

使用默认选项创建地图 fragment。

public void onActivityCreated (Bundle savedInstanceState)

参数
savedInstanceState

public void onAttach (Activity activity)

参数
活动记录

public void onConfigurationChanged (Configuration config)

参数
config

public void onCreate (Bundle savedInstanceState)

参数
savedInstanceState

public View onCreateView (LayoutInflater 膨胀器、ViewGroup 容器、Bundle savedInstanceState)

参数
膨胀器
容器
savedInstanceState

public void onDestroy ()

public void onDestroyView ()

public final void onEnterAmbient (BundleAmbientDetails)

您必须从父级 WearableActivity 的相应方法调用此方法。

参数
微光详情

public final void 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,用于在 Fragment 销毁之前存储其状态。稍后在再次调用 onCreate(Bundle) 时可以检索到它。

参数
outState

public void onStart ()

public void onStop ()

public void setArguments (Bundle args)

参数
args