Mapbox Android学习笔记（6）相机的使用

Camera

Maps SDK的地图使用Mercator投影表示为平面。在东西轴线上，这张地图无缝地绕了无数次。由于地形图的底部和顶部可能无限地变大，并进一步扭曲地形图的两极，南北轴线在北纬90度和南纬90度左右被切断。考虑到这一点，引入相机对象来表示用户在地图上方的视角。

默认情况下，相机可以由用户或开发人员倾斜、旋转、缩放和/或移动。重要的是要知道，在不直接影响此行为的情况下，相机对象不会对您添加的标记、层的源或其他注释进行任何更改。

Maps SDK中提供了一些相机事件监听器，用于通知相机何时调整。您可以在Events文档中阅读关于这些侦听器的更多信息。

1. 相机位置

Maps SDK包含一个CameraPosition类，它由摄像机的目标、角度、缩放和倾斜组成。这些api形成了用户对地图块的透视图。

一个camera aposition对象可以改变相机对象的一个属性，比如缩放，或者它可以同时改变多个属性。例如，您可以编写代码让摄像机同时更改目标、缩小和倾斜：

CameraPosition position = new CameraPosition.Builder()
	.target(new LatLng(51.50550, -0.07520))
	.zoom(10)
	.tilt(20)
	.build();

注：您应该使用XML或通过MapboxMapOptions设置初始相机位置，以防止不必要的地图块下载，从而耗尽用户的数据。

目标

目标是一个单一的经纬度坐标，相机以它为中心。改变相机的目标会将相机移动到输入的坐标。目标是一个LatLng对象。目标坐标始终位于视图的中心。

倾斜

倾斜是相机从最低点(直接面对地球)的角度，使用单位角度。相机的最小(默认)倾斜度为0度，最大倾斜度为60度。倾斜水平使用六个小数点精度，这使您能够限制/设置/锁定地图的极端精度的轴承。

地图相机的倾斜也可以通过将两个手指放在地图上并同时上下移动手指来调整。

方位

方位是相机指向的方向，从北顺时针角度测量。

相机的默认方位为0度（即正北方向），导致地图罗盘隐藏，直到相机方位变为非零值。mapbox_uiCompass的布尔XML属性 允许调整罗盘的可见性。轴承等级使用6个小数点精度，这使您能够限制/设置/锁定地图的极端精度的轴承。除了可编程地调整相机的方位外，用户还可以将两个手指放在地图上并旋转手指。

缩放

缩放控制地图的比例，并使用0到22之间的任何值。在缩放级别0时，viewport显示大洲和其他世界特性。中间值11将显示城市级别的详细信息，在更高的缩放级别，地图将开始显示建筑物和感兴趣的点。相机可以通过以下方式放大：

• 捏动两个手指来放大和缩小。
• 用一根手指快速地在地图上点击两次来放大。
• 用一根手指快速地在地图上点击两次，在第二次点击后将手指按在屏幕上。然后向上滑动手指缩小，向下缩小。

2. 更新相机位置

Maps SDK中的 MapboxMap 类有几个方法可以改变相机的位置。每个相机移动API都接受一个 CameraUpdate 对象。您应该使用 CameraUpdateFactory 类来提供新的摄像机位置信息。 CameraUpdateFactory 可以构建几个不同的 CameraUpdate 对象，包括 newLatLngZoom()、zoomBy()、newLatLngBounds() 以及其他一些对象。CameraUpdate 中一个简单的方法是 newCameraPosition()，这是传递构建的 CameraPosition 的方法。

mapboxMap.animateCamera(CameraUpdateFactory.newCameraPosition(position), millisecondSpeed);

除了使用相机更新对象外，还可以添加一个 cancelable 回调函数，以知道动画何时完成，或者用户是否通过在地图上执行手势取消了相机的移动。 ease 和 animate api 有一个可选的持续时间参数(以毫秒为单位)，允许您控制摄像机的动画持续时间。API具体内容

3. 获得相机当前位置

MapboxMap类的 getCameraPosition() 方法帮助您的代码理解地图的相机发生了什么，以及用户正在查看什么。该方法返回一个 CameraPosition 对象，一旦有了该对象，就可以获取并使用相机的目标、倾斜、缩放和方位值。例如, mapboxMap.getCameraPosition ()。缩放是您获取相机当前缩放值的方式。

4. 将相机置于地图区域的中心

就像相机可以被限制在一个区域(见下)，相机也可以在地图区域内居中。首先，您需要一个定义好的 LatLngBounds 对象，该对象至少包含两个坐标。然后，您将能够使用 可用的 newLatLngBounds() API 更新摄像机位置，该API将获取您的边界框并调整视图端口，使指定的区域位于视图中。除了将包围框传递到相机更新工厂之外，还需要提供一个整数值，定义屏幕边缘和实际有界区域之间的填充。您还可以选择为框的每一侧提供不同的填充值。示例如下：

LatLngBounds latLngBounds = new LatLngBounds.Builder()
                    .include(first marker position)
                    .include(second marker position)
                    .build();

mapboxMap.animateCamera(CameraUpdateFactory.newLatLngBounds(latLngBounds, 10));

5. 将用户的平移限制在给定区域

MapboxMap类中的 setLatLngBoundsForCameraTarget 方法可以将地图相机限制在您想要的任何区域。如果向 LatLngBounds 对象提供至少两个 LatLng 对象/坐标，则会自动创建一个不可见的矩形，将摄像机限制在该区域内。

6. 相机和设备位置

如果您想了解更多关于相机控制及其在项目用户界面体验中的角色，请确保阅读Mapbox Location层组件提供的相机选项。（参照学习笔记（三）显示位置部分）