SupportMapFragment

公共类 SupportMapFragment扩展 Fragment

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

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

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

GoogleMap 获取的任何对象都与该视图相关联。请务必不要保留超出视图生命周期的对象(例如 Marker)。否则,由于无法释放视图,这会导致内存泄漏。

如需使用此类,您必须在构建路径中包含 Android 支持库。

开发者指南

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

公共构造函数摘要

SupportMapFragment()
创建地图 fragment。

公共方法摘要

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

继承的方法摘要

公共构造函数

public SupportMapFragment ()

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

公共方法

public void getMapAsync OnMapReadyCallback 回调)

设置将在 GoogleMap 实例做好使用准备时触发的回调对象。

请注意:

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

参数
callback 在地图做好使用准备时触发的回调对象。

public static SupportMapFragment newInstance GoogleMapOptions 选项)

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

参数
选项

public static SupportMapFragment newInstance ()

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

public void onActivityCreated (Bundle savedInstanceState)

参数
savedInstanceState

public void onAttach (Activity activity)

参数
活动

public void onConfigurationChanged (配置配置)

参数
config

public void onCreate (Bundle savedInstanceState)

参数
savedInstanceState

public 视图 onCreateView (LayoutInflater 膨胀器, ViewGroup 容器, Bundle savedInstanceState)

参数
膨胀器
容器
savedInstanceState

public void onDestroy ()

public void onDestroyView ()

public final void onEnterAmbient (BundleAmbientDetails)

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

参数
ambientDetails

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