CameraUpdateFactory

la clase final pública CameraUpdateFactory extiende Object

Es 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 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 CameraPosition)
Muestra un CameraUpdate que mueve la cámara a un CameraPosition especificado.
CameraUpdate estática
newLatLng(latLng de 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(límites LatLngBounds, ancho int, altura int, padding 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(límites LatLngBounds, padding 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 con el mayor nivel de zoom posible.
CameraUpdate estática
newLatLngZoom(latLng de 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 hasta el nivel de zoom determinado.
CameraUpdate estática
scrollBy(xPixel flotante, yPixel flotante)
Muestra un objeto CameraUpdate que desplaza la cámara por el mapa y cambia el centro de la vista según la cantidad especificada de píxeles en las direcciones "x" e "y".
CameraUpdate estática
zoomBy(cantidad de punto flotante, enfoque de punto)
Muestra un objeto CameraUpdate que cambia el nivel de zoom del punto de vista actual de la cámara.
CameraUpdate estática
zoomBy(cantidad de punto flotante)
Muestra un objeto CameraUpdate que cambia el nivel de zoom del punto de vista actual de la cámara.
CameraUpdate estática
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.
CameraUpdate estática
zoomOut()
Muestra 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.
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 específico.

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. De hecho, 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
cameraPosition
Devuelve

estática pública 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. De esta manera, se centra la cámara en el objeto LatLng.

Parámetros
latLng Un objeto LatLng que contiene la latitud y la longitud deseadas
Devuelve

público estático CameraUpdate newLatLngBounds (LatLngBounds, ancho int, altura int, padding 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. Puedes especificar padding adicional para restringir aún más el tamaño del cuadro de límite. El 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 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 px) del cuadro de límite
Devuelve

público estático CameraUpdate newLatLngBounds (LatLngBounds, padding 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 con el mayor nivel de zoom posible. Puedes especificar padding para insertar el cuadro delimitador desde los bordes de la vista de mapa. El objeto CameraUpdate que se muestra tiene un rumbo de 0 y una inclinación de 0.

Con esta actualización, no cambies la cámara hasta que se haya diseñado el 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 lo contiene también debe haber tenido un diseño tal que se hayan determinado sus dimensiones. Si no puedes estar seguro de que esto haya ocurrido, utiliza newLatLngBounds(LatLngBounds, int, int, int) en su lugar y proporciona las dimensiones del mapa de forma manual.

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. Este valor se aplica a los cuatro lados del cuadro de límite.
Devuelve

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 hasta el nivel de zoom determinado.

Parámetros
latLng Un objeto LatLng que contiene la latitud y la longitud deseadas
zoom el nivel de zoom deseado, en el rango de 2,0 a 21,0. Los valores por debajo de este rango se establecen en 2.0 y los valores superiores a este 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.
Devuelve

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

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

Ejemplos:

  • Si xPixel = 5 e yPixel = 0, el sistema se desplaza hacia la derecha moviendo la cámara de modo que el mapa parezca desplazarse 5 píxeles hacia la izquierda.
  • Si xPixel = 0 y yPixel = 5, el sistema se desplaza hacia abajo moviendo la cámara de modo 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 se orienta a 90 grados, el este es "arriba" y el desplazamiento hacia la derecha moverá la cámara hacia el sur.

Parámetros
xPixel la cantidad de píxeles para desplazarse 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.
yPixel el número de píxeles para desplazarse 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.
Devuelve

estática pública CameraUpdate zoomBy (cantidad flotante, enfoque de punto)

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

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

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

Por ejemplo, si LatLng (11.11, 22.22) está actualmente en la ubicación de la pantalla (23, 45). Después de llamar a este método con una cantidad de zoom y este 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 más a la superficie de la Tierra, mientras que los valores negativos indican que la superficie se aleja de la Tierra.
enfoque la ubicación de píxeles en la pantalla que permanecerá fija después del proceso de zoom. La latitud y longitud que se encontraba en esa ubicación de píxeles antes del movimiento de la cámara permanecerán iguales después de este movimiento.
Devuelve

público estático CameraUpdate zoomBy (cantidad 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 a la cámara actual.

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

público estático 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 de 1.0.

Devuelve

estática pública CameraUpdate zoomOut ()

Muestra 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 de zoom es de -1.0.

Devuelve

público estático CameraUpdate zoomTo (zoom flotante)

Muestra un objeto CameraUpdate que mueve el punto de vista de la cámara a un nivel de zoom específico.

Parámetros
zoom el nivel de zoom deseado, en el rango de 2,0 a 21,0. Los valores por debajo de este rango se establecen en 2.0 y los valores superiores a este 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.