一个类,包含用于创建 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 | |
静态 CameraUpdate | |
静态 CameraUpdate |
newLatLngBounds(LatLngBounds边界,整数宽度,整数高度,整数内边距)
返回一个
CameraUpdate ,它会转换镜头,使指定的
纬度/经度边界在屏幕上的指定尺寸的边界框内居中显示
以尽可能高的缩放级别显示。 |
静态 CameraUpdate | |
静态 CameraUpdate | |
静态 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 |
---|
返回
- 包含转换的
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。增大值可放大。并非所有 区域具有最大缩放级别的图块。 |
---|