GoogleMap

带有主要街道透明图层的卫星地图。

无基本地图图块。

基本地图。

不带标签的卫星地图。

地形地图。

向此地图添加一个圆形。

用于向此地图添加图像。

向此地图添加标记。

标记的图标会渲染在地图上的 Marker.position 位置。点击该标记可使镜头居中。如果定义了 Marker.title，地图将显示一个信息框，其中包含标记的标题和信息摘要。如果标记可以拖动、长按标记，然后拖动该标记，则可以移动该标记。

用于向此地图添加多边形。

向此地图添加多段线。

用于向此地图添加图块叠加层。如需了解详情，请参阅 TileOverlay。

请注意，与其他叠加层不同，地图重新创建后，图块叠加层不会自动恢复，您必须手动重新添加。

为相机从当前位置移动到更新中定义的位置添加动画效果。在动画播放期间，调用 getCameraPosition() 会返回相机的中间位置。

如需了解一系列更新，请参阅 CameraUpdateFactory。

为相机从当前位置移到更新中定义的位置添加动画效果，并在完成时调用可选回调。如需了解一系列更新，请参阅 CameraUpdateFactory。

在动画播放期间，调用 getCameraPosition() 会返回相机的中间位置。

根据指定时长内的动画更新移动地图，并在完成时调用可选的回调。如需了解一组更新，请参阅 CameraUpdateFactory。

如果在动画期间调用 getCameraPosition()，它将返回飞行中相机的当前位置。

从地图上移除所有标记、多段线、多边形、叠加层等。

获取镜头的当前位置。

返回的 CameraPosition 是当前位置的快照，不会在相机移动时自动更新。

如需详细了解如何更改镜头位置，请参阅镜头和视图。

获取当前聚焦的建筑物。

用于获取当前显示的地图类型。如需了解可能的值，请参阅 MAP_TYPE_NORMAL、MAP_TYPE_SATELLITE 和 MAP_TYPE_TERRAIN。

返回当前镜头位置的最大缩放级别。这会考虑当前正在使用的地图类型，例如，卫星地图或地形地图图块的最大缩放级别可能低于基本地图图块。

如需详细了解如何更改镜头的缩放级别，请参阅镜头和视图。

返回最小缩放级别。每个地点的缩放级别都相同（不同于最大缩放级别），但不同设备和地图尺寸之间可能有所差异。

如需详细了解如何更改镜头的缩放级别，请参阅镜头和视图。

返回当前显示的用户位置，如果没有可用的位置数据，则返回 null。

返回一个 Projection 对象，您可以使用该对象在屏幕坐标与纬度/经度坐标之间进行转换。

返回的 Projection 是当前投影的快照，不会在相机移动时自动更新。由于此操作成本高昂，因此您应该在每个屏幕仅获取一次投影。Google 地图使用墨卡托投影法来根据地理数据创建地图，并将地图上的点转换为地理坐标。

获取地图的用户界面设置。

返回是否启用 3D 建筑图层。

获取当前是否启用了室内地图的信息。

获取“我的位置”图层的状态。

检查地图是否绘制了路况数据。这取决于流量数据的可用性。

根据更新中定义的说明调整相机位置。移动是即时的，后续的 getCameraPosition() 将反映新位置。如需了解一组更新，请参阅 CameraUpdateFactory。

删除之前指定的所有缩放上限和下限。

打开或关闭 3D 建筑图层。

为地图设置 contentDescription。

此属性用于在无障碍模式下提供地图的语音说明。默认值为“Google 地图”

设置是否应启用室内地图。目前，室内地图一次只能在一个地图上显示，默认情况下，这是添加到应用的第一个地图。如需在其他地图上启用室内地图，您必须先在原始地图上停用室内地图。如果您在另一个地图上启用室内地图后尝试将其启用，则不会有任何反应，并且会返回 false。如果地图未启用“室内”，与室内相关的所有方法都将返回 null 或 false。

用于为信息窗口的内容设置自定义渲染程序。

与地图的事件监听器一样，此状态不会随地图一起序列化。如果地图重新创建（例如，由于配置变更），您必须确保再次调用此方法，以便保留自定义设置。

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

设置为 null 以完全清除边界框。新边界会替换之前指定的所有边界框。

当 LatLngBounds 发生更改时，SDK 会调整所有后续镜头更新，以尽可能遵循这些边界。请注意，出于技术方面的考虑，可能会阻止 SDK 将相机目标严格限制在边界内。例如，浮点精度舍入误差或缩放级别非常低。

替换“我的位置”图层的位置来源。

设置基本地图的样式。

使用样式选项，您可以将自定义样式应用于地图上的地图项和元素。如需详细了解样式定义，请参阅 MapStyleOptions。

设为 null 可清除所有之前的自定义样式。

用于设置应显示的地图图块类型。允许的值包括：

• MAP_TYPE_NORMAL：基本地图。
• MAP_TYPE_SATELLITE：卫星图像。
• MAP_TYPE_HYBRID：带有道路和标签的卫星图像。
• MAP_TYPE_TERRAIN：地形数据。
• MAP_TYPE_NONE：无基本地图图块。

设置相机缩放的首选上限。

当最大缩放级别发生变化时，SDK 会尽可能调整所有后续相机更新，以遵循该最大值。请注意，出于技术方面的考虑，可能会阻止 SDK 允许用户将地图进行过深缩放。例如，卫星地图或地形地图图块的最大缩放级别可能低于基本地图图块。

SDK 可解决最小值和最大值之间的任何冲突。如果您将最小缩放级别设置为高于当前最大缩放级别，SDK 会对最小和最大使用新的最小值。如果您将最大缩放级别设置为低于最小缩放级别，SDK 会针对最小和最大使用新的最大值。例如：假设当前的最小缩放级别为 8，最大缩放级别为 14。然后将最大缩放级别设置为 6。SDK 使用的最小缩放级别为 6，最大缩放级别为 6。

设置相机变焦的首选下限。

当最小缩放级别发生变化时，SDK 会尽可能调整所有后续相机更新，以遵循该最小缩放级别。请注意，出于技术方面的考虑，可能会阻止 SDK 允许用户将缩放级别设置得过低。

SDK 可解决最小值和最大值之间的任何冲突。如果您将最小缩放级别设置为高于当前最大缩放级别，SDK 会对最小和最大使用新的最小值。如果您将最大缩放级别设置为低于最小缩放级别，SDK 会针对最小和最大使用新的最大值。例如：假设当前的最小缩放级别为 8，最大缩放级别为 14。然后将最小缩放级别设置为 16。SDK 使用的最小缩放级别为 16，最大缩放级别为 16。

启用或停用“我的位置”图层。

在启用且位置信息可用后，“我的位置”图层会持续绘制用户当前位置和方位的指示信息，并显示可让用户与其位置互动的界面控件（例如，启用或停用相机对其位置和方位的跟踪）。

除非您设置了自定义位置信息来源，否则为使用“我的位置”图层功能，您需要请求 ACCESS_COARSE_LOCATION 或 ACCESS_FINE_LOCATION 的权限。

如果您已通过 setLocationSource(LocationSource) 设置自定义位置信息来源，Google Maps SDK for Android 将不会检查是否已授予上述权限。不过，您仍然需要确保用户已授予自定义位置信息来源所需的所有权限。

设置在镜头更改时调用的回调。

设置在镜头移动结束时调用的回调。

设置在镜头运动被新型动画停止或中断时调用的回调。

设置在镜头运动时重复调用的回调。该回调函数可以按每帧一次的频率调用，并且不应执行开销非常大的操作。

设置在镜头开始移动或镜头移动原因发生变化时调用的回调。

设置在用户点击圆形时调用的回调。

用于设置在用户点击地面叠加层时调用的回调。

设置或清除室内事件的监听器。一次只能设置一个监听器。设置新的监听器将会移除之前的监听器。

用于设置在用户点击标记信息窗口时调用的回调。

用于设置在标记的信息窗口关闭时调用的回调。

用于设置在用户长按标记的信息窗口时调用的回调。

用于设置在用户点按地图时调用的回调。

用于设置在此地图完成渲染时调用的回调。该回调函数只会调用一次。

如果在地图完全渲染的情况下调用此方法，系统会立即调用回调。如果地图因连接问题一直没有加载，或者地图因用户持续与地图互动而不断变化且未能完成加载，则不会触发此事件。

设置在长按地图时调用的回调。

用于设置在用户点击标记时调用的回调。

用于设置拖动标记时调用的回调。

设置在用户点击“我的位置”按钮时调用的回调。

如果 listener 返回 true，则系统会使用该事件，且不会发生默认行为。如果它返回 false，则会发生默认行为（即相机移动，使其以用户所在位置为中心）。

设置在“我的位置”点更改位置时调用的回调。

设置在用户点击“我的位置”圆点（表示用户的位置）时调用的回调。

设置将在用户点击或点按地图注点时触发的监听器。

传递 null 以清除监听器。

设置在用户点击多边形时调用的回调。

用于设置在用户点击多段线时调用的回调。

设置地图上的内边距。

通过此方法，您可以定义地图上的可见区域，以指示地图边缘周围的部分内容可能会被遮挡（方法是对地图的四条边缘分别设置内边距）。地图函数将根据内边距进行调整。例如，系统会移动缩放控件、罗盘、版权声明和 Google 徽标，以适应定义的区域内，镜头移动将相对于可见区域的中心，等等。

打开或关闭路况图层。

拍摄地图快照。

当互动式地图难以使用或无法使用时，您可以在应用内使用快照。例如，使用 snapshot() 方法生成的图片可用于在应用中显示地图缩略图，或在通知中心显示快照。

注意：地图图像不得传输到您的服务器，也不得在应用之外使用。如果您需要向其他应用或用户发送地图，请发送可供其为新用户重建地图的数据，而不是快照。

拍摄地图快照。

此方法等同于 snapshot(SnapshotReadyCallback)，但允许您提供预先分配的 Bitmap。如果该位图与地图的当前尺寸不匹配，则会分配另一个适合地图尺寸的位图。

虽然在大多数情况下，回调方法传递的对象与此方法的参数中给定的对象相同，但在某些情况下，返回的对象可以不同（例如，如果在实际拍摄快照时视图尺寸发生了更改）。因此，您应该只信任回调方法传递的位图的内容。

停止相机动画（若有正在进行的动画动画）。调用该方法时，镜头会立即停止移动并保持在该位置。