CameraUpdateFactory

la 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) con 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 inicialice:

Guía para desarrolladores

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

Resumen de métodos públicos

CameraUpdate estática
newCameraPosition(CameraPosition)
Muestra un CameraUpdate que mueve la cámara a un CameraPosition especificado.
CameraUpdate estática
newLatLng(LatLng latLng)
Muestra un objeto CameraUpdate que mueve el centro de la pantalla a una latitud y longitud especificadas por un objeto LatLng.
CameraUpdate estática
newLatLngBounds(LatLngBounds, ancho int, altura int, relleno int)
Muestra un objeto CameraUpdate que transforma la cámara de modo que los límites de latitud y longitud especificados se centren en la pantalla dentro de un cuadro de límite de dimensiones especificadas con el mayor nivel de zoom posible.
CameraUpdate estática
newLatLngBounds(LatLngBounds, límites de relleno int)
Muestra un objeto CameraUpdate que transforma la cámara de modo que los límites de latitud y longitud especificados se centren en la pantalla al mayor nivel de zoom posible.
CameraUpdate estática
newLatLngZoom(LatLng latLng, zoom flotante)
Muestra un objeto CameraUpdate que mueve el centro de la pantalla a una latitud y longitud especificadas por un objeto LatLng y se mueve al nivel de zoom especificado.
CameraUpdate estática
scrollBy(xPixel flotante, flotador yPixel)
Muestra un objeto CameraUpdate que desplaza la cámara por el mapa y cambia el centro de visión en función de la cantidad de píxeles especificada en las direcciones x e y.
CameraUpdate estática
zoomBy(número de punto flotante, enfoque de punto)
Muestra un objeto CameraUpdate que cambia el nivel de zoom del punto de vista de la cámara actual.
CameraUpdate estática
zoomBy(valor flotante)
Muestra un objeto CameraUpdate que cambia el nivel de zoom del punto de vista de la cámara actual.
CameraUpdate estática
Acercar()
Muestra un objeto CameraUpdate que se acerca al mapa moviendo la altura del punto de vista más cerca de la superficie de la Tierra.
CameraUpdate estática
zoomOut()
Muestra un objeto CameraUpdate que aleja el mapa al alejar la altura del punto de vista de la superficie de la Tierra.
CameraUpdate estática
zoomTo(zoom flotante)
Muestra 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

public static CameraUpdate newCameraPosition (CameraPosition cámaraPosition)

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

Parámetros
Posición de la cámara
Resultado que se muestra

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

Muestra un objeto CameraUpdate que mueve el centro de la pantalla a una latitud y longitud especificadas por un objeto LatLng. Esto centra la cámara en el objeto LatLng.

Parámetros
latLng un objeto LatLng que contenga la latitud y longitud deseadas
Resultado que se muestra

public static CameraUpdate newLatLngBounds (LatLngBounds límites, int width, int height, int padding)

Muestra un objeto CameraUpdate que transforma la cámara de modo que los límites de latitud y longitud especificados se centren en la pantalla dentro de un cuadro de límite de dimensiones especificadas con el mayor nivel de zoom posible. Puedes especificar padding adicional para restringir aún más el tamaño del cuadro de límite. 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 el objeto CameraUpdate que muestra este método para cambiar la cámara antes de la fase de diseño del mapa, ya que los argumentos especifican el tamaño deseado del cuadro de límite.

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

public static CameraUpdate newLatLngBounds (LatLngBounds límites, relleno interno)

Muestra un objeto CameraUpdate que transforma la cámara de modo que los límites de latitud y longitud especificados se centren en la pantalla al mayor nivel de zoom posible. Puedes especificar padding para insertar el cuadro de límite en los bordes de la vista de mapa. El objeto CameraUpdate que se muestra tiene un rumbo de 0 y una inclinación de 0.

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

Parámetros
límites región para que se ajuste a la pantalla
padding espacio (en px) para dejar entre los bordes del cuadro de límite y los bordes de la vista. Este valor se aplica a los cuatro lados del cuadro de límite.
Resultado que se muestra

público estático CameraUpdate newLatLngZoom (LatLng latLng, zoom flotante)

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

Parámetros
latLng un objeto LatLng que contenga la latitud y longitud deseadas
zoom el nivel de zoom deseado, en el rango de 2.0 a 21.0. Los valores inferiores a este rango se establecen en 2.0 y los valores superiores se establecen en 21.0. Aumenta el valor para acercar la imagen. No todas las áreas tienen mosaicos en los niveles de zoom más altos.
Resultado que se muestra

public static CameraUpdate scrollBy (float xPixel, float yPixel)

Muestra un objeto CameraUpdate que desplaza la cámara por el mapa y cambia el centro de visión en función de la cantidad de píxeles especificada en las direcciones x e y.

Ejemplos:

  • Si xPixel = 5 y yPixel = 0, el sistema se desplaza hacia la derecha moviendo la cámara para que el mapa parezca desplazarse 5 píxeles hacia la izquierda.
  • Si xPixel = 0 e yPixel = 5, el sistema se desplaza hacia abajo moviendo la cámara para que el mapa parezca 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 apunta a 90 grados, el este será “arriba” y, si te desplazas hacia la derecha, la cámara se moverá hacia el sur.

Parámetros
Pixel X la cantidad de píxeles en los que se debe desplazar horizontalmente. Un valor positivo mueve la cámara hacia la derecha, con respecto a su orientación actual. Un valor negativo mueve la cámara hacia la izquierda con respecto a su orientación actual.
Pixel la cantidad de píxeles en los que se debe 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.
Resultado que se muestra

public static CameraUpdate zoomBy (número de punto flotante, enfoque de punto)

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

Un punto especificado por foco permanecerá fijo (es decir, corresponde a la misma latitud/longitud antes y después del proceso de zoom).

Este método es diferente de zoomTo(float), ya que el zoom está relacionado con la cámara actual.

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 zoom y LatLng, la ubicación de la pantalla de este LatLng seguirá siendo (23, 45).

Parámetros
cantidad para cambiar el nivel de zoom. Los valores positivos indican un acercamiento a la superficie de la Tierra, mientras que los valores negativos indican que se aleja de ella.
enfoque ubicación de los píxeles en la pantalla que permanecerá fija después del proceso de zoom. Las coordenadas de latitud/longitud que se encontraban en esa ubicación de píxeles antes del movimiento de la cámara permanecerán iguales después de que esta se haya movido.
Resultado que se muestra

public static CameraUpdate zoomBy (monto flotante)

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

Este método es diferente de zoomTo(float), ya que el zoom está relacionado con la cámara actual.

Parámetros
cantidad para cambiar el nivel de zoom. Los valores positivos indican un acercamiento a la superficie de la Tierra, mientras que los valores negativos indican que se aleja de ella.
Resultado que se muestra

estático público CameraUpdate zoomIn ()

Muestra un objeto CameraUpdate que se acerca al mapa moviendo la altura del punto de vista más cerca de la superficie de la Tierra. El incremento de zoom es 1.0.

Resultado que se muestra

estático público CameraUpdate zoomOut ()

Muestra un objeto CameraUpdate que aleja el mapa al alejar la altura del punto de vista de la superficie de la Tierra. El incremento de zoom es de -1,0.

Resultado que se muestra

public static CameraUpdate zoomTo (zoom de anuncio flotante)

Muestra 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, en el rango de 2.0 a 21.0. Los valores inferiores a este rango se establecen en 2.0 y los valores superiores se establecen en 21.0. Aumenta el valor para acercar la imagen. No todas las áreas tienen mosaicos en los niveles de zoom más altos.