CameraUpdateFactory

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.
la classe finale publique CameraUpdateFactory étend l'objet

Classe contenant des méthodes de création d'objets CameraUpdate qui modifient la caméra d'une carte. Pour modifier l'appareil photo 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 les 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 le guide du développeur Caméra et vue.

Récapitulatif des méthodes publiques

static CameraUpdate
newCameraPosition(PositionPosition de la caméra)
Renvoie un CameraUpdate qui déplace l'appareil photo vers un CameraPosition spécifié.
static 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.
static CameraUpdate
newLatLngBounds(limites LatLngBounds, largeur entière, hauteur entière, marge intérieure entière)
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 de dimensions spécifiées, avec le plus grand niveau de zoom possible.
static CameraUpdate
newLatLngBounds(limites LatLngBounds, marge intérieure entière)
Renvoie une valeur CameraUpdate qui transforme l'appareil photo de sorte que les limites de latitude et de longitude spécifiées soient centrées sur l'écran au plus haut niveau de zoom possible.
static 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 passe au niveau de zoom spécifié.
static CameraUpdate
scrollBy(xPixel flottant, Flottant yPixel)
Renvoie une valeur CameraUpdate qui fait défiler l'appareil photo sur la carte, en déplaçant le centre de vue selon le nombre de pixels spécifié dans les directions X et Y.
static CameraUpdate
zoomBy(nombre flottant, point focal)
Renvoie une valeur CameraUpdate qui déplace le niveau de zoom du point de vue de la caméra actuelle.
static CameraUpdate
zoomBy(montant flottant)
Renvoie une valeur CameraUpdate qui déplace le niveau de zoom du point de vue de la caméra actuelle.
static CameraUpdate
zoomIn()
Renvoie un CameraUpdate qui zoome sur la carte en rapprochant la hauteur du point de vue de la surface de la Terre.
static 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.
static CameraUpdate
zoomTo(zoom flottant)
Renvoie une valeur CameraUpdate qui déplace le point de vue de la caméra vers un niveau de zoom particulier.

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

Méthodes publiques

public static CameraUpdate newCameraPosition (CameraPosition CameraPosition)

Renvoie un 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 la direction et de l'inclinaison de l'objet CameraPosition.

Paramètres
Position de la caméra
Renvoie

public static 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 est ainsi centrée sur l'objet LatLng.

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

public static CameraUpdate newLatLngBounds (LatLngBounds bounds, int width, int height, int padding)

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 de dimensions spécifiées, avec le plus grand niveau de zoom possible. Vous pouvez spécifier une marge intérieure supplémentaire afin de restreindre davantage la taille du cadre de délimitation. L'élément 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 changer la caméra avant la phase de mise en page, car les arguments spécifient la taille souhaitée du cadre de délimitation.

Paramètres
limites la région à tenir dans la boîte englobante
largeur largeur du cadre de délimitation en pixels (px)
hauteur hauteur du cadre de délimitation en pixels (px)
padding taille maximale du cadre de délimitation (en pixels)
Renvoie

public static CameraUpdate newLatLngBounds (bounds LatLngBounds, marge intérieure intérieure)

Renvoie une valeur CameraUpdate qui transforme l'appareil photo de sorte que les limites de latitude et de 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 pour insérer le cadre englobant à partir des bords de la carte. La valeur CameraUpdate renvoyée a une orientation de 0 et une inclinaison de 0.

Ne modifiez pas la caméra avec cette mise à jour tant que la carte n'a pas été mise en page (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 n'est PAS suffisant que la carte soit disponible. La vue contenant la carte doit également avoir été mise en page pour que ses dimensions aient été déterminées. Si vous ne pouvez pas vous en assurer, utilisez plutôt newLatLngBounds(LatLngBounds, int, int, int) et fournissez les dimensions de la carte manuellement.

Paramètres
limites la taille de la zone
padding espace (en px) 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 static CameraUpdate newLatLngZoom (LatLng latLng, float zoom)

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 passe au niveau de zoom spécifié.

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 pour faire un zoom avant. Toutes les zones ne comportent pas de tuiles aux niveaux de zoom les plus élevés.
Renvoie

public static CameraUpdate scrollBy (float xPixel, float yPixel)

Renvoie une valeur CameraUpdate qui fait défiler l'appareil photo sur la carte, en déplaçant le centre de vue selon le nombre de pixels spécifié dans les directions X et Y.

Exemples :

  • Si xPixel = 5 et yPixel = 0, le système fait défiler la page vers la droite en déplaçant l'appareil photo de sorte que la carte semble avoir décalé de 5 pixels vers la gauche.
  • Si xPixel = 0 et yPixel = 5, le système fait défiler la page en déplaçant l'appareil photo de sorte que la carte semble avoir décalé 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, l'est est orienté vers le haut. Si vous faites défiler la page vers la droite, elle est déplacée vers le sud.

Paramètres
Pixel Nombre de pixels à faire défiler horizontalement. Une valeur positive déplace la caméra 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 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 static CameraUpdate zoomBy (montant flottant, point sélectionné)

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

Un point spécifié par la mise au point restera fixe (c'est-à-dire qu'il correspond aux mêmes coordonnées de latitude et de longitude avant et après le processus de zoom).

Cette méthode est différente de zoomTo(float), dans la mesure où le zoom est relatif à 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 montant de zoom et ce LatLng, l'emplacement d'écran de ce LatLng sera toujours (23, 45).

Paramètres
amount 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 emplacement du pixel à l'écran devant rester fixe après le zoom. Les coordonnées de latitude et de longitude qui se trouvaient à cet emplacement de pixel avant le déplacement de la caméra restent identiques après le déplacement de la caméra.
Renvoie

public static CameraUpdate zoomBy (montant flottant)

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

Cette méthode est différente de zoomTo(float), dans la mesure où le zoom est relatif à la caméra actuelle.

Paramètres
amount 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 static CameraUpdate zoomIn ()

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

Renvoie

public static 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.0.

Renvoie

public static CameraUpdate zoomTo (zoom flottant)

Renvoie une valeur CameraUpdate qui déplace le point de vue de la caméra vers 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 pour faire un zoom avant. Toutes les zones ne comportent pas de tuiles aux niveaux de zoom les plus élevés.