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:
- Espera a que un
GoogleMap
esté disponible en unMapFragment
oMapView
que hayas agregado a tu aplicación. Puedes obtener la instanciaGoogleMap
llamando agetMapAsync()
y esperando la devolución de llamadaonMapReady(GoogleMap map)
. - Llamar a
initialize(Context)
Siempre que no se arroje unaGooglePlayServicesNotAvailableException
, esta clase se inicializará de forma correcta.
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
- una
CameraUpdate
que contiene la transformación.
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
- una
CameraUpdate
que contiene la transformación.
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
- una
CameraUpdate
que contiene la transformación.
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
- una
CameraUpdate
que contiene la transformación.
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
- una
CameraUpdate
que contiene la transformación.
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
- una
CameraUpdate
que contiene la transformación.
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
- una
CameraUpdate
que contiene la transformación.
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
- una
CameraUpdate
que contiene la transformación.
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
- una
CameraUpdate
que contiene la transformación.
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
- una
CameraUpdate
que contiene la transformación.
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. |
---|