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.
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'objetGroundOverlayOptions
. Sinon,IllegalStateException
est renvoyé lorsque vous spécifiez une deuxième méthode. - À l'aide d'un emplacement: vous devez fournir une image de la superposition au sol, un élément
- 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 erreurIllegalArgumentException
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 lesTileOverlay
, mais pas lesMarker
). 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 et1
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 estfalse
. Si cette propriété est définie surtrue
, votre application recevra des notifications pour leGoogleMap.OnGroundOverlayClickListener
enregistré viasetOnGroundOverlayClickListener(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 unMap<GroundOverlay, Object>
distinct. Vous pouvez également associer un IDString
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 | |
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, renvoiefalse
.
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 |
---|