TileOverlay

public final class TileOverlay erweitert Objekt

Ein Kachel-Overlay ist ein Satz von Bildern, die über den Kacheln der Basiskarte angezeigt werden. Diese Kacheln kann transparent sein, sodass Sie Elemente zu vorhandenen Karten hinzufügen können. Ein Kachel-Overlay hat die folgenden Properties:

Tile-Anbieter
TileProvider stellt die Bilder bereit, die im Kachel-Overlay verwendet werden. Du musst den Kachelanbieter angeben, bevor er der Karte hinzugefügt wird. Der Anbieter der Kacheln darf nicht geändert, nachdem es hinzugefügt wurde. Sie können jedoch das Verhalten des Kachel-Anbieters ändern, , um für bestimmte Koordinaten unterschiedliche Bilder zurückzugeben. Wenn die von der Kachel bereitgestellten Kacheln müssen Sie anschließend clearTileCache() aufrufen, um sicherzustellen, vorherigen Kacheln werden nicht mehr gerendert.
Z-Index
Die Reihenfolge, in der dieses Kachel-Overlay im Verhältnis zu anderen Overlays gezeichnet wird (einschließlich GroundOverlay s, Circle s, Polyline s und Polygon s, aber nicht Markers). Ein Overlay mit einem größeren Z-Index wird über Overlays mit kleineren z-Indizes. Die Reihenfolge von Überlagerungen mit identischen z-Indizes ist beliebig. Der Standard-zIndex ist 0.
Transparenz
Transparenz des Kachel-Overlays im Bereich [0..1], wobei 0 für Das Overlay ist undurchsichtig und 1 bedeutet, dass es vollständig transparent ist. Wenn die angegebene Bitmap bereits teilweise transparent ist, wird die Transparenz jedes Pixels skaliert. entsprechend (z. B. wenn ein Pixel in der Bitmap einen Alphawert von 200 hat und Sie legen Sie als Transparenz des Kachel-Overlays 0,25 fest, dann wird das Pixel auf Bildschirm mit einem Alphawert von 150). Die Angabe dieser Eigenschaft ist optional und der Die Transparenz ist standardmäßig 0 (undurchsichtig).
Sichtbarkeit
Gibt an, ob das Kachel-Overlay sichtbar oder unsichtbar ist, d.h., ob es auf dem Ein unsichtbares Kachel-Overlay wird nicht gezeichnet, behält aber alle anderen Eigenschaften bei. Die Der Standardwert ist true, d.h. sichtbar.

Sie dürfen in dieser Klasse nur Methoden im Hauptthread aufrufen. Andernfalls erhalten Sie ein IllegalStateException.

Kachelkoordinaten

Beachten Sie, dass die Welt mithilfe der Mercator-Projektion (siehe Wikipedia) mit der linken Seite (Westseite) prognostiziert wird. der Karte, die dem Längengrad -180 Grad und der rechten (Osten) Seite der Karte entspricht entspricht 180 Längengraden. Damit die Karte quadratisch wird, muss die obere (Nördliche) Seite des Karte entspricht 85,0511 Breitengrad und die untere (Südseite) der Karte entspricht bis -85,0511 Breitengrade fest. Gebiete außerhalb dieses Breitengradbereichs werden nicht gerendert.

Bei jeder Zoomstufe wird die Karte in Kacheln unterteilt, wobei nur die Kacheln den Bildschirm überlappen. heruntergeladen und gerendert werden. Jede Kachel ist quadratisch und die Karte ist wie folgt in Kacheln unterteilt:

  • Bei Zoomstufe 0 stellt eine Kachel die gesamte Welt dar. Die Koordinaten dieser Kachel sind (x, y) = (0, 0).
  • Bei Zoomstufe 1 ist die Welt in 4 Kacheln unterteilt, die in einem Raster von 2 x 2 angeordnet sind.
  • …
  • Bei Zoomstufe N ist die Welt in 4N Kacheln unterteilt, die in einem 2N x 2N-Raster
Beachte, dass die minimale Zoomstufe, die von der Kamera unterstützt wird, abhängig von verschiedenen Faktoren ist. ist GoogleMap.getMinZoomLevel und ist die maximale Zoomstufe GoogleMap.getMaxZoomLevel.

Die Koordinaten der Kacheln werden von der oberen linken, nordwestlichen Ecke der Karte aus gemessen. Bei Zoomstufe N haben, liegen die x-Werte der Kachelkoordinaten zwischen 0 und 2N-1 und erhöht sich von Westen nach Osten und die y-Werte reichen von 0 bis 2N - 1 und von Norden nach Süden zunehmen.

Beispiel

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

Public Method Summary

void
clearTileCache()
Löscht den Kachel-Cache, sodass alle Kacheln noch einmal vom TileProvider angefordert werden.
boolean
ist gleich(anderes Objekt)
Prüft, ob dieser TileOverlay gleich einer anderen ist.
boolean
getFadeIn()
Ruft ab, ob die Overlay-Kacheln eingeblendet werden sollen.
String
getId()
Ruft die ID dieses Kachel-Overlays ab.
float
getTransparency()
Ruft die Transparenz dieses Kachel-Overlays ab.
float
getZIndex()
Ruft den zIndex dieses Kachel-Overlays ab.
int
hashCode()
boolean
isVisible()
Ruft die Sichtbarkeit dieses Kachel-Overlays ab.
void
remove()
Entfernt dieses Kachel-Overlay aus der Karte.
void
setFadeIn(boolean fadeIn)
Legt fest, ob die Overlay-Kacheln eingeblendet werden sollen.
void
setTransparency(Transparenz von Gleitkommazahlen)
Legt die Transparenz dieses Kachel-Overlays fest.
void
setVisible(boolean visible)
Legt die Sichtbarkeit dieses Kachel-Overlays fest.
void
setZIndex(Gleitkommazahl zIndex)
Legt den zIndex dieses Kachel-Overlays fest.

Inherited Method Summary

Public Methods

<ph type="x-smartling-placeholder"></ph> öffentlich voidm clearTileCache ()

Löscht den Kachel-Cache, sodass alle Kacheln noch einmal vom TileProvider angefordert werden. Die aktuellen Kacheln aus diesem Kachel-Overlay werden nach Aufruf dieser . Die API verwaltet einen kleinen speicherinternen Cache mit Kacheln. Wenn Sie Kacheln für einzelne Elemente sollten Sie einen Datenträger-Cache implementieren.

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert ist gleich (Anderes Objekt)

Prüft, ob dieser TileOverlay gleich einer anderen ist.

Parameter
Weitere ein Object.
Gibt Folgendes zurück:
  • "true", wenn beide Objekte dasselbe Objekt sind, d. h. dies == other.

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert getFadeIn ()

Ruft ab, ob die Overlay-Kacheln eingeblendet werden sollen.

Gibt Folgendes zurück:
  • true, wenn die Kacheln langsam eingeblendet werden sollen; false, wenn dies nicht der Fall ist.

<ph type="x-smartling-placeholder"></ph> öffentlich Zeichenfolge getId ()

Ruft die ID dieses Kachel-Overlays ab.

<ph type="x-smartling-placeholder"></ph> öffentlich schweben getTransparency ()

Ruft die Transparenz dieses Kachel-Overlays ab.

Gibt Folgendes zurück:
  • Transparenz dieses Kachel-Overlays.

<ph type="x-smartling-placeholder"></ph> öffentlich schweben getZIndex ()

Ruft den zIndex dieses Kachel-Overlays ab.

Gibt Folgendes zurück:
  • zIndex des Kachel-Overlays

<ph type="x-smartling-placeholder"></ph> öffentlich Ganzzahl hashCode ()

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert isVisible ()

Ruft die Sichtbarkeit dieses Kachel-Overlays ab. Beachten Sie, dass hierdurch nicht zurückgegeben wird, ob die Kachel Das Overlay befindet sich tatsächlich innerhalb des Darstellungsbereichs des Bildschirms. Es wird jedoch gezeichnet, die im Darstellungsbereich des Bildschirms eine Rolle spielen.

Gibt Folgendes zurück:
  • die Sichtbarkeit dieses Kachel-Overlays.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm entfernen ()

Entfernt dieses Kachel-Overlay aus der Karte.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setFadeIn (Boolesches FadeIn)

Legt fest, ob die Overlay-Kacheln eingeblendet werden sollen.

Parameter
fadeIn true, damit die Kacheln eingeblendet werden; false, um sie sofort zu rendern.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setTransparency (Transparenz des Floats)

Legt die Transparenz dieses Kachel-Overlays fest. In der Dokumentation am Anfang dieser Klasse finden Sie erhalten Sie weitere Informationen.

Parameter
Transparenz eine Gleitkommazahl im Bereich [0..1], wobei 0 bedeutet, dass die Kachel Das Overlay ist undurchsichtig und 1 bedeutet, dass es transparent ist.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setVisible (Boolescher Wert sichtbar)

Legt die Sichtbarkeit dieses Kachel-Overlays fest. Ist sie nicht sichtbar, wird ein Kachel-Overlay zwar nicht gezeichnet, behält alle anderen Eigenschaften bei. Kachel-Overlays sind standardmäßig sichtbar.

Parameter
sichtbar true, um dieses Overlay sichtbar zu machen false, um ihn unsichtbar zu machen.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setZIndex (ZIndex als Gleitkommazahl)

Legt den zIndex dieses Kachel-Overlays fest. Weitere Informationen finden Sie in der Dokumentation am Anfang dieser Klasse. Informationen.

Parameter
zIndex zIndex dieses Kachel-Overlays.