CameraUpdateFactory

公共最终类 CameraUpdateFactory 扩展对象

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

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

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

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

开发者指南

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

公共方法摘要

静态 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。

继承的方法摘要

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
返回

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

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

参数
latLng 包含所需纬度和经度的 LatLng 对象。
返回

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

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

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

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

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

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

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

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

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

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

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

<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 要垂直滚动的像素数。正值会移动镜头 相对于其当前方向向下移动。负值会移动镜头 相对于其当前方向的垂直方向。
返回

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

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

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

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

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

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

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

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

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

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

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

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

返回

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

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

返回

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

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

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