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

继承的方法摘要

公共方法

<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。增大值可放大。并非所有 区域具有最大缩放级别的图块。