GoogleMapOptions

public final 类 GoogleMapOptions扩展对象
实现 Parcelable

定义 GoogleMap 的配置 GoogleMapOptions。以编程方式(而不是通过 XML)向应用添加地图时,可以使用这些选项。如果您使用的是 MapFragment,则可以使用静态出厂方法 newInstance(GoogleMapOptions) 传入这些选项。如果您使用的是 MapView,则可以使用构造函数 MapView(Context, GoogleMapOptions) 传入这些选项。

如果您使用 XML 添加地图,则可以使用自定义 XML 标记来应用这些选项。

继承的常量摘要

公共构造函数摘要

GoogleMapOptions()
用于创建一个新的 GoogleMapOptions 对象。

公共方法摘要

GoogleMapOptions
ambientEnabled(已启用布尔值)
指定是否应启用氛围模式样式。
GoogleMapOptions
camera(CameraPosition 相机)
指定地图的初始镜头位置。
GoogleMapOptions
compassEnabled(已启用布尔值)
指定是否应启用罗盘。
static GoogleMapOptions
createFromAttributes(Context context, AttributeSet 属性)
AttributeSet 创建 GoogleMapsOptions。
布尔值
CameraPosition
布尔值
LatLngBounds
布尔值
布尔值
整型
浮点数
浮点数
布尔值
布尔值
布尔值
布尔值
布尔值
布尔值
布尔值
布尔值
GoogleMapOptions
latLngBoundsForCameraTarget(LatLngBounds llbounds)
指定 LatLngBounds 以限制镜头目标,以便在用户滚动和平移地图时,镜头目标不会移出这些边界。
GoogleMapOptions
liteMode(已启用布尔值)
指定是否应以精简模式创建地图。
GoogleMapOptions
mapId(String mapId)
指定地图的 ID。
GoogleMapOptions
mapToolbarEnabled(已启用布尔值)
指定是否应启用 mapToolbar。
GoogleMapOptions
mapType(int mapType)
指定对初始地图类型的更改。
GoogleMapOptions
maxZoomPreference(float maxZoomPreference)
指定相机缩放的首选上限。
GoogleMapOptions
minZoomPreference(float minZoomPreference)
指定相机缩放的首选下限。
GoogleMapOptions
rotateGesturesEnabled(已启用布尔值)
指定是否应启用旋转手势。
GoogleMapOptions
scrollGesturesEnabled(已启用布尔值)
指定是否应启用滚动手势。
GoogleMapOptions
scrollGesturesEnabledDuringRotateOrZoom(已启用布尔值)
指定旋转和缩放手势期间是否应启用滚动手势。
GoogleMapOptions
setInstrumentClusterMap(布尔值 isInstrumentCluster)
GoogleMapOptions
tiltGesturesEnabled(已启用布尔值)
指定是否应启用倾斜手势。
字符串
GoogleMapOptions
useViewLifecycleInFragment(布尔值 useViewLifecycleInFragment)
使用 MapFragment 时,此标记用于指定是否应将地图的生命周期与 Fragment 的视图或 Fragment 本身相关联。
GoogleMapOptions
zOrderOnTop(布尔值 zOrderOnTop)
控制地图视图的表面是否位于其窗口的顶部。
GoogleMapOptions
zoomControlsEnabled(已启用布尔值)
指定是否应启用缩放控件。
GoogleMapOptions
zoomGesturesEnabled(已启用布尔值)
指定是否应启用缩放手势。

继承的方法摘要

公共构造函数

public GoogleMapOptions ()

用于创建一个新的 GoogleMapOptions 对象。

公共方法

public GoogleMapOptions ambientEnabled (boolean enabled)

指定是否应启用氛围模式样式。默认值为 false。 启用后,当 Ambiactive 设备进入氛围模式时,系统可显示氛围样式的地图。

参数
已启用

public GoogleMapOptions camera (CameraPosition 镜头)

指定地图的初始镜头位置。

参数
camera

public GoogleMapOptions compassEnabled (boolean enabled)

指定是否应启用罗盘。如需了解详情,请参阅 setCompassEnabled(boolean)。默认值为 true

参数
已启用

public static GoogleMapOptions createFromAttributes (Context context, AttributeSet attrs)

AttributeSet 创建 GoogleMapsOptions。

参数
context
attrs

public Boolean getAmbientEnabled ()

返回
  • AmbientEnabled 选项,如果未指定,则为 null。

public CameraPosition getCamera ()

返回
  • 相机选项,如果未指定,则为 null。

public Boolean getCompassEnabled ()

返回
  • compassEnabled 选项,如果未指定,则返回 null。

public LatLngBounds getLatLngBoundsForCameraTarget ()

返回
  • 用于约束镜头目标的 LatLngBounds;如果未指定,则为 null。

public Boolean getLiteMode ()

返回
  • liteMode 选项;如果未指定,则为 null。

public Boolean getMapToolbarEnabled ()

返回
  • mapToolbarEnabled 选项,如果未指定,则返回 null。

public int getMapType ()

返回
  • mapType 选项,如果未指定,则为 -1。

public Float getMaxZoomPreference ()

返回
  • 最大缩放级别偏好设置,如果未指定,则为 null 。

public Float getMinZoomPreference ()

返回
  • 最小缩放级别偏好设置,如果未指定,则为 null 。

public Boolean getRotateGesturesEnabled ()

返回
  • rotateGesturesEnabled 选项,如果未指定,则返回 null。

public Boolean getScrollGesturesEnabled ()

返回
  • scrollGesturesEnabled 选项;如果未指定,则返回 null。

public Boolean getScrollGesturesEnabledDuringRotateOrZoom ()

返回
  • scrollGesturesEnabledDuringRotateOrZoom 选项;如果未指定,则返回 null。

public Boolean getTiltGesturesEnabled ()

返回
  • tiltGesturesEnabled 选项,或者如果未指定,则为 null。

public Boolean getUseViewLifecycleInFragment ()

返回
  • useViewLifecycleInFragment 选项,或 null(如果未指定)。

public Boolean getZOrderOnTop ()

返回
  • zOrderOnTop 选项,如果未指定,则为 null 。

public Boolean getZoomControlsEnabled ()

返回
  • scaleControlsEnabled 选项,如果未指定,则为 null 。

public Boolean getZoomGesturesEnabled ()

返回
  • zoomGesturesEnabled 选项,如果未指定,则为 null。

public GoogleMapOptions latLngBoundsForCameraTarget (LatLngBounds llbounds)

指定 LatLngBounds 以限制镜头目标,以便在用户滚动和平移地图时,镜头目标不会移出这些边界。

如需了解详情,请参阅 setLatLngBoundsForCameraTarget(LatLngBounds)

参数
LLbounds

public GoogleMapOptions liteMode (boolean enabled)

指定是否应以精简模式创建地图。默认值为 false。 如果启用精简模式,地图将作为静态图像加载。在需要同时显示大量地图的情况下(例如在滚动列表中),这可以提高性能,但用户无法平移或缩放精简模式地图,也无法倾斜或旋转地图。

参数
已启用

public GoogleMapOptions mapId (String mapId)

指定地图的 ID。

参数
mapId

public GoogleMapOptions mapToolbarEnabled (boolean enabled)

指定是否应启用 mapToolbar。如需了解详情,请参阅 setMapToolbarEnabled(boolean)。默认值为 true

参数
已启用

public GoogleMapOptions mapType (int mapType)

指定对初始地图类型的更改。

参数
mapType

public GoogleMapOptions maxZoomPreference (float maxZoomPreference)

指定相机缩放的首选上限。

如需了解详情,请参阅 setMaxZoomPreference(float)

参数
maxZoomPreference

public GoogleMapOptions minZoomPreference (float minZoomPreference)

指定相机缩放的首选下限。

如需了解详情,请参阅 setMinZoomPreference(float)

参数
minZoomPreference

public GoogleMapOptions rotateGesturesEnabled (boolean enabled)

指定是否应启用旋转手势。如需了解详情,请参阅 setRotateGesturesEnabled(boolean)。默认值为 true

参数
已启用

public GoogleMapOptions scrollGesturesEnabled (boolean enabled)

指定是否应启用滚动手势。如需了解详情,请参阅 setScrollGesturesEnabled(boolean)。默认值为 true

参数
已启用

public GoogleMapOptions scrollGesturesEnabledDuringRotateOrZoom (boolean enabled)

指定旋转和缩放手势期间是否应启用滚动手势。如需了解详情,请参阅 setScrollGesturesEnabledDuringRotateOrZoom(boolean)。默认值为 true

参数
已启用

public GoogleMapOptions setInstrumentClusterMap (boolean isInstrumentCluster)

参数
isInstrumentCluster

public GoogleMapOptions tiltGesturesEnabled (boolean enabled)

指定是否应启用倾斜手势。如需了解详情,请参阅 setTiltGesturesEnabled(boolean)。默认值为 true

参数
已启用

public String toString ()

public GoogleMapOptions useViewLifecycleInFragment (boolean useViewLifecycleInFragment)

使用 MapFragment 时,此标记用于指定是否应将地图的生命周期与 Fragment 的视图或 Fragment 本身相关联。默认值为 false,可将地图的生命周期与 Fragment 绑定。

利用 Fragment 的生命周期,可以在分离并重新附加 Fragment 时更快地渲染地图,因为底层 GL 上下文会保留下来。这样做的代价是,分离 fragment 但不销毁它不会释放地图使用的内存。

使用 Fragment 视图的生命周期意味着,在分离并重新附加 Fragment 时,不会重复使用地图。这会导致地图从头开始重新渲染,这可能需要几秒钟的时间。这也意味着,当 Fragment 已分离并因此没有视图时,所有 GoogleMap 方法都将抛出 NullPointerException

参数
useViewLifecycleInFragment

public GoogleMapOptions zOrderOnTop (boolean zOrderOnTop)

该属性可控制地图视图的表面是否位于其窗口的顶部。如需了解详情,请参阅 setZOrderOnTop(boolean)。请注意,这会覆盖地图上可能显示的所有其他视图(例如缩放控件、“我的位置”按钮)。

参数
zOrderOnTop

public GoogleMapOptions zoomControlsEnabled (boolean enabled)

指定是否应启用缩放控件。如需了解详情,请参阅 setZoomControlsEnabled(boolean)。默认值为 true

参数
已启用

public GoogleMapOptions zoomGesturesEnabled (boolean enabled)

指定是否应启用缩放手势。如需了解详情,请参阅 setZoomGesturesEnabled(boolean)。默认值为 true

参数
已启用