并非所有mapbox.com的服务在中国提供
Android 地图 SDK
并非所有mapbox.com的服务在中国提供
使用墨卡托投影将 Maps SDK 的地图表示为平面。在东西轴上，该地图无缝地自我环绕无限次。因为地图的底部和顶部可无限增大，并将地图进一步朝两极扭曲，所以南北轴在北纬 90 度和南纬 90 度处被切断。考虑到这一点，引入了Camera 对象，来代表用户在地图上方的视点。
默认情况下，Camera 可以由用户或开发者倾斜（tilted）、旋转（rotated）、缩放（zoomed） 和移动（moved）。需要注意的是 Camera 不会对地图中的标记、图层数据源或其他标注进行任何更改。
Maps SDK 提供了一些 Camera 事件监听器来监听各种通知，如何时调整 Camera 等。您可以在事件文档中阅读有关这些监听器的更多信息。
Maps SDK 包括一个 CameraPosition 类，它包含Camera 的目标、角度、缩放和倾斜。这些 API 会塑造用户对地图切片的视角。
CameraPosition 对象可以更改Camera 对象的单个属性（如缩放），也可以同时更改多个属性。例如，您可以编写代码，让Camera 更改其位置，并且缩小和倾斜：
CameraPosition position = new CameraPosition.Builder() .target(new LatLng(51.50550, -0.07520)) // 设置新Camera 位置 .zoom(10) // 将缩放设置为 level 10 .tilt(20) // 将Camera 倾斜设置为 20 度 .build(); // 从构建器构建 CameraPosition 对象阅读有关 mapView XML 属性的所有信息，以了解如何设置Camera 的初始位置。最好以 XML 格式或通过 MapboxMapOptions 设置来初始Camera 位置，以防止下载地图不必要地切片。
目标 Target 是 Camera 居中的一个单一经纬度坐标。改变 Camera 的目标 Target 会将 Camera 移动到输入的坐标。目标 Target 是 LatLng 对象。目标 Target 坐标始终位于视区的中心。
倾斜 Tilt 是从最低点（直接面对地球）测量的Camera 角度并使用度作为单位。Camera 的最小（默认）倾斜为 0 度，最大倾斜为 60 度。倾斜水平使用六位小数精度，这使您能够极其精确地限制/设置/锁定地图的方位。
也可以通过将两个指尖放在地图上并同时上下平行移动两根手指，来调整地图 Camera 倾斜度。
方位 Bearing 代表 Camera 指向的方向，并从北按顺时针以角度为单位来测量。
Camera 的默认方位是 0 度（即“正北”），当 Camera 方位变为非零值时，就会显示地图罗盘。mapbox_uiCompass 布尔 XML 属性允许调整罗盘的可见性。方位水平使用六位小数精度，这使您能够极其精确地限制/设置/锁定地图的方位。除了以编程方式，用户还可以将两根手指放在地图上并旋转手指调整 Camera 方位，。
通过缩放Zoom 控制地图的比例，并采用 0 到 22 之间的任何值。在缩放Zoom 为 0时，当前视区就会显示大洲和其他世界要素。中间值 11 将显示城市水平的细节，而在更高缩放水平，地图将开始显示建筑物和兴趣点。Camera 可以通过以下方式缩放：
浏览关于地图的艺术/科学的Mapbox 文章，以及视觉信息以确保您的地图样式在正确的 Camera 位置显示正确数据。
Maps SDK 中的 MapboxMap 类有几种方法来改变 Camera 位置。每个 Camera 移动 API 都采用一个 CameraUpdate（使用 CameraUpdateFactory 来构建），这就是您更新 Camera 位置信息的方式。CameraUpdateFactory 可以构建若干个不同的 CameraUpdate 对象，包括 newLatLngZoom()、zoomBy()、newLatLngBounds()等等。CameraUpdate 有一个十分简单的方法 newCameraPosition()，可以用来创建新的 CameraPosition对象。
除了采用CameraUpdate 对象外，还可以添加一个可取消的回调来了解动画何时结束，或者用户是否在地图上做出手势来取消 Camera 移动。easeCamera()和easeCamera()方法具有可选的持续时间参数（单位毫秒），让您可以控制Camera的动画持续时间。
| API | 描述 |
|---|---|
moveCamera() | 根据更新中定义的说明来重新定位Camera，并将Camera 瞬时移动。建议避免使用此 API，倾向于使用easeCamera()或animateCamera()，Camera 自我定位在地图上时，这两个 API 将为用户提供更多上下文。 |
easeCamera() | 在默认持续时间内逐渐移动Camera，除非在 CameraUpdate 中指定，否则缩放不会受到影响。如果您计划让地图 Camera 在移动时跟踪当前用户，这就是要使用的正确 API，因为其中一个参数可以设置为 false，从而禁用动画插值而产生线性移动动画。 |
animateCamera() | 使用过渡动画来唤醒动力飞行，使 Camera 生成动画，移动到 CameraUpdate 中定义的新位置。 |
MapboxMap 类的 getCameraPosition() 方法使您的代码很容易得到您的地图 Camera 发生的情况，以及用户当前的地图视图。该方法返回一个 CameraPosition 对象。一旦您拥有该对象，就可以轻松获取和使用 Camera 的目标 Target、倾斜 Tilt、缩放 Zoom 和方位值 Bearing。例如，mapboxMap.getCameraPosition().zoom 就是您获取 Camera 的缩放值 Zoom 的方式。
与将 Camera 限制到一个区域（见下文）类似，Camera 也可以在地图区域内居中。首先，您需要一个定义的 LatLngBounds 对象，其中至少包含两个坐标。然后，您可以使用可用的 new LatLngBounds() API 来更新 Camera 位置，它采用您的边界框并调整视区，这样指定区域将处在视图中。除了把LatLngBounds 传入CameraUpdateFactory 外，您还需要提供一个整数值，来定义屏幕边缘与实际边界区域之间的边距。您还可以为框的每一侧提供不同的边距值。
LatLngBounds latLngBounds = new LatLngBounds.Builder() .include(first marker position) .include(second marker position) .build(); mapboxMap.animateCamera(CameraUpdateFactory.newLatLngBounds(latLngBounds, 10));MapboxMap 类中的 setLatLngBoundsForCameraTarget 方法可以将地图 Camera 限制到您想要的任何区域内。您至少使用两个 LatLng 对象/坐标来创建一个 LatLngBounds 对象，这样会自动创建一个隐形正方形，从而将 Camera 限制在该区域内。