com.amap.api.maps2d

## 类 CameraUpdateFactory

- java.lang.Object
- - com.amap.api.maps2d.CameraUpdateFactory

-     public final class CameraUpdateFactory
      extends java.lang.Object

  这是类是创建CameraUpdate对象的工厂类。
  从以下版本开始:
    V2.0

- - ### 构造器概要

    构造器
    构造器和说明
    `CameraUpdateFactory()`

  - ### 方法概要

    所有方法 静态方法 具体方法
    限定符和类型 | 方法和说明
    --- | ---
    `static CameraUpdate` | `changeLatLng(LatLng latLng)` 返回一个CameraUpdate对象，只改变地图可视区域中心点，地图缩放级别不变。
    `static CameraUpdate` | `newCameraPosition(CameraPosition cameraPosition)` 返回一个定义了可视区域移动位置CameraUpdate 对象。
    `static CameraUpdate` | `newLatLng(LatLng latLng)` 返回一个移动目的地的屏幕中心点的经纬度的CameraUpdate 对象。
    `static CameraUpdate` | `newLatLngBounds(LatLngBounds bounds, int padding)` 返回CameraUpdate对象，这个对象包含一个经纬度限制的区域，并且是最大可能的缩放级别。
    `static CameraUpdate` | `newLatLngBounds(LatLngBounds bounds, int width, int height, int padding)` 返回CameraUpdate对象，这个对象包含一个经纬度限制的区域这个区域将会放置在屏幕中间， 并且是最大可能的缩放级别。
    `static CameraUpdate` | `newLatLngZoom(LatLng latLng, float zoom)` 返回一个CameraUpdate 对象，包括可视区域框移动目标点屏幕中心位置的经纬度以及缩放级别。
    `static CameraUpdate` | `scrollBy(float xPixel, float yPixel)` 返回一个CameraUpdate 对象，此对象为改变可视区域的中心的值，单位像素。
    `static CameraUpdate` | `zoomBy(float amount)` 返回一个CameraUpdate对象，改变了当前可视区域的zoom 级别。
    `static CameraUpdate` | `zoomBy(float amount, Point focus)` 返回一个CameraUpdate 对象改变当前可视区域的缩放级别。
    `static CameraUpdate` | `zoomIn()` 返回一个包含缩放级别增大的CameraUpdate 对象，调用此方法一次缩放级别加大一级，也就是屏幕距离地面更近一级。
    `static CameraUpdate` | `zoomOut()` 返回一个包含缩放级别减小的CameraUpdate 对象，调用此方法一次缩放级别的减小一级，也就是屏幕距离地面更远一级。
    `static CameraUpdate` | `zoomTo(float zoom)` 返回一个包含缩放级别改变的CameraUpdate 对象。

    - ### 从类继承的方法 java.lang.Object

      `equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### 构造器详细资料

    - #### CameraUpdateFactory

          public CameraUpdateFactory()

  - ### 方法详细资料

    - #### zoomIn

          public static CameraUpdate zoomIn()

      返回一个包含缩放级别增大的CameraUpdate 对象，调用此方法一次缩放级别加大一级，也就是屏幕距离地面更近一级。
      返回:
        一个包含缩放级别改变的CameraUpdate 对象
      从以下版本开始:
        V2.0

    - #### zoomOut

          public static CameraUpdate zoomOut()

      返回一个包含缩放级别减小的CameraUpdate 对象，调用此方法一次缩放级别的减小一级，也就是屏幕距离地面更远一级。
      返回:
        一个包含缩放级别改变的CameraUpdate 对象。
      从以下版本开始:
        V2.0

    - #### scrollBy

          public static CameraUpdate scrollBy(float xPixel,
                                              float yPixel)

      返回一个CameraUpdate 对象，此对象为改变可视区域的中心的值，单位像素。可视区域中心点将会在x 和y 轴方向按参数的数据进行移动。

      案例:

      如果传入的xPixel = 5 、 yPixel = 0，则系统将可视区域向右移动，所以地图将显示为向左移动5 个像素。

      如果传入xPixel = 0 、 yPixel = 5，则系统将可视区域向下移动，所以地图显示为向上移动了5 个像素。

      参数:
        `xPixel` - 这是水平移动的像素数。正值代表可视区域向右移动，负值代表可视区域向左移动。
        `yPixel` - 这是垂直移动的像素数。正值代表可视区域向下移动，负值代表可视区域向上移动。
      返回:
        一个包含可视区域移动的CameraUpdate 对象。
      从以下版本开始:
        V2.8.1

    - #### zoomTo

          public static CameraUpdate zoomTo(float zoom)

      返回一个包含缩放级别改变的CameraUpdate 对象。缩放级别将改变为转入的参数值。
      参数:
        `zoom` - 描述了一个缩放级别。高德地图的缩放级别是在3-19 之间。
      从以下版本开始:
        V2.0

    - #### zoomBy

          public static CameraUpdate zoomBy(float amount)

      返回一个CameraUpdate对象，改变了当前可视区域的zoom 级别。 这个方法不同于zoomTo(float)，它作用于当前可视区域。
      参数:
        `amount` - 修改的缩放级别。数值越大，界面距离地面越远。
      返回:
        一个改变缩放级别的CameraUpdate对象。
      从以下版本开始:
        V2.0

    - #### zoomBy

          public static CameraUpdate zoomBy(float amount,
                                            Point focus)

      返回一个CameraUpdate 对象改变当前可视区域的缩放级别。 Point 类型的参数可以指定缩放级别修改后的焦点，我们建议在缩放级别修改前后的焦点保持不变。 这个方法与zoomTo(float)方法是不同的，这个方法是修改了当前的可视区域。 例如：如果你经纬度(11.11, 22.22)在当前屏幕上的位置是（23，45）。在调用这个方法改变的缩放级别和经纬度后，这个经纬度在屏幕上的位置仍是(23, 45)。
      参数:
        `amount` - 修改的缩放级别。数值越大，界面距离地面越大。
        `focus` - Point 类型的参数可以指定缩放级别修改后的焦点，我们建议在缩放级别修改前后的焦点保持不变。
      返回:
        一个包含可视区域移动的CameraUpdate 对象。
      从以下版本开始:
        V2.0

    - #### newCameraPosition

          public static CameraUpdate newCameraPosition(CameraPosition cameraPosition)

      返回一个定义了可视区域移动位置CameraUpdate 对象。
      参数:
        `cameraPosition` - 一个cameraPosition的对象。
      返回:
        一个包含位置变换信息的CameraUpdate 对象。
      从以下版本开始:
        V2.0

    - #### newLatLng

          public static CameraUpdate newLatLng(LatLng latLng)

      返回一个移动目的地的屏幕中心点的经纬度的CameraUpdate 对象。移动后的地图缩放级别改变，缩放级别为4（固定值）。
      参数:
        `latLng` - 一个移动目的地的屏幕中心点的经纬度的latLng 对象。
      返回:
        返回一个移动目的地的屏幕中心点的经纬度的CameraUpdate 对象。
      从以下版本开始:
        V2.0

    - #### newLatLngZoom

          public static CameraUpdate newLatLngZoom(LatLng latLng,
                                                   float zoom)

      返回一个CameraUpdate 对象，包括可视区域框移动目标点屏幕中心位置的经纬度以及缩放级别。
      参数:
        `latLng` - 可视区域框移动目标点屏幕中心位置的经纬度。
        `zoom` - 可视区域的缩放级别，高德地图支持3-19 级的缩放级别。
      返回:
        一个CameraUpdate 对象。
      从以下版本开始:
        V2.0

    - #### newLatLngBounds

          public static CameraUpdate newLatLngBounds(LatLngBounds bounds,
                                                     int padding)

      返回CameraUpdate对象，这个对象包含一个经纬度限制的区域，并且是最大可能的缩放级别。 你可以设置一个边距数值来控制插入区域与view的边框之间的空白距离。 方法必须在地图初始化完成之后使用。
      参数:
        `bounds` - 屏幕上的一个区域 padding 设置区域和view之间的空白距离，单位像素。这个值适用于区域的四个边。
      返回:
        一个包含变化信息的CameraUpdate对象
      从以下版本开始:
        V2.0.1

    - #### changeLatLng

          public static CameraUpdate changeLatLng(LatLng latLng)

      返回一个CameraUpdate对象，只改变地图可视区域中心点，地图缩放级别不变。
      参数:
        `latLng` - 地图可视区域中心点坐标
      返回:
        一个包含地图可视区域中心点坐标改变的CameraUpdate对象。
      从以下版本开始:
        V2.1.0

    - #### newLatLngBounds

          public static CameraUpdate newLatLngBounds(LatLngBounds bounds,
                                                     int width,
                                                     int height,
                                                     int padding)

      返回CameraUpdate对象，这个对象包含一个经纬度限制的区域这个区域将会放置在屏幕中间， 并且是最大可能的缩放级别。你可以设置一个边距数值来控制插入区域与view的边框之间的空白距离。 和newLatLngBounds(LatLngBounds, int)不一样的是，这个方法可以根据长、宽参数来决定限制区域的大小。
      参数:
        `bounds` - 限制区域的对象 width 限制区域的宽度，单位像素 height 限制区域的高度，单位像素 padding 限制区域的边框大小，单位像素
      返回:
        CameraUpdate对象，它包含了变换信息
      从以下版本开始:
        V2.0.1