Mapbox Android SDK官方教程（四）——Camera

Camera

SDK用墨卡托投影来表达一个平面，Camera代表在地图之上用户的视角。

默认情况下，camera可以被用户或者开发者倾斜、旋转、缩放和移动。需要注意的是camera并没有改变markers、图层数据源、其他你添加的标注。

一些camera事件监听器被提供用来监听例如camera调整等事件。

Camera position

SDK包括一个由camera目标、角度、缩放、倾斜度等组成的CameraPosition类。这些元素组成了用户的地图视角。

一个CameraPosition事件可以改变一个属性例如zoom，也可以同时改变多个属性，例如你可以同时变化camera的target、zoom、tilt。

阅读mapview xml attributes 获取更多设置camera初始位置的信息。通过设置初始camera位置或者配置MapboxMapOptions来阻止不必要的瓦片数据的下载。

Target

target是一组代表camera中心位置的经纬度坐标，改变camera的targe将会移动camera到你输入的坐标，target是LatLNG

类型，target坐标总是在观察的的中心。

Tilt

倾斜是camera的天顶角，单位为度。camera的最小倾斜为0度，最大倾斜为60度。倾斜精度精确到小数点后6位，足够满足对地图视角方位的要求。

地图camera倾斜也可以通过两个手指来调整：两个手指同时平行向上或向下滑动

Bearing

Bearing可以理解为方位角，默认情况下，camera的bearing为0度，即指向真北方向，这时候罗盘会自动隐藏，除非camera的bearing为非0时。mapbox_uiCompass的xml布局可以调整罗盘的可见性。方位角精度也是6位，确保以足够的精度旋转地图。除此之外，用户可以通过在屏幕上旋转两个手指来实现bearing的变化。

Zoom

缩放控制地图的规模，被控制在0到22之间。在缩放等级为0时，事件显示各大洲和其他世界要素。中间的11等级将显示城市的细节。更大的缩放等级，地图将开始展示建筑和兴趣点。camera缩放可以通过以下几种方式实现：

· 两个手指相对或相向运动可缩放地图

· 连续点击地图同一地点两次可放大该地点

· 双击地图两次，并且在几秒后保持手指在屏幕上向下向上滑动，可以缩放地图

Update the camera position

SDK中MapboxMap类有几种改变相机位置的方法，每种camera移动API都提供一个用来更新位置的CameraUpdate。每种移动camera的API都用cameraUpdate来更新当前新的相机位置。Camera 更新工厂提供几种不同的cameraUpdate事件，包括newLatLngZoom（）、zoomBy（）、newLatLngBounds（）等等。要提醒的是cameraUpdate是你提供的一个新的newCameraPosition（）。

除了提供一个camera更新事件，当动画结束或者用户通过手指操作地图结束camera移动时，提供一个可撤销回调。撤销和动画APIS提供一系列用来控制相机动画期间的参数。

moveCamera()——相当于基础配置，用于定义camera更新和移动瞬间。不建议使用这个，建议使用下面的ease和animate。

easeCamera()——在默认时间和缩放内，逐渐移动相机位置，除非cameraUpdate能打断。如果你希望相机随着当前用户移动跟踪用户，就可以使用这个api，将其中一个参数设为fales，禁止动画打断，得到一个线性移动的动画

animationCamere()——根据CameraUpdate提供的位置，使用动画移动到新的位置

Get the current camera position

MapboxMap的getCameraPosition（）方法能使你轻易理解你地图相机发生了什么和在什么位置。这个方法返回一个CameraPosition对象。当你获取到这个对象后，可以很容易的使用相机的位置、倾斜、缩放等级、旋转角度等。例如mapboxMap.getCameraPositon（）.zoom可以获取到当前相机的缩放等级。

Center the camera within a map area

可以将相机放置到一个区域，或者一个地图的中间。首先你要定义LatLngBounds对象，里面至少包含两个坐标。下面你就可以更新camera位置通过使用newLatLngBounds() API，这个api可以获取边界盒并且调整视图到当前位置。除了需要将bounding box传入到camera update factory，你也要提供一个定义屏幕内边缘距的整数值，你也可以为不同的边缘提供不同的值。

Restricting the user's panning to a given area

mapboxmap中setLatLngBoundsForCameraTarget方法可以将相机视图限制到你想要的任何面域内。如果你用最小的两个LatLng坐标填充LatLngBounds，相机视图会被自动调整到这个区域。