GroundOverlay

Une superposition au sol est une image fixée sur une carte. Une superposition au sol présente les caractéristiques suivantes : propriétés:

Position

Il existe deux façons de spécifier la position d'une superposition au sol: <ph type="x-smartling-placeholder">

</ph>
• En utilisant un lieu: vous devez fournir une image de la superposition au sol, une LatLng à laquelle l'ancre sera fixe et la largeur de la superposition (en mètres). La l'ancre se trouve par défaut à 50% à partir du haut de l'image et à 50% à partir de la gauche de l'image. Ce paramètre peut être modifié. Vous avez la possibilité d'indiquer la hauteur de la superposition (dans mètres). Si vous n'indiquez pas la hauteur de la superposition, celle-ci sera automatiquement calculé pour conserver les proportions de l'image.
• En utilisant des limites: vous devez fournir un LatLngBounds qui contiendra l'image.

Vous devez spécifier la position de la superposition au sol avant de l'ajouter à la carte. Sinon, une IllegalArgumentException est générée lorsque la superposition au sol est ajouté à la carte. De plus, vous ne devez spécifier la position qu'à l'aide de l'un de ces dans l'objet GroundOverlayOptions. Sinon, une exception IllegalStateException sera générée lors de la spécification à l'aide d'une deuxième méthode.

Image

Image (en tant que BitmapDescriptor) à utiliser pour cette superposition. L'image sera mis à l'échelle pour s'adapter à la position indiquée. Vous devez spécifier une image avant d'ajouter le sol se superposer à la carte ; Si ce n'est pas le cas, une exception IllegalArgumentException est générée ajouté à la carte.

Roulement

Valeur de rotation de l'image dans le sens des aiguilles d'une montre. Le centre de la rotation sera l'ancre de l'image. Cette valeur est facultative et la valeur par défaut est 0, l'image est alignée de sorte que le haut soit le nord.

zIndex

Ordre dans lequel cette superposition au sol est tracée par rapport aux autres superpositions (y compris Polyline et TileOverlay, mais pas Marker). Une superposition avec un zIndex plus grand est dessiné sur des superpositions avec des zIndex plus petits. L'ordre des superpositions même valeur zIndex est arbitraire. Cette valeur est facultative et la valeur par défaut du zIndex est de 0.

Transparence

Transparence de la superposition au sol dans la plage [0..1] où 0 correspond à la superposition est opaque, tandis que 1 signifie qu'elle est totalement transparente. Si les valeurs est déjà partiellement transparent, la transparence de chaque pixel est mise à l'échelle en conséquence (par exemple, si un pixel du bitmap a une valeur alpha de 200 et que vous la transparence de la superposition au sol est définie sur 0,25, le pixel est alors affiché sur l'écran avec une valeur alpha de 150). La spécification de cette propriété est facultative. la transparence par défaut est de 0 (opaque).

Visibilité

Indique si la superposition au sol est visible ou invisible, c'est-à-dire si elle est dessinée sur le sur la carte. Une superposition au sol invisible n'est pas tracée, mais elle conserve toutes ses autres propriétés. Cette option est facultative et la visibilité par défaut est true, c'est-à-dire visible.

Cliquabilité

Si vous souhaitez gérer les événements déclenchés lorsque l'utilisateur clique sur la superposition au sol, définissez ce sur true. Vous pouvez modifier cette valeur à tout moment. La valeur par défaut est false. Si cette propriété est définie sur true, votre application recevra des notifications au GoogleMap.OnGroundOverlayClickListener enregistré jusqu'au setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Tag

Object associé à la superposition au sol. Par exemple, Object peut contenant des données sur ce que représente la superposition au sol. C'est plus facile que de stocker séparer les Map<GroundOverlay, Object>. Autre exemple : vous pouvez associer un ID String correspondant à l'ID d'un ensemble de données. ni du SDK Google Maps pour Android lit ni écrit cette propriété.

Les méthodes de cette classe doivent être appelées sur le thread UI Android. Si ce n'est pas le cas, une erreur IllegalStateException est générée au moment de l'exécution.

Exemple

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));