CameraUpdateFactory

public final class CameraUpdateFactory étend l'objet

Classe contenant des méthodes permettant de créer des objets CameraUpdate qui modifient l'appareil photo 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 l'une des méthodes de cette classe, vous devez effectuer l'une des opérations suivantes pour vous assurer que cette classe est initialisée:

Guide du développeur

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

Récapitulatif des méthodes publiques

statique CameraUpdate
newCameraPosition(CameraPosition cameraPosition)
Renvoie un CameraUpdate qui déplace la caméra vers un CameraPosition spécifié.
statique CameraUpdate
newLatLng(LatLng latLng)
Renvoie une CameraUpdate qui déplace le centre de l'écran vers une latitude et une longitude. spécifiée par un objet LatLng.
statique CameraUpdate
newLatLngBounds(limites de LatLngBounds, largeur et hauteur entières, marge intérieure de type entier)
Renvoie un CameraUpdate qui transforme l'appareil photo de sorte que la valeur spécifiée les limites de latitude/longitude sont centrées sur l'écran dans un cadre de délimitation des dimensions spécifiées au plus haut niveau de zoom possible.
statique CameraUpdate
newLatLngBounds(limites de LatLngBounds, marge intérieure de l'entier)
Renvoie un CameraUpdate qui transforme l'appareil photo de sorte que la valeur spécifiée les limites de latitude/longitude sont centrées sur l'écran au plus haut niveau de zoom possible.
statique CameraUpdate
newLatLngZoom(LatLng latLng, zoom flottant)
Renvoie une CameraUpdate qui déplace le centre de l'écran vers une latitude et une longitude. spécifiée par un objet LatLng et se déplace au 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 selon le nombre de pixels spécifié dans les directions x et y.
statique CameraUpdate
zoomBy(valeur flottante, focus)
Renvoie une valeur CameraUpdate qui déplace le niveau de zoom du point de vue actuel de la caméra.
statique CameraUpdate
zoomBy(valeur flottante)
Renvoie une valeur CameraUpdate qui déplace le niveau de zoom du point de vue actuel de la caméra.
statique CameraUpdate
zoomIn()
Renvoie un CameraUpdate qui effectue un zoom avant sur la carte en rapprochant la hauteur du point de vue à la surface de la Terre.
statique CameraUpdate
zoomOut()
Renvoie un CameraUpdate qui effectue un zoom arrière sur la carte en déplaçant la hauteur du point de vue. plus loin de la surface de la Terre.
statique CameraUpdate
zoomTo(zoom flottant)
Renvoie une valeur 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

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate newCameraPosition (CameraPosition cameraPosition) :

Renvoie un CameraUpdate qui déplace la caméra vers un CameraPosition spécifié. Dans crée une transformation à partir de la latitude de l'objet CameraPosition, la longitude, le niveau de zoom, l'orientation et l'inclinaison.

Paramètres
cameraPosition
Renvoie

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate newLatLng (LatLng latLng)

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

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

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate newLatLngBounds (LatLngBounds, largeur int, hauteur int, marge intérieure int)

Renvoie un CameraUpdate qui transforme l'appareil photo de sorte que la valeur spécifiée les limites de latitude/longitude sont centrées sur l'écran dans un cadre de délimitation des dimensions spécifiées au plus haut niveau de zoom possible. Vous pouvez spécifier une marge intérieure supplémentaire la taille du cadre de délimitation. L'élément CameraUpdate renvoyé a une direction de 0 et une inclinaison. de 0.

Contrairement à newLatLngBounds(LatLngBounds, int), vous pouvez utiliser CameraUpdate renvoyé par cette méthode pour modifier l'appareil photo avant la phase de mise en page de la carte, car le 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

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate newLatLngBounds (limitesLatLngBounds, marge intérieure de l'entier)

Renvoie un CameraUpdate qui transforme l'appareil photo de sorte que la valeur spécifiée les limites de latitude/longitude sont centrées sur l'écran au plus haut niveau de zoom possible. Vous pouvez spécifier une marge intérieure afin d'écarter le cadre de délimitation des bords de la vue de carte. La valeur renvoyée CameraUpdate a une direction de 0 et une inclinaison de 0.

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

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

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate newLatLngZoom (LatLng latLng, zoom flottant)

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

Paramètres
latLng Un objet LatLng contenant la latitude et la longitude souhaitées
zoom au niveau de zoom souhaité, compris entre 2 et 21. Les valeurs inférieures à cette plage sont définie sur 2.0 et les valeurs supérieures sont définies sur 21.0. Augmentez la valeur pour faire un zoom avant. Il est possible que zones comportent des tuiles aux plus grands niveaux de zoom.
Renvoie

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate scrollBy (float xPixel, yPixel flottant)

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

Exemples :

  • Si xPixel = 5 et yPixel = 0, le système défile vers la droite en déplaçant l'appareil photo de sorte que semble avoir décalé de 5 pixels vers la gauche.
  • Si xPixel = 0 et yPixel = 5, le système défile vers le bas en déplaçant l'appareil photo de sorte que la carte semble avoir été 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 orientée à 90 degrés, alors l'est est "en haut" et faites défiler l'écran vers la droite pour déplacer la caméra vers le sud.

Paramètres
xPixel le nombre de pixels à faire défiler horizontalement. Une valeur positive déplace la caméra 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

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate zoomBy (valeur flottante, focus point)

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

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

Cette méthode est différente de zoomTo(float) dans la mesure où le zoom est relatif au niveau actuel caméra.

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 niveau de zoom et ce LatLng, la position de l'écran de LatLng seront toujours (23, 45).

Paramètres
amount pour modifier le niveau de zoom. Les valeurs positives indiquent un zoom qui se rapproche de la la surface de la Terre, tandis que les valeurs négatives indiquent que l'on s'éloigne de la surface Terre.
concentration position des pixels sur l'écran qui doit rester fixe après le processus de zoom. Les coordonnées de latitude et de longitude qui se trouvaient à cet emplacement en pixels avant le déplacement de la caméra restent identiques après le déplacement de la caméra.
Renvoie

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate zoomBy (nombre flottant)

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

Cette méthode est différente de zoomTo(float) dans la mesure où le zoom est relatif au niveau actuel caméra.

Paramètres
amount pour modifier le niveau de zoom. Les valeurs positives indiquent un zoom qui se rapproche de la la surface de la Terre, tandis que les valeurs négatives indiquent que l'on s'éloigne de la surface Terre.
Renvoie

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate zoomIn ()

Renvoie un CameraUpdate qui effectue un zoom avant sur la carte en rapprochant la hauteur du point de vue à la surface de la Terre. L'incrément de zoom est de 1.

Renvoie

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate zoomOut ()

Renvoie un CameraUpdate qui effectue un zoom arrière sur la carte en déplaçant la hauteur du point de vue. plus loin de la surface de la Terre. L'incrément de zoom est de -1,0.

Renvoie

<ph type="x-smartling-placeholder"></ph> public statique CameraUpdate zoomTo (zoom flottant)

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

Paramètres
zoom au niveau de zoom souhaité, compris entre 2 et 21. Les valeurs inférieures à cette plage sont définie sur 2.0 et les valeurs supérieures sont définies sur 21.0. Augmentez la valeur pour faire un zoom avant. Il est possible que zones comportent des tuiles aux plus grands niveaux de zoom.