TileOverlay

public final class TileOverlay étend l'objet

Une superposition de tuiles est un ensemble d'images qui sont affichées au-dessus des tuiles de la carte de base. Ces vignettes peuvent être transparentes, ce qui vous permet d'ajouter des éléments géographiques à des cartes existantes. Une superposition de tuiles a la les propriétés suivantes:

Fournisseur de tuiles
TileProvider fournit les images utilisées dans la superposition de tuiles. Vous devez spécifier le fournisseur de tuiles avant de l'ajouter à la carte. Le fournisseur de cartes ne peut pas être modifiées après l'ajout. Toutefois, vous pouvez modifier le comportement du fournisseur de cartes afin d'obtenir des images différentes pour des coordonnées spécifiques. Si les tuiles fournies par la vignette de fournisseur, vous devez appeler clearTileCache() par la suite pour vous assurer que les tuiles précédentes ne s'affichent plus.
z-index
Ordre dans lequel cette superposition de tuiles est tracée par rapport aux autres superpositions (y compris GroundOverlay, Circle, Polyline et Polygon, mais pas Markers). Une superposition avec un z-index plus grand s'affiche sur des superpositions dont la taille est plus petite z-indices. L'ordre des superpositions ayant le même z-index est arbitraire. Le zIndex par défaut est 0.
Transparence
Transparence de la superposition de tuiles dans la plage [0..1]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 de tuiles doit être de 0,25, alors le pixel sera rendu 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 de tuiles est visible ou invisible, c'est-à-dire si elle est dessinée sur la sur la carte. Une superposition de tuiles invisible n'est pas dessinée, mais conserve toutes ses autres propriétés. La la valeur par défaut est true, c'est-à-dire visible.

Vous ne devez appeler les méthodes de cette classe que sur le thread principal. Dans le cas contraire, un IllegalStateException.

Coordonnées de tuile

Notez que le monde est projeté à l'aide de la projection de Mercator (voir Wikipédia), avec le côté gauche (ouest). de la carte correspondant à -180 degrés de longitude et du côté droit (est) de la carte correspondant à 180 degrés de longitude. Pour que la carte soit carrée, le côté supérieur (nord) de la la carte correspond à 85,0511 degrés de latitude et le côté inférieur (sud) de la carte correspond à -85,0511 degrés de latitude. Les zones situées en dehors de cette plage de latitudes ne sont pas affichées.

À chaque niveau de zoom, la carte est divisée en tuiles, seules celles qui chevauchent l'écran sont téléchargés et affichés. Chaque tuile est carrée et la carte est divisée en tuiles comme suit:

  • Au niveau de zoom 0, une tuile représente le monde entier. Les coordonnées de cette tuile sont (x, y) = (0, 0).
  • À un niveau de zoom 1, le monde est divisé en 4 tuiles disposées dans une grille de 2 x 2.
  • À un niveau de zoom N, le monde est divisé en 4N tuiles disposées en 2N x grille N.
Notez que le niveau de zoom minimal accepté par la caméra (qui peut dépendre de plusieurs facteurs) est GoogleMap.getMinZoomLevel et le niveau de zoom maximal est GoogleMap.getMaxZoomLevel.

Les coordonnées des tuiles sont mesurées à partir de l'angle supérieur gauche (nord-ouest) de la carte. À niveau de zoom N, les valeurs x des coordonnées de tuile sont comprises entre 0 et 2N - 1 et augmenter d'ouest en est et les valeurs y sont comprises entre 0 et 2.N - 1 et augmenter du nord au sud.

Exemple

GoogleMap map; // ... get a map.
 TileProvider tileProvider; // ... create a tile provider.
 TileOverlay tileOverlay = map.addTileOverlay(
     new TileOverlayOptions().tileProvider(tileProvider));
 

Récapitulatif des méthodes publiques

vide
clearTileCache()
Vide le cache des cartes afin que toutes les cartes soient à nouveau demandées à partir de TileProvider.
booléen
equals(autre objet)
Vérifie si cette TileOverlay est égale à une autre.
booléen
getFadeIn()
Détermine si les tuiles de superposition doivent apparaître en fondu.
Chaîne
getId()
Récupère l'identifiant de cette superposition de tuiles.
float
getTransparency()
Récupère la transparence de cette superposition de tuiles.
float
getZIndex()
Récupère le zIndex de cette superposition de tuiles.
int
booléen
isVisible()
Récupère la visibilité de cette superposition de tuiles.
vide
remove()
Supprime cette superposition de tuiles de la carte.
vide
setFadeIn(boolean fadeIn)
Détermine si les tuiles de superposition doivent apparaître en fondu.
vide
setTransparency(transparence flottante)
Définit la transparence de cette superposition de tuiles.
vide
setVisible(boolean visible)
Définit la visibilité de cette superposition de tuiles.
vide
setZIndex(float zIndex)
Définit le zIndex de cette superposition de tuiles.

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

Méthodes publiques

<ph type="x-smartling-placeholder"></ph> public vide clearTileCache ()

Vide le cache des cartes afin que toutes les cartes soient à nouveau demandées à partir de TileProvider. Les tuiles actuelles de cette superposition de tuiles seront également effacées de la carte après avoir appelé cette . L'API gère un petit cache en mémoire de cartes. Si vous souhaitez mettre en cache des vignettes pour plus longtemps, vous devez mettre en œuvre un cache sur le disque.

<ph type="x-smartling-placeholder"></ph> public Booléen est égal(e) à (autre objet)

Vérifie si cette TileOverlay est égale à une autre.

Paramètres
autre un Object.
Renvoie
  • "true" si les deux objets sont le même objet, c'est-à-dire "== other".

<ph type="x-smartling-placeholder"></ph> public Booléen getFadeIn ()

Détermine si les tuiles de superposition doivent apparaître en fondu.

Renvoie
  • true si les tuiles doivent apparaître en fondu ; false si ce n'est pas le cas.

<ph type="x-smartling-placeholder"></ph> public Chaîne getId ()

Récupère l'identifiant de cette superposition de tuiles.

<ph type="x-smartling-placeholder"></ph> public se superposer getTransparency ()

Récupère la transparence de cette superposition de tuiles.

Renvoie
  • la transparence de cette superposition de tuiles.

<ph type="x-smartling-placeholder"></ph> public se superposer getZIndex ()

Récupère le zIndex de cette superposition de tuiles.

Renvoie
  • le zIndex de la superposition de tuiles.

<ph type="x-smartling-placeholder"></ph> public entier hashCode ()

<ph type="x-smartling-placeholder"></ph> public Booléen isVisible ()

Récupère la visibilité de cette superposition de tuiles. Notez que cette méthode n'indique pas si la carte la superposition se trouve dans la fenêtre d'affichage de l'écran, mais indique si elle s'affiche ou non contenue dans la fenêtre d'affichage de l'écran.

Renvoie
  • la visibilité de cette superposition de tuiles.

<ph type="x-smartling-placeholder"></ph> public vide supprimer ()

Supprime cette superposition de tuiles de la carte.

<ph type="x-smartling-placeholder"></ph> public vide setFadeIn (effet de fondu booléen)

Détermine si les tuiles de superposition doivent apparaître en fondu.

Paramètres
fadeIn true pour faire apparaître les tuiles en fondu ; false pour les afficher instantanément.

<ph type="x-smartling-placeholder"></ph> public vide setTransparency (transparence flottante)

Définit la transparence de cette superposition de tuiles. Consultez la documentation en haut de ce cours pour en savoir plus plus d'informations.

Paramètres
transparence Valeur flottante dans la plage [0..1], où 0 signifie que la tuile la superposition est opaque et 1 signifie qu'elle est transparente.

<ph type="x-smartling-placeholder"></ph> public vide setVisible (valeur booléenne visible)

Définit la visibilité de cette superposition de tuiles. Lorsqu'elle n'est pas visible, la superposition de tuiles n'est pas tracée, conserve toutes ses autres propriétés. Les superpositions de tuiles sont visibles par défaut.

Paramètres
visible true pour rendre cette superposition visible ; false pour la rendre invisible.

<ph type="x-smartling-placeholder"></ph> public vide setZIndex (float zIndex)

Définit le zIndex de cette superposition de tuiles. Pour en savoir plus, consultez la documentation en haut de ce cours. des informations.

Paramètres
zIndex le zIndex de cette superposition de tuiles.