GroundOverlay

la classe finale publique GroundOverlay étend les objets

Une superposition au sol est une image fixée sur une carte. Une superposition au sol possède les propriétés suivantes:

Position
Il existe deux façons de spécifier la position de la superposition au sol :
  • À l'aide d'un emplacement: vous devez fournir une image de la superposition au sol, un élément LatLng auquel l'ancre sera fixée et la largeur de la superposition (en mètres). Par défaut, l'ancre se situe à 50% du haut de l'image et à 50% du bord gauche de l'image. Vous pouvez modifier ce paramètre. Vous pouvez éventuellement fournir la hauteur de la superposition (en mètres). Si vous n'indiquez pas la hauteur de la superposition, elle sera automatiquement calculée pour conserver les proportions de l'image.
  • À l'aide de 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. Dans le cas contraire, une IllegalArgumentException est générée lorsque la superposition au sol est ajoutée à la carte. De plus, vous ne devez spécifier la position qu'à l'aide de l'une de ces méthodes dans l'objet GroundOverlayOptions. Sinon, IllegalStateException est renvoyé lorsque vous spécifiez une deuxième méthode.
Images
Image (en tant que BitmapDescriptor) à utiliser pour cette superposition. L'image est mise à l'échelle pour s'adapter à la position fournie. Vous devez spécifier une image avant d'ajouter la superposition au sol à la carte. Si ce n'est pas le cas, une erreur IllegalArgumentException est renvoyée lors de l'ajout à la carte.
Orientation
Nombre de rotations 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 l'orientation par défaut est de 0. l'image est alignée vers le haut.
z-index
Ordre dans lequel cette superposition au sol est dessinée par rapport aux autres superpositions (y compris les Polyline et les TileOverlay, mais pas les Marker). Une superposition avec un zIndex plus grand est dessinée sur les superpositions avec un zIndex plus petit. L'ordre des superpositions ayant la même valeur zIndex est arbitraire. Cette valeur est facultative et la valeur par défaut de la propriété zIndex est 0.
Transparence
Transparence de la superposition au sol dans la plage [0..1], où 0 signifie que la superposition est opaque et 1 signifie que la superposition est entièrement transparente. Si le bitmap spécifié est déjà partiellement transparent, la transparence de chaque pixel est mise à l'échelle en conséquence.Par exemple, si un pixel du bitmap présente une valeur alpha de 200 et que vous spécifiez la transparence de la superposition au sol comme étant égale à 0,25, le pixel est affiché à l'écran avec une valeur alpha de 150. La spécification de cette propriété est facultative et 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 la carte. Une superposition au sol invisible n'est pas tracée, mais conserve toutes ses autres propriétés. Ce paramètre est facultatif et la visibilité par défaut est true.
Clicabilité
Si vous souhaitez gérer les événements déclenchés lorsque l'utilisateur clique sur la superposition au sol, définissez cette propriété 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 pour le GoogleMap.OnGroundOverlayClickListener enregistré via setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).
Tag
Object associé à la superposition au sol. Par exemple, Object peut contenir des données sur ce que la superposition au sol représente. C'est plus facile que de stocker un Map<GroundOverlay, Object> distinct. Vous pouvez également associer un ID String correspondant à l'ID d'un ensemble de données. Le SDK Google Maps pour Android ne lit ni n'écrit cette propriété.

Les méthodes de cette classe doivent être appelées sur le thread UI Android. Sinon, 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));
 

Récapitulatif des méthodes publiques

booléen
est égal(e) à(Objet autre)
Teste si GroundOverlay est égal à un autre.
float (nombre à virgule flottante)
getBearing
Récupère l'orientation de la superposition au sol en degrés dans le sens des aiguilles d'une montre, à partir du nord.
LatLngBounds
getBounds()
Récupère les limites de la superposition au sol.
float (nombre à virgule flottante)
getHeight
Récupère la hauteur de la superposition au sol.
String
getId
Récupère l'identifiant de cette superposition au sol.
LatLng
getPosition
Récupère l'emplacement du point d'ancrage.
Objet
getTag
Récupère le tag du cercle.
float (nombre à virgule flottante)
getTransparency()
Récupère la transparence de cette superposition au sol.
float (nombre à virgule flottante)
getWidth
Récupère la largeur de la superposition au sol.
float (nombre à virgule flottante)
getZIndex
Récupère le zIndex de cette superposition au sol.
int
booléen
isClickable()
Récupère la cliquabilité de la superposition au sol.
booléen
isVisible()
Récupère la visibilité de cette superposition au sol.
void
remove
Supprime cette superposition au sol de la carte.
void
setBearing (roulement flottant)
Définit la direction de la superposition au sol (sens de direction de l'axe vertical de la superposition au sol) en degrés dans le sens des aiguilles d'une montre à partir du nord.
void
setClickable(valeur cliquable cliquable)
Définit la cliquabilité de la superposition au sol.
void
setDimensions(largeur flottante, hauteur flottante)
Définit les dimensions de la superposition au sol.
void
setDimensions (largeur flottante)
Définit la largeur de la superposition au sol.
void
setImage(BitmapDescriptor imageDescriptor)
Définit l'image pour la superposition au sol.
void
setPosition(LatLng latLng)
Définit la position de la superposition au sol en modifiant l'emplacement du point d'ancrage.
void
setPositionFromBounds(limites de LatLngBounds)
Définit la position de la superposition au sol en l'ajustant à la LatLngBounds donnée.
void
setTag (tag d'objet)
Définit le tag de la superposition au sol.
void
setTransparency(transparence flottante)
Définit la transparence de cette superposition au sol.
void
setVisible(valeur booléenne visible)
Définit la visibilité de cette superposition au sol.
void
setZIndex(zIndex flottant)
Définit le zIndex de cette superposition au sol.

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

Méthodes publiques

public boolean est égal à (Object other)

Teste si GroundOverlay est égal à un autre.

Paramètres
other un Object.
Renvoie
  • Valeur "true" si les deux objets sont le même objet, autrement dit, == other.

float public getBearing ()

Récupère l'orientation de la superposition au sol en degrés dans le sens des aiguilles d'une montre, à partir du nord.

Renvoie
  • l'orientation de la superposition au sol.

public LatLngBounds getBounds ()

Récupère les limites de la superposition au sol. Cela permet d'ignorer la rotation de la superposition au sol.

Renvoie
  • Une LatLngBounds qui contient la superposition au sol et ignore la rotation

float public getHeight ()

Récupère la hauteur de la superposition au sol.

Renvoie
  • Hauteur de la superposition au sol en mètres.

public String getId ()

Récupère l'identifiant de cette superposition au sol. L'identifiant sera unique parmi toutes les superpositions au sol sur une carte.

Renvoie
  • ID de cette superposition au sol.

public LatLng getPosition ()

Récupère l'emplacement du point d'ancrage.

Renvoie
  • position sur la carte (un LatLng).

public Object getTag ()

Récupère le tag du cercle.

Renvoie
  • le tag si un tag a été défini avec setTag ; null si aucun tag n'a été défini.

public floatgetTransparency()

Récupère la transparence de cette superposition au sol.

Renvoie
  • la transparence de cette superposition au sol.

float public getWidth ()

Récupère la largeur de la superposition au sol.

Renvoie
  • largeur, en mètres, de la superposition au sol.

float public getZIndex ()

Récupère le zIndex de cette superposition au sol.

Renvoie
  • zIndex de la superposition au sol.

public inthashCode()

public boolean isClickable ()

Récupère la cliquabilité de la superposition au sol. Si la superposition au sol est cliquable, votre application reçoit des notifications pour GoogleMap.OnGroundOverlayClickListener lorsque l'utilisateur clique sur la superposition au sol. L'écouteur d'événements est enregistré via setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Renvoie
  • true si la superposition au sol est cliquable. Sinon, renvoie false.

public boolean isVisible ()

Récupère la visibilité de cette superposition au sol. Notez que cette propriété ne renvoie pas si la superposition au sol est réellement affichée à l'écran, mais s'elle est dessinée si elle est contenue dans la fenêtre d'affichage de la caméra.

Renvoie
  • la visibilité de cette superposition au sol.

public void supprimer ()

Supprime cette superposition au sol de la carte. Une fois la superposition au sol supprimée, le comportement de toutes ses méthodes n'est pas défini.

public void setBearing (direction flottante)

Définit la direction de la superposition au sol (sens de direction de l'axe vertical de la superposition au sol) en degrés dans le sens des aiguilles d'une montre à partir du nord. La rotation est effectuée sur le point d'ancrage.

Paramètres
orientation orientation en degrés dans le sens horaire à partir du nord

public voidsetClickable(booléen cliquable)

Définit la cliquabilité de la superposition au sol. Si la superposition au sol est cliquable, votre application reçoit des notifications pour GoogleMap.OnGroundOverlayClickListener lorsque l'utilisateur clique sur la superposition au sol. L'écouteur d'événements est enregistré via setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Paramètres
Vous pouvez appuyer. Nouveau paramètre de cliquabilité pour la superposition au sol.

public void setDimensions (largeur flottante, hauteur flottante)

Définit les dimensions de la superposition au sol. L'image sera étirée pour s'adapter aux dimensions.

Paramètres
largeur largeur en mètres
hauteur hauteur en mètres

public void setDimensions (largeur flottante)

Définit la largeur de la superposition au sol. La hauteur de la superposition au sol sera adaptée en conséquence afin de conserver les proportions.

Paramètres
largeur largeur en mètres

public void setImage (BitmapDescriptor imageDescriptor)

Définit l'image pour la superposition au sol. La nouvelle image occupera les mêmes limites que l'ancienne.

Paramètres
imageDescriptor Le BitmapDescriptor à utiliser pour cette superposition au sol.

public void setPosition (LatLng latLng)

Définit la position de la superposition au sol en modifiant l'emplacement du point d'ancrage. Conserve toutes les autres propriétés de l'image.

Paramètres
latLng Un LatLng, c'est-à-dire le nouvel emplacement où placer le point d'ancrage

public void setPositionFromBounds (LatLngBounds limites)

Définit la position de la superposition au sol en l'ajustant à la LatLngBounds donnée. Cette méthode ignore la rotation (roulement) de la superposition au sol lors du positionnement, mais l'orientation est toujours utilisée lors du tracé.

Paramètres
limites Un élément LatLngBounds dans lequel placer la superposition au sol

public void setTag (tag d'objet)

Définit le tag de la superposition au sol.

Vous pouvez utiliser cette propriété pour associer un Object arbitraire à cette superposition au sol. Par exemple, Object peut contenir des données sur ce que la superposition au sol représente. Cette méthode est plus facile que de stocker un Map<GroundOverlay, Object> distinct. Vous pouvez également associer un ID String correspondant à l'ID d'un ensemble de données. Le SDK Google Maps pour Android ne lit ni n'écrit cette propriété. Vous devez appeler setTag(null) pour supprimer le tag lorsque vous n'en avez plus besoin, afin d'éviter les fuites de mémoire dans votre application.

Paramètres
tag Si la valeur est "null", le tag est effacé.

public void setTransparency (transparence flottante)

Définit la transparence de cette superposition au sol. Pour en savoir plus, consultez la documentation située en haut de ce cours.

Paramètres
transparence Une valeur flottante comprise dans la plage [0..1], où 0 signifie que la superposition au sol est opaque et 1 signifie que la superposition au sol est transparente.

public void setVisible (valeur booléenne visible)

Définit la visibilité de cette superposition au sol. Lorsqu'elle n'est pas visible, la superposition au sol n'est pas dessinée, mais elle conserve toutes ses autres propriétés.

Paramètres
visible Si la valeur est true, la superposition au sol est visible. Si la valeur est false, elle n'est pas

public void setZIndex (float zIndex)

Définit le zIndex de cette superposition au sol. Pour en savoir plus, consultez la documentation située en haut de ce cours.

Paramètres
z-index zIndex de cette superposition au sol