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,相机视图会被自动调整到这个区域。

猜你喜欢

转载自blog.csdn.net/u011435933/article/details/80601633
今日推荐