CameraUpdateFactory

public final class CameraUpdateFactory étend l'objet

Une classe contenant des méthodes permettant de créer des objets CameraUpdate qui modifient la caméra d'une carte. Pour modifier la caméra de la carte, appelez animateCamera(CameraUpdate), animateCamera(CameraUpdate, GoogleMap.CancelableCallback) ou moveCamera(CameraUpdate) à l'aide d'un objet CameraUpdate créé avec cette classe.

Par exemple, pour faire un zoom avant sur une carte, vous pouvez utiliser le code suivant :

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

Avant d'utiliser des méthodes de cette classe, vous devez effectuer l'une des opérations suivantes pour vous assurer qu'elle est initialisée:

Guide du développeur

Pour en savoir plus, consultez le guide du développeur Caméra et vue.

Récapitulatif des méthodes publiques

statique CameraUpdate
newCameraPosition(CameraPosition position de la caméra)
Renvoie une CameraUpdate qui déplace l'appareil photo vers un CameraPosition spécifié.
statique CameraUpdate
newLatLng(LatLng latLng)
Renvoie une valeur CameraUpdate qui déplace le centre de l'écran vers une latitude et une longitude spécifiées par un objet LatLng.
statique CameraUpdate
newLatLngBounds(limites de LatLngBounds, largeur int, hauteur int, marge intérieure int)
Renvoie une CameraUpdate qui transforme l'appareil photo de sorte que les limites de latitude/longitude spécifiées soient centrées à l'écran dans un cadre de délimitation aux dimensions spécifiées au plus haut niveau de zoom possible.
statique CameraUpdate
newLatLngBounds(limites de LatLngBounds, marge intérieure int)
Renvoie une CameraUpdate qui transforme la caméra de sorte que les limites de latitude/longitude spécifiées soient centrées sur l'écran au plus haut niveau de zoom possible.
statique CameraUpdate
newLatLngZoom(LatLng LatLng, zoom flottant)
Renvoie une valeur CameraUpdate qui déplace le centre de l'écran vers une latitude et une longitude spécifiées par un objet LatLng, puis qui se déplace vers le niveau de zoom donné.
statique CameraUpdate
scrollBy(float xPixel, float yPixel)
Renvoie un CameraUpdate qui fait défiler la caméra sur la carte, en décalant le centre de vue du nombre de pixels spécifié dans les directions x et y.
statique CameraUpdate
zoomBy(montant flottant, mise au point ponctuel)
Renvoie une CameraUpdate qui décale le niveau de zoom du point de vue actuel de la caméra.
statique CameraUpdate
zoomBy(montant flottant)
Renvoie une CameraUpdate qui décale le niveau de zoom du point de vue actuel de la caméra.
statique CameraUpdate
zoomIn()
Renvoie un CameraUpdate qui fait un zoom avant sur la carte en déplaçant la hauteur du point de vue plus près de la surface de la Terre.
statique CameraUpdate
zoomOut()
Renvoie un CameraUpdate qui effectue un zoom arrière sur la carte en éloignant la hauteur du point de vue de la surface de la Terre.
statique CameraUpdate
zoomTo(zoom flottant)
Renvoie un CameraUpdate qui déplace le point de vue de la caméra à un niveau de zoom particulier.

Récapitulatif des méthodes héritées

Méthodes publiques

public statique CameraUpdate newCameraPosition (CameraPositioncameraPosition)

Renvoie une CameraUpdate qui déplace l'appareil photo vers un CameraPosition spécifié. En effet, cela crée une transformation à partir de la latitude, de la longitude, du niveau de zoom, de l'orientation et de l'inclinaison de l'objet CameraPosition.

Paramètres
cameraPosition
Renvoie

public statique CameraUpdate newLatLng (LatLng latLng)

Renvoie une valeur CameraUpdate qui déplace le centre de l'écran vers une latitude et une longitude spécifiées par un objet LatLng. La caméra sera ainsi centrée sur l'objet LatLng.

Paramètres
latLng Un objet LatLng contenant la latitude et la longitude souhaitées
Renvoie

public statique CameraUpdate newLatLngBounds (limites de LatLngBounds, largeur int, hauteur int, marge intérieure int)

Renvoie une CameraUpdate qui transforme l'appareil photo de sorte que les limites de latitude/longitude spécifiées soient centrées à l'écran dans un cadre de délimitation aux dimensions spécifiées au plus haut niveau de zoom possible. Vous pouvez spécifier une marge intérieure supplémentaire pour restreindre davantage la taille du cadre de délimitation. Le CameraUpdate renvoyé a une orientation de 0 et une inclinaison de 0.

Contrairement à newLatLngBounds(LatLngBounds, int), vous pouvez utiliser le CameraUpdate renvoyé par cette méthode pour modifier la caméra avant la phase de mise en page de la carte, car les arguments spécifient la taille souhaitée du cadre de délimitation.

Paramètres
limites la région à tenir dans le cadre de délimitation
largeur Largeur du cadre de délimitation en pixels (px)
hauteur Hauteur du cadre de délimitation en pixels (px)
padding restriction de taille supplémentaire (en px) du cadre de délimitation
Renvoie

public statique CameraUpdate newLatLngBounds (limites de LatLngBounds, marge intérieure int)

Renvoie une CameraUpdate qui transforme la caméra de sorte que les limites de latitude/longitude spécifiées soient centrées sur l'écran au plus haut niveau de zoom possible. Vous pouvez spécifier une marge intérieure afin d'insérer le cadre de délimitation à partir des bords de la vue plan. Le CameraUpdate renvoyé a une orientation de 0 et une inclinaison de 0.

Ne changez pas la caméra avec cette mise à jour tant que la mise en page de la carte n'a pas été effectuée (pour que cette méthode puisse déterminer correctement le cadre de délimitation et le niveau de zoom appropriés, la carte doit avoir une taille). Sinon, une exception IllegalStateException est générée. Il ne suffit PAS que la carte soit disponible. La vue contenant la carte doit également avoir été mise en page de sorte que ses dimensions aient été déterminées. Si vous ne pouvez pas être sûr que cela s'est produit, utilisez plutôt newLatLngBounds(LatLngBounds, int, int, int) et indiquez les dimensions de la carte manuellement.

Paramètres
limites la taille de la zone à l'écran
padding (en px) à laisser entre les bords du cadre de délimitation et les bords de la vue. Cette valeur est appliquée aux quatre côtés du cadre de délimitation.
Renvoie

public statique CameraUpdate newLatLngZoom (LatLng latLng, zoom flottant)

Renvoie une valeur CameraUpdate qui déplace le centre de l'écran vers une latitude et une longitude spécifiées par un objet LatLng, puis qui se déplace vers le niveau de zoom donné.

Paramètres
latLng Un objet LatLng contenant la latitude et la longitude souhaitées
zoom le niveau de zoom souhaité, compris entre 2 et 21. Les valeurs inférieures à cette plage sont définies sur 2,0, et les valeurs supérieures sont définies sur 21,0. Augmentez la valeur du zoom avant. Toutes les zones ne possèdent pas de tuiles aux niveaux de zoom les plus élevés.
Renvoie

public statique CameraUpdate scrollBy (float xPixel, float yPixel)

Renvoie un CameraUpdate qui fait défiler la caméra sur la carte, en décalant le centre de vue du nombre de pixels spécifié dans les directions x et y.

Exemples :

  • Si xPixel = 5 et yPixel = 0, le système fait un défilement vers la droite en déplaçant l'appareil photo de sorte que la carte semble décalée de 5 pixels vers la gauche.
  • Si xPixel = 0 et yPixel = 5, le système fait défiler l'écran vers le bas en déplaçant l'appareil photo de sorte que la carte semble décalée de 5 pixels vers le haut.

Le défilement est effectué par rapport à l'orientation actuelle de la caméra. Par exemple, si la caméra est orientée à 90 degrés, alors l'est est "haut" et le défilement vers la droite déplacera la caméra vers le sud.

Paramètres
xPixel le nombre de pixels à faire défiler horizontalement. Une valeur positive déplace l'appareil photo vers la droite par rapport à son orientation actuelle. Une valeur négative déplace la caméra vers la gauche par rapport à son orientation actuelle.
yPixel le nombre de pixels à faire défiler verticalement ; Une valeur positive déplace la caméra vers le bas par rapport à son orientation actuelle. Une valeur négative déplace la caméra vers le haut par rapport à son orientation actuelle.
Renvoie

public statique CameraUpdate zoomBy (nombre à virgule flottante, mise au point sur un point)

Renvoie une CameraUpdate qui décale le niveau de zoom du point de vue actuel de la caméra.

Un point spécifié par le focus reste fixe (c'est-à-dire qu'il correspond à la même latitude/longitude avant et après le processus de zoom).

Cette méthode est différente de zoomTo(float) dans le sens où le zoom est effectué par rapport à la caméra actuelle.

Par exemple, si LatLng (11.11, 22.22) se trouve actuellement à l'emplacement de l'écran (23, 45). Après avoir appelé cette méthode avec un zoom et ce LatLng, l'emplacement de l'écran de ce LatLng sera toujours (23, 45).

Paramètres
amount ou une valeur pour modifier le niveau de zoom. Les valeurs positives indiquent un zoom plus proche de la surface de la Terre, tandis que les valeurs négatives indiquent un zoom arrière.
concentration l'emplacement des pixels sur l'écran, qui reste fixe après le processus de zoom. La latitude et la longitude définies à cet emplacement de pixel avant le mouvement de la caméra restent les mêmes après le déplacement de la caméra.
Renvoie

public statique CameraUpdate zoomBy (montant flottant)

Renvoie une CameraUpdate qui décale le niveau de zoom du point de vue actuel de la caméra.

Cette méthode est différente de zoomTo(float) dans le sens où le zoom est effectué par rapport à la caméra actuelle.

Paramètres
amount ou une valeur pour modifier le niveau de zoom. Les valeurs positives indiquent un zoom plus proche de la surface de la Terre, tandis que les valeurs négatives indiquent un zoom arrière.
Renvoie

public statique CameraUpdate zoomIn ()

Renvoie un CameraUpdate qui fait un zoom avant sur la carte en déplaçant la hauteur du point de vue plus près de la surface de la Terre. L'incrément de zoom est de 1.

Renvoie

public statique CameraUpdate zoomOut ()

Renvoie un CameraUpdate qui effectue un zoom arrière sur la carte en éloignant la hauteur du point de vue de la surface de la Terre. L'incrément de zoom est de -1.

Renvoie

public statique CameraUpdate zoomTo (zoom flottant)

Renvoie un CameraUpdate qui déplace le point de vue de la caméra à un niveau de zoom particulier.

Paramètres
zoom le niveau de zoom souhaité, compris entre 2 et 21. Les valeurs inférieures à cette plage sont définies sur 2,0, et les valeurs supérieures sont définies sur 21,0. Augmentez la valeur du zoom avant. Toutes les zones ne possèdent pas de tuiles aux niveaux de zoom les plus élevés.