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 appelerclearTileCache()
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
etPolygon
, mais pasMarker
s). 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]
où0
correspond à la superposition est opaque, tandis que1
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.
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 |
hashCode()
|
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. |
---|