CameraUpdateFactory

clase final pública CameraUpdateFactory extiende el objeto

Una clase que contiene métodos para crear objetos CameraUpdate que cambian la cámara de un mapa. Para modificar la cámara del mapa, llama a animateCamera(CameraUpdate), animateCamera(CameraUpdate, GoogleMap.CancelableCallback) o moveCamera(CameraUpdate), mediante un objeto CameraUpdate creado con esta clase.

Por ejemplo, para acercar un mapa, puedes usar el siguiente código: 

GoogleMap map = ...;
 map.animateCamera(CameraUpdateFactory.zoomIn());

Antes de usar cualquier método de esta clase, debes realizar una de las siguientes acciones para asegurarte de que se inicializa esta clase:

Guía para desarrolladores

Para obtener más información, consulta Cámara y vista. de la guía para desarrolladores.

Resumen de métodos públicos

estático CameraUpdate
newCameraPosition(CameraPosition cameraPosition)
Muestra un CameraUpdate que mueve la cámara a un CameraPosition especificado.
estático CameraUpdate
newLatLng(latLng de LatLng)
Devuelve un objeto CameraUpdate que mueve el centro de la pantalla a una latitud y longitud. especificadas por un objeto LatLng.
estático CameraUpdate
newLatLngBounds(límites LatLngBounds, ancho y alto int, padding int)
Devuelve un CameraUpdate que transforma la cámara de modo que el valor especificado los límites de latitud y longitud se centran en la pantalla dentro de un cuadro delimitador de las dimensiones especificadas al máximo nivel de zoom posible.
estático CameraUpdate
newLatLngBounds(límites LatLngBounds, padding int)
Devuelve un CameraUpdate que transforma la cámara de modo que el valor especificado se centran en la pantalla con el máximo nivel de zoom posible.
estático CameraUpdate
newLatLngZoom(latLng LatLng, zoom de número de punto flotante)
Devuelve un objeto CameraUpdate que mueve el centro de la pantalla a una latitud y longitud. especificado por un objeto LatLng y se mueve al nivel de zoom determinado.
estático CameraUpdate
scrollBy(float xPixel, float yPixel)
Devuelve un objeto CameraUpdate que desplaza la cámara sobre el mapa y cambia el centro del por el número de píxeles especificado en la dirección x e y.
estático CameraUpdate
zoomBy(importe flotante, enfoque del punto)
Muestra un objeto CameraUpdate que cambia el nivel de zoom del punto de vista actual de la cámara.
estático CameraUpdate
zoomBy(importe flotante)
Muestra un objeto CameraUpdate que cambia el nivel de zoom del punto de vista actual de la cámara.
estático CameraUpdate
zoomIn()
Devuelve un objeto CameraUpdate que acerca la imagen en el mapa acercando la altura del punto de vista. a la superficie de la Tierra.
estático CameraUpdate
zoomOut()
Devuelve un objeto CameraUpdate que se aleja en el mapa moviendo la altura del punto de vista más lejos de la superficie de la Tierra.
estático CameraUpdate
zoomTo(zoom de punto flotante)
Devuelve un objeto CameraUpdate que mueve el punto de vista de la cámara a un nivel de zoom determinado.

Resumen de métodos heredados

Métodos públicos

público estático CameraUpdate . newCameraPosition (CameraPosition cameraPosition)

Muestra un CameraUpdate que mueve la cámara a un CameraPosition especificado. En Esto crea una transformación a partir de la latitud del objeto CameraPosition, como la longitud, el nivel de zoom, el rumbo y la inclinación.

Parámetros
cameraPosition
Muestra

público estático CameraUpdate . newLatLng (LatLng latLng)

Devuelve un objeto CameraUpdate que mueve el centro de la pantalla a una latitud y longitud. especificadas por un objeto LatLng. De esta manera, la cámara se centra en el objeto LatLng.

Parámetros
latLng Un objeto LatLng que contenga la latitud y longitud deseadas
Muestra

público estático CameraUpdate . newLatLngBounds (LatLngBounds límites, ancho y alto int, padding int)

Devuelve un CameraUpdate que transforma la cámara de modo que el valor especificado los límites de latitud y longitud se centran en la pantalla dentro de un cuadro delimitador de las dimensiones especificadas al máximo nivel de zoom posible. Puedes especificar padding adicional para restringir aún más el tamaño del cuadro delimitador. El objeto CameraUpdate que se muestra tiene un rumbo de 0 y una inclinación de 0.

A diferencia de newLatLngBounds(LatLngBounds, int), puedes usar CameraUpdate. que devuelve este método para cambiar la cámara antes de la fase de diseño del mapa, ya que la los argumentos especifican el tamaño deseado del cuadro delimitador.

Parámetros
límites la región para que se ajuste al cuadro delimitador
ancho ancho del cuadro delimitador en píxeles (px)
alto altura del cuadro delimitador en píxeles (px)
padding restricción de tamaño adicional (en píxeles) del cuadro de límite
Muestra

público estático CameraUpdate . newLatLngBounds (LatLngBounds, padding int)

Devuelve un CameraUpdate que transforma la cámara de modo que el valor especificado se centran en la pantalla con el máximo nivel de zoom posible. Puedes especificar padding para insertar el cuadro delimitador desde los bordes de la vista de mapa. El valor devuelto CameraUpdate tiene un rumbo de 0 y una inclinación de 0.

No cambies la cámara con esta actualización hasta que el mapa se haya diseñado (en para que este método determine correctamente el cuadro de límite y el nivel de zoom adecuados, mapa debe tener un tamaño). De lo contrario, se arrojará una IllegalStateException. NO es suficiente para que el mapa esté disponible; la vista que contiene el mapa también debe haberse sometido del diseño de manera tal que se hayan determinado sus dimensiones. Si no puedes estar seguro de que tiene usa newLatLngBounds(LatLngBounds, int, int, int) y proporciona la dimensiones del mapa manualmente.

Parámetros
límites región para que quepa en la pantalla
padding espacio (en px) para dejar entre los bordes del cuadro delimitador y los bordes de la vista. Esta se aplica a los cuatro lados del cuadro delimitador.
Muestra

público estático CameraUpdate . newLatLngZoom (LatLng latitud y longitud, zoom de número de punto flotante)

Devuelve un objeto CameraUpdate que mueve el centro de la pantalla a una latitud y longitud. especificado por un objeto LatLng y se mueve al nivel de zoom determinado.

Parámetros
latLng Un objeto LatLng que contenga la latitud y longitud deseadas
zoom el nivel de zoom deseado, dentro del rango de 2.0 a 21.0. Los valores por debajo de este rango son establecido en 2.0, y los valores superiores a este, en 21.0. Aumenta el valor para acercar la imagen. Es posible que no todas las áreas tienen mosaicos con los niveles de zoom más altos.
Muestra

público estático CameraUpdate . scrollBy (float xPixel, float yPixel)

Devuelve un objeto CameraUpdate que desplaza la cámara sobre el mapa y cambia el centro del por el número de píxeles especificado en la dirección x e y.

Ejemplos:

  • Si xPixel = 5 e yPixel = 0, el sistema se desplaza hacia la derecha moviendo la cámara para que la parece que se desplazó 5 píxeles hacia la izquierda.
  • Si xPixel = 0 e yPixel = 5, el sistema se desplaza hacia abajo moviendo la cámara para que la mapa parece desplazarse 5 píxeles hacia arriba.

El desplazamiento se relaciona con la orientación actual de la cámara. Por ejemplo, si la cámara está 90 grados, el este equivale a "arriba" y, cuando te desplaces hacia la derecha, se moverá hacia el sur.

Parámetros
xPixel la cantidad de píxeles para desplazarse horizontalmente. Un valor positivo mueve la cámara a la derecha, con respecto a su orientación actual. Un valor negativo mueve la cámara a la izquierda, con respecto a su orientación actual.
yPixel la cantidad de píxeles que se deben desplazar verticalmente. Un valor positivo mueve la cámara hacia abajo, con respecto a su orientación actual. Un valor negativo mueve la cámara hacia arriba, con respecto a su orientación actual.
Muestra

público estático CameraUpdate . zoomBy (importe flotante, enfoque puntual)

Muestra un objeto CameraUpdate que cambia el nivel de zoom del punto de vista actual de la cámara.

Un punto especificado por el enfoque permanecerá fijo (es decir, corresponderá a la misma latitud y longitud a ambos). antes y después del proceso de zoom).

Este método es diferente de zoomTo(float), ya que el zoom es relativo al valor actual cámara.

Por ejemplo, si LatLng (11.11, 22.22) se encuentra actualmente en la ubicación de la pantalla (23, 45). Después de llamar a este método con un nivel de zoom y este LatLng, la ubicación de la pantalla de este LatLng seguirán siendo (23, 45).

Parámetros
cantidad para cambiar el nivel de zoom. Los valores positivos indican que el zoom se acerca más al la superficie de la Tierra, mientras que los valores negativos indican que se aleja de la superficie de la la Tierra.
enfoque ubicación de píxeles en la pantalla que debe permanecer fija después del proceso de acercamiento. La latitud y la longitud que se encontraba en la ubicación de los píxeles antes del movimiento de la cámara se mantendrá igual. después de que la cámara se haya movido.
Muestra

público estático CameraUpdate . zoomBy (importe flotante)

Muestra un objeto CameraUpdate que cambia el nivel de zoom del punto de vista actual de la cámara.

Este método es diferente de zoomTo(float), ya que el zoom es relativo al valor actual cámara.

Parámetros
cantidad para cambiar el nivel de zoom. Los valores positivos indican que el zoom se acerca más al la superficie de la Tierra, mientras que los valores negativos indican que se aleja de la superficie de la la Tierra.
Muestra

público estático CameraUpdate . zoomIn ()

Devuelve un objeto CameraUpdate que acerca la imagen en el mapa acercando la altura del punto de vista. a la superficie de la Tierra. El incremento del zoom es de 1.0.

Muestra

público estático CameraUpdate . zoomOut ()

Devuelve un objeto CameraUpdate que se aleja en el mapa moviendo la altura del punto de vista más lejos de la superficie de la Tierra. El incremento del zoom es de -1.0.

Muestra

público estático CameraUpdate . zoomTo (zoom de número de punto flotante)

Devuelve un objeto CameraUpdate que mueve el punto de vista de la cámara a un nivel de zoom determinado.

Parámetros
zoom el nivel de zoom deseado, dentro del rango de 2.0 a 21.0. Los valores por debajo de este rango son establecido en 2.0, y los valores superiores a este, en 21.0. Aumenta el valor para acercar la imagen. Es posible que no todas las áreas tienen mosaicos con los niveles de zoom más altos.