GroundOverlay

Öffentliche finale Klasse GroundOverlay erweitert Objekt

Ein Boden-Overlay ist ein Bild, das auf einer Karte fixiert ist. Ein Boden-Overlay hat folgende Eigenschaften:

Position
Es gibt zwei Möglichkeiten, das Boden-Overlay zu positionieren:
  • Standort verwenden: Du musst ein Bild des Boden-Overlays, ein LatLng-Element, an dem der Anker fixiert wird, und die Breite des Overlays (in Metern) zur Verfügung stellen. Der Anker ist standardmäßig 50% vom oberen Rand des Bildes und 50% vom linken Rand des Bildes entfernt. Dies kann geändert werden. Optional können Sie die Höhe des Overlays (in Metern) angeben. Wenn Sie die Höhe des Overlays nicht angeben, wird sie automatisch unter Beibehaltung des Seitenverhältnisses des Bildes berechnet.
  • Begrenzungen verwenden: Sie müssen einen LatLngBounds angeben, der das Bild enthält.
Sie müssen die Position des Boden-Overlays angeben, bevor es der Karte hinzugefügt wird. Andernfalls wird ein IllegalArgumentException-Element ausgelöst, wenn das Boden-Overlay der Karte hinzugefügt wird. Außerdem dürfen Sie die Position nur mit einer dieser Methoden im Objekt GroundOverlayOptions angeben. Andernfalls wird bei Verwendung einer zweiten Methode ein IllegalStateException ausgelöst.
Bild
Das Bild (als BitmapDescriptor), das für dieses Overlay verwendet werden soll. Das Bild wird so skaliert, dass es an die angegebene Position passt. Sie müssen ein Bild angeben, bevor Sie das Boden-Overlay der Karte hinzufügen. Andernfalls wird beim Hinzufügen der Karte ein IllegalArgumentException ausgelöst.
Lagerung
Der Wert, um den das Bild im Uhrzeigersinn gedreht werden soll. Der Mittelpunkt der Rotation ist der Bildanker. Dies ist optional und die Standardeinstellung ist 0, d.h. ist das Bild nach Norden ausgerichtet.
zIndex
Die Reihenfolge, in der dieses Boden-Overlay im Verhältnis zu anderen Overlays gezeichnet wird (einschließlich Polyline- und TileOverlay-Elementen, aber nicht Marker-Elementen). Ein Overlay mit einem größeren zIndex wird über Overlays mit kleineren zIndexen angezeigt. Die Reihenfolge von Overlays mit demselben zIndex-Wert ist beliebig. Dies ist optional und der Standard-zIndex ist 0.
Transparenz
Transparenz des Boden-Overlays im Bereich [0..1], wobei 0 bedeutet, dass das Overlay undurchsichtig ist und 1, dass es vollständig transparent ist. Wenn die angegebene Bitmap bereits teilweise transparent ist, wird die Transparenz jedes Pixels entsprechend skaliert.Wenn ein Pixel in der Bitmap beispielsweise einen Alphawert von 200 hat und Sie die Transparenz des Boden-Overlays mit 0, 25 festlegen, wird das Pixel mit einem Alphawert von 150 auf dem Bildschirm gerendert. Die Angabe dieser Eigenschaft ist optional und die Standardtransparenz ist 0 (undurchsichtig).
Sichtbarkeit
Gibt an, ob das Boden-Overlay sichtbar oder unsichtbar ist, d.h., ob es auf der Karte eingezeichnet wird. Ein unsichtbares Boden-Overlay wird nicht gezeichnet, behält aber alle anderen Eigenschaften bei. Dies ist optional und die Standardeinstellung für die Sichtbarkeit ist true, d.h. sichtbar.
Anklickbarkeit
Wenn Ereignisse verarbeitet werden sollen, die ausgelöst werden, wenn der Nutzer auf das Boden-Overlay klickt, legen Sie diese Eigenschaft auf true fest. Sie können diesen Wert jedoch jederzeit ändern. Der Standardwert ist false. Wenn dieses Attribut auf true gesetzt ist, erhält deine App Benachrichtigungen an die GoogleMap.OnGroundOverlayClickListener, die über setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) registriert sind.
Taggen
Ein Object, das mit dem Boden-Overlay verknüpft ist. Beispielsweise kann Object Daten darüber enthalten, was das Boden-Overlay darstellt. Dies ist einfacher als das Speichern einer separaten Map<GroundOverlay, Object>. Als weiteres Beispiel können Sie eine String-ID verknüpfen, die der ID aus einem Datensatz entspricht. Das Google Maps SDK for Android liest oder schreibt diese Property weder.

Methoden in dieser Klasse müssen im Android-UI-Thread aufgerufen werden. Andernfalls wird zur Laufzeit ein IllegalStateException ausgegeben.

Beispiel

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));
 

Public Method Summary

boolean
ist gleich(Sonstiges Objekt)
Testet, ob diese GroundOverlay einem anderen entspricht.
float
getBearing()
Ruft die Lage des Boden-Overlays in Grad im Uhrzeigersinn von Norden ab.
LatLngBounds
getBounds()
Ruft die Grenzen für das Boden-Overlay ab.
float
getHeight()
Ruft die Höhe des Boden-Overlays ab.
String
getId()
Ruft die ID dieses Boden-Overlays ab.
LatLng
getPosition()
Ruft die Position des Ankerpunkts ab.
Objekt
getTag()
Ruft das Tag für den Kreis ab.
float
getTransparency()
Ruft die Transparenz dieses Boden-Overlays ab
float
getWidth()
Ruft die Breite des Boden-Overlays ab.
float
getZIndex()
Ruft den zIndex dieses Boden-Overlays ab.
int
boolean
isClickable()
Ruft die Anklickbarkeit des Boden-Overlays ab.
boolean
isVisible()
Ruft die Sichtbarkeit dieses Boden-Overlays ab.
void
remove()
Entfernt dieses Boden-Overlay von der Karte.
void
setBearing(Gleitkommazahl)
Legt die Peilung des Boden-Overlays (die Richtung, in der die vertikale Achse des Boden-Overlays zeigt) in Grad im Uhrzeigersinn von Norden fest.
void
setClickable(boolesch klickbar)
Legt die Anklickbarkeit des Boden-Overlays fest.
void
setDimensions(Gleitkommazahl, Gleitkommazahl)
Legt die Abmessungen des Boden-Overlays fest.
void
setDimensions(Gleitkommabreite)
Legt die Breite des Boden-Overlays fest.
void
setImage(BitmapDescriptor-imageDescriptor)
Legt das Bild für das Boden-Overlay fest.
void
setPosition(LatLng latLng)
Legt die Position des Boden-Overlays durch Ändern der Position des Ankerpunkts fest.
void
setPositionFromBounds(LatLngBounds-Grenzen)
Legt die Position des Boden-Overlays fest, indem es an den angegebenen LatLngBounds angepasst wird.
void
setTag(Objekt-Tag)
Legt das Tag für das Boden-Overlay fest.
void
setTransparency(Gleitkommatransparenz)
Legt die Transparenz dieses Boden-Overlays fest
void
setVisible(boolesch sichtbar)
Legt die Sichtbarkeit dieses Boden-Overlays fest.
void
setZIndex(Gleitkommazahl zIndex)
Legt den zIndex dieses Boden-Overlays fest

Inherited Method Summary

Public Methods

public boolesch ist gleich (Objekt anderes)

Testet, ob diese GroundOverlay einem anderen entspricht.

Parameter
Weitere ein Object.
Rückgaben
  • true, wenn beide Objekte dasselbe Objekt sind, d. h. diese == other.

public float getBearing ()

Ruft die Lage des Boden-Overlays in Grad im Uhrzeigersinn von Norden ab.

Rückgaben
  • die Peilung des Boden-Overlays.

public LatLngBounds getBounds ()

Ruft die Grenzen für das Boden-Overlay ab. Dadurch wird die Drehung des Boden-Overlays ignoriert.

Rückgaben
  • ein LatLngBounds, das das Boden-Overlay enthält, wobei die Drehung ignoriert wird.

public float getHeight ()

Ruft die Höhe des Boden-Overlays ab.

Rückgaben
  • die Höhe des Boden-Overlays in Metern.

public String getId ()

Ruft die ID dieses Boden-Overlays ab. Die ID ist unter allen Boden-Overlays auf einer Karte eindeutig.

Rückgaben
  • ID dieses Boden-Overlays.

public LatLng getPosition ()

Ruft die Position des Ankerpunkts ab.

Rückgaben
  • die Position auf der Karte (LatLng).

public Objekt getTag ()

Ruft das Tag für den Kreis ab.

Rückgaben
  • das Tag, wenn ein Tag mit setTag festgelegt wurde; null, wenn kein Tag festgelegt wurde.

public float getTransparency ()

Ruft die Transparenz dieses Boden-Overlays ab

Rückgaben
  • die Transparenz dieses Boden-Overlays.

public float getWidth ()

Ruft die Breite des Boden-Overlays ab.

Rückgaben
  • die Breite des Boden-Overlays in Metern.

public float getZIndex ()

Ruft den zIndex dieses Boden-Overlays ab.

Rückgaben
  • z-Index des Boden-Overlays.

public int hashCode ()

public boolesch isClickable ()

Ruft die Anklickbarkeit des Boden-Overlays ab. Ist das Boden-Overlay anklickbar, erhält die App Benachrichtigungen an GoogleMap.OnGroundOverlayClickListener, sobald der Nutzer darauf klickt. Der Event-Listener wird über setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) registriert.

Rückgaben
  • true, wenn das Boden-Overlay anklickbar ist. Andernfalls wird false zurückgegeben.

public boolesch isVisible ()

Ruft die Sichtbarkeit dieses Boden-Overlays ab. Dabei wird nicht zurückgegeben, ob das Boden-Overlay tatsächlich auf dem Bildschirm zu sehen ist, sondern ob es gezeichnet wird, wenn es im Darstellungsbereich der Kamera enthalten ist.

Rückgaben
  • die Sichtbarkeit dieses Boden-Overlays.

public void entfernen ()

Entfernt dieses Boden-Overlay von der Karte. Nachdem ein Boden-Overlay entfernt wurde, ist das Verhalten aller zugehörigen Methoden nicht definiert.

public void setBearing (Gleitkommazahl)

Legt die Peilung des Boden-Overlays (die Richtung, in der die vertikale Achse des Boden-Overlays zeigt) in Grad im Uhrzeigersinn von Norden fest. Die Rotation wird um den Ankerpunkt ausgeführt.

Parameter
bearing Ausrichtung in Grad im Uhrzeigersinn von Norden aus

public void setClickable (boolesch klickbar)

Legt die Anklickbarkeit des Boden-Overlays fest. Ist das Boden-Overlay anklickbar, erhält die App Benachrichtigungen an GoogleMap.OnGroundOverlayClickListener, sobald der Nutzer darauf klickt. Der Event-Listener wird über setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) registriert.

Parameter
Anklickbar Neue Einstellung für die Anklickbarkeit des Boden-Overlays.

public void setDimensions (Gleitkommazahl, Gleitkommazahl)

Legt die Abmessungen des Boden-Overlays fest. Das Bild wird so gestreckt, dass es die Abmessungen passt.

Parameter
width Breite in Metern
height Größe in Metern

public void setDimensions (Gleitkommabreite)

Legt die Breite des Boden-Overlays fest. Die Höhe des Boden-Overlays wird entsprechend angepasst, um das Seitenverhältnis beizubehalten.

Parameter
width Breite in Metern

public void setImage (BitmapDescriptor imageDescriptor)

Legt das Bild für das Boden-Overlay fest. Das neue Bild nimmt dieselben Begrenzungen wie das alte Bild ein.

Parameter
imageDescriptor BitmapDescriptor, der für dieses Boden-Overlay verwendet werden soll.

public void setPosition (LatLng latLng)

Legt die Position des Boden-Overlays durch Ändern der Position des Ankerpunkts fest. Behält alle anderen Eigenschaften des Bildes bei.

Parameter
latLng einen LatLng, der die neue Position zum Setzen des Ankerpunkts ist.

public void setPositionFromBounds (LatLngBounds bounds)

Legt die Position des Boden-Overlays fest, indem es an den angegebenen LatLngBounds angepasst wird. Bei dieser Methode wird die Rotation (Lage) des Boden-Overlays beim Positionieren des Boden-Overlays ignoriert, die Lage wird jedoch beim Zeichnen verwendet.

Parameter
Grenzen ein LatLngBounds, in dem das Boden-Overlay platziert werden soll

public void setTag (Objekt-Tag)

Legt das Tag für das Boden-Overlay fest.

Du kannst diese Property verwenden, um ein beliebiges Object mit diesem Boden-Overlay zu verknüpfen. Beispielsweise kann Object Daten darüber enthalten, was das Boden-Overlay darstellt. Dies ist einfacher als das Speichern einer separaten Map<GroundOverlay, Object>. Als weiteres Beispiel können Sie eine String-ID verknüpfen, die der ID aus einem Dataset entspricht. Das Google Maps SDK for Android liest oder schreibt diese Property weder. Sie sind dafür verantwortlich, setTag(null) aufzurufen, um das Tag zu löschen, wenn Sie es nicht mehr benötigen, um Speicherlecks in Ihrer App zu vermeiden.

Parameter
Tag Ist null, wird das Tag gelöscht.

public void setTransparency (Float Transparency)

Legt die Transparenz dieses Boden-Overlays fest Weitere Informationen finden Sie in der Dokumentation oben in dieser Klasse.

Parameter
Transparenz eine Gleitkommazahl im Bereich [0..1], wobei 0 bedeutet, dass das Boden-Overlay opak ist, und 1, dass es transparent ist.

public void setVisible (boolean visible)

Legt die Sichtbarkeit dieses Boden-Overlays fest. Wenn ein Boden-Overlay nicht sichtbar ist, wird es nicht gezeichnet, behält aber alle anderen Eigenschaften bei.

Parameter
sichtbar Ist true festgelegt, ist das Boden-Overlay sichtbar. Bei false ist es nicht sichtbar.

public void setZIndex (Gleitkomma zIndex)

Legt den zIndex dieses Boden-Overlays fest Weitere Informationen finden Sie in der Dokumentation oben in dieser Klasse.

Parameter
zIndex Z-Index dieses Boden-Overlays