CameraUpdateFactory

公共最终类 CameraUpdateFactory 扩展对象

一个类，包含用于创建 CameraUpdate 对象的方法，这些对象可更改地图镜头。 如需修改地图的镜头，请使用通过此类创建的 CameraUpdate 对象调用 animateCamera(CameraUpdate)、animateCamera(CameraUpdate, GoogleMap.CancelableCallback) 或 moveCamera(CameraUpdate)。

例如，要放大地图，您可以使用以下代码：

GoogleMap map = ...;
 map.animateCamera(CameraUpdateFactory.zoomIn());
 

在使用此类中的任何方法之前，您必须执行以下某项操作，以确保 此类已初始化：

• 等待已添加到应用的 MapFragment 或 MapView 变为可用的 GoogleMap。如需获取 GoogleMap 方法是调用 getMapAsync() 并等待 onMapReady(GoogleMap map) 回调。
• 调用 initialize(Context)。只要不抛出 GooglePlayServicesNotAvailableException，此类就会正确 初始化。

开发者指南

如需了解详情，请参阅镜头和视图 开发者指南。

公共方法摘要

静态 CameraUpdate	newCameraPosition(CameraPosition cameraPosition) 返回一个 CameraUpdate，它会将相机移动到指定的 CameraPosition。
静态 CameraUpdate	newLatLng(LatLng latLng)LatLng 返回一个 CameraUpdate，它会将屏幕中心移动到纬度和经度位置。 由 LatLng 对象指定。
静态 CameraUpdate	newLatLngBounds(LatLngBounds边界，整数宽度，整数高度，整数内边距) 返回一个 CameraUpdate，它会转换镜头，使指定的 纬度/经度边界在屏幕上的指定尺寸的边界框内居中显示 以尽可能高的缩放级别显示。
静态 CameraUpdate	newLatLngBounds(LatLngBounds边界，整数内边距) 返回一个 CameraUpdate，它会转换镜头，使指定的 纬度/经度边界以尽可能最高的缩放级别在屏幕上居中显示。
静态 CameraUpdate	newLatLngZoom(LatLng latLng，浮点缩放) 返回一个 CameraUpdate，它会将屏幕中心移动到纬度和经度位置。 由 LatLng 对象指定，并移动到指定的缩放级别。
静态 CameraUpdate	scrollBy(float xPixel, float yPixel) 返回一个 CameraUpdate，用于在地图上滚动镜头，并平移镜头的中心 在 x 和 y 方向上按指定像素数显示视图。
静态 CameraUpdate	zoomBy（浮点数，点焦点） 返回一个 CameraUpdate，用于更改当前镜头视点的缩放级别。
静态 CameraUpdate	zoomBy（浮点数） 返回一个 CameraUpdate，用于更改当前镜头视点的缩放级别。
静态 CameraUpdate	zoomIn() 返回 CameraUpdate，该对象可通过将视点的高度移近而放大地图 飞向地球表面
静态 CameraUpdate	zoomOut() 返回 CameraUpdate，它会通过移动视点的高度来缩小地图 距离地球表面越来越远
静态 CameraUpdate	zoomTo（浮动缩放） 返回可将镜头视点移至特定缩放级别的 CameraUpdate。

继承的方法摘要

继承自 java.lang.Object 类

boolean	equals（对象参数 0）
最后一站 类<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
字符串	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

公共方法

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate newCameraPosition (CameraPosition cameraPosition)

返回一个 CameraUpdate，它会将相机移动到指定的 CameraPosition。在 效果，这会根据 CameraPosition 对象的纬度创建转换， 经度、缩放级别、方位和倾斜度。

参数

cameraPosition

返回

• 包含转换的 CameraUpdate。

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate newLatLng (LatLng latLng)

返回一个 CameraUpdate，它会将屏幕中心移动到纬度和经度位置。 由 LatLng 对象指定。这会使相机位于 LatLng 对象的中心。

参数

latLng	包含所需纬度和经度的 LatLng 对象。

返回

• 包含转换的 CameraUpdate。

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate newLatLngBounds （LatLngBounds边界，整型宽度，整型高度，整型内边距）

返回一个 CameraUpdate，它会转换镜头，使指定的 纬度/经度边界在屏幕上的指定尺寸的边界框内居中显示 以尽可能高的缩放级别显示。您可以指定额外的内边距，以进一步限制 边界框的大小返回的 CameraUpdate 的方向角为 0 且倾斜度为 0 为 0。

与 newLatLngBounds(LatLngBounds, int) 不同，您可以使用 CameraUpdate 在地图的布局阶段之前更改镜头，因为 参数用于指定所需的边界框大小。

参数

bounds	要适合边界框的区域
width	边界框宽度，以像素为单位 (px)
高度	边界框高度，以像素为单位 (px)
填充	边界框的其他大小限制（以像素为单位）

返回

• 包含转换的 CameraUpdate。

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate newLatLngBounds （LatLngBounds边界，整数内边距）

返回一个 CameraUpdate，它会转换镜头，使指定的 纬度/经度边界以尽可能最高的缩放级别在屏幕上居中显示。您可以 指定内边距，以便从地图视图的边缘插入边框。返回的 CameraUpdate 的方向角为 0，倾斜度为 0。

在地图完成布局（在 以便让此方法正确确定合适的边框和缩放级别， 地图必须具有尺寸）。否则，会抛出 IllegalStateException。不是 足以提供地图；包含地图的视图也必须经过 以便确定其尺寸。如果您不能确定 请改用 newLatLngBounds(LatLngBounds, int, int, int)，并提供 手动设置地图尺寸

参数

bounds	适合屏幕大小的区域
填充	边界框边缘与视图边缘之间留出的间距（以像素为单位）。这个 值会应用到边界框的四条边。

返回

• 包含转换的 CameraUpdate。

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate newLatLngZoom （LatLng latLng，浮点缩放）

返回一个 CameraUpdate，它会将屏幕中心移动到纬度和经度位置。 由 LatLng 对象指定，并移动到指定的缩放级别。

参数

latLng	包含所需纬度和经度的 LatLng 对象。
缩放	在 2.0 到 21.0 的范围内设置所需的缩放级别。低于此范围的值包括 设为 2.0，而高于此值的值设为 21.0。增大值可放大。并非所有 区域具有最大缩放级别的图块。

返回

• 包含转换的 CameraUpdate。

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate scrollBy （浮动 xPixel，浮动 yPixel）

返回一个 CameraUpdate，用于在地图上滚动镜头，并平移镜头的中心 在 x 和 y 方向上按指定像素数显示视图。

示例：

• 如果 xPixel = 5 且 yPixel = 0，系统会通过移动镜头使摄像头向右滚动， 地图似乎向左偏移了 5 个像素。
• 如果 xPixel = 0 且 yPixel = 5，系统会向下滚动，方法是移动镜头，使 地图似乎向上移动了 5 个像素。

滚动方向是相对于镜头当前位置而言的。例如，如果相机位于 方位为 90 度，则东方为“上”向右滚动会将镜头向南移动。

参数

xPixel	水平滚动的像素数。正值会将镜头移至 以其当前方向为起点若为负值，则镜头 以其当前方向为起点
yPixel	要垂直滚动的像素数。正值会移动镜头 相对于其当前方向向下移动。负值会移动镜头 相对于其当前方向的垂直方向。

返回

• 包含转换的 CameraUpdate。

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate zoomBy （浮点数，焦点对焦）

返回一个 CameraUpdate，用于更改当前镜头视点的缩放级别。

焦点指定的点将保持固定（即，它与这两者都对应相同的纬度/经度 ）。

此方法与 zoomTo(float) 不同，缩放是相对于当前而言的 摄像头。

例如，如果 LatLng（11.11、22.22）当前位于屏幕位置 (23, 45)。使用缩放量和此 LatLng 调用此方法后，屏幕位置会 此 LatLng 的值仍然是 (23, 45)。

参数

金额	用于更改缩放级别。正值表示进一步靠近 而负值表示远离地球表面 地球。
焦点	像素位置在屏幕上的固定位置。 镜头移动前该像素位置的纬度/经度将保持不变 相机移动之后的状态。

返回

• 包含转换的 CameraUpdate。

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate zoomBy （浮点数）

返回一个 CameraUpdate，用于更改当前镜头视点的缩放级别。

此方法与 zoomTo(float) 不同，缩放是相对于当前而言的 摄像头。

参数

金额	用于更改缩放级别。正值表示进一步靠近 而负值表示远离地球表面 地球。

返回

• 包含转换的 CameraUpdate。

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate zoomIn ()

返回 CameraUpdate，该对象可通过将视点的高度移近而放大地图 飞向地球表面缩放增量为 1.0。

返回

• 包含转换的 CameraUpdate。

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate zoomOut ()

返回 CameraUpdate，它会通过移动视点的高度来缩小地图 距离地球表面越来越远缩放增量为 -1.0。

返回

• 包含转换的 CameraUpdate。

<ph type="x-smartling-placeholder"></ph> 公开 静态 CameraUpdate zoomTo （浮动缩放）

返回可将镜头视点移至特定缩放级别的 CameraUpdate。

参数

缩放	在 2.0 到 21.0 的范围内设置所需的缩放级别。低于此范围的值包括 设为 2.0，而高于此值的值设为 21.0。增大值可放大。并非所有 区域具有最大缩放级别的图块。