Boden-Overlay

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Öffentliche finale Klasse GroundOverlay erweitert Objekt

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

Position
Es gibt zwei Möglichkeiten, die Position des Boden-Overlays festzulegen:
  • Ort verwenden: Du musst ein Bild des Boden-Overlays, einen LatLng, an dem der Anker verankert ist, und die Breite des Overlays in Metern angeben. Der Anker ist standardmäßig 50% vom oberen Rand des Bildes und 50% vom linken Rand des Bildes entfernt. Dies kann geändert werden. Sie können optional die Höhe des Overlays in Metern angeben. Wenn Sie die Höhe des Overlays nicht angeben, wird sie automatisch so berechnet, dass die Proportionen des Bildes beibehalten werden.
  • Verwenden eines Rahmens: Du musst ein LatLngBounds angeben, das das Bild enthält.
Sie müssen die Position des Boden-Overlays vor dem Hinzufügen zur Karte angeben, andernfalls wird IllegalArgumentException ausgelöst, wenn das Boden-Overlay zur Karte hinzugefügt wird. Außerdem müssen Sie die Position nur mit einer dieser Methoden im GroundOverlayOptions-Objekt angeben. Andernfalls wird ein IllegalStateException ausgelöst, wenn mit einer zweiten Methode angegeben wird.
Bild
Das Bild (als BitmapDescriptor), das für das Overlay verwendet werden soll Das Bild wird so skaliert, dass es in die angegebene Position passt. Sie müssen ein Bild angeben, bevor Sie das Boden-Overlay auf der Karte einfügen. Andernfalls wird IllegalArgumentException ausgegeben, wenn es der Karte hinzugefügt wird.
Lage
Der Anteil, in dem das Bild im Uhrzeigersinn gedreht werden soll. Der Mittelpunkt der Rotation ist der Anker des Bildes. Das ist optional und die Standardeinstellung ist 0, d.h. Das Bild ist nach Norden ausgerichtet.
Z-Index
Die Reihenfolge, in der dieses Boden-Overlay bezogen auf andere Overlays gezeichnet wird (einschließlich Polylines und TileOverlays, aber nicht auf Markers). Ein Overlay mit einem größeren zIndex wird über Overlays mit kleineren zIndexes gezeichnet. Die Reihenfolge der Overlays mit demselben zIndex-Wert ist beliebig. Das ist optional und der Standard-ZIndex ist 0.
Transparenz
Die Transparenz des Boden-Overlays im Bereich [0..1], wobei 0 das Overlay undurchsichtig und 1 bedeutet, dass das Overlay 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 für die Transparenz des Boden-Overlays 0, 25 angeben, wird das Pixel auf dem Bildschirm mit dem Alphawert 150 gerendert. Die Spezifikation dieser Property 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 gezeichnet wird. Ein unsichtbares Boden-Overlay wird nicht gezeichnet, behält aber alle anderen Eigenschaften bei. Das ist optional und die Standardsichtbarkeit ist true, d.h. sichtbar.
Anklickbarkeit
Wenn du Ereignisse verarbeiten möchtest, die ausgelöst werden, wenn der Nutzer auf das Boden-Overlay klickt, setze diese Property auf true. Sie können diesen Wert jedoch jederzeit ändern. Der Standardwert ist false. Wenn diese Property auf true gesetzt ist, erhält deine App Benachrichtigungen an die GoogleMap.OnGroundOverlayClickListener, die über setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) registriert ist.
Tag
Eine Object, die mit dem Boden-Overlay verknüpft ist. So kann beispielsweise Object Daten zur Darstellung des Boden-Overlays enthalten. Dies ist einfacher als das Speichern einer separaten Map<GroundOverlay, Object>. Ein weiteres Beispiel: Sie können eine String-ID zuordnen, die der ID aus einem Datensatz entspricht. Diese Property wird vom Google Maps SDK for Android weder gelesen noch geschrieben.

Methoden in dieser Klasse müssen im Android-UI-Thread aufgerufen werden. Wenn nicht, wird IllegalStateException zur Laufzeit geworfen.

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(anderes Objekt)
Testet, ob dieses GroundOverlay einem anderen entspricht.
float
getBearing
Ruft die Lage des Boden-Overlays in Grad im Uhrzeigersinn von Norden aus 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 diese ID für das Boden-Overlay ab.
LatLng
getPosition()
Ruft die Position des Ankerpunkts ab.
Object
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.
Ungültig
remove()
Entfernt dieses Boden-Overlay von der Karte.
Ungültig
setBearing(Gleitkommazahl)
Legt die Lage des Boden-Overlays (in Richtung der vertikalen Achse des Boden-Overlays) in Grad im Uhrzeigersinn von Norden aus fest.
Ungültig
setClickable(boolesch anklickbar)
Legt die Anklickbarkeit des Boden-Overlays fest.
Ungültig
setDimensions(float-Breite, float-Höhe)
Legt die Abmessungen des Boden-Overlays fest.
Ungültig
setAbmessungen(Gleitkommazahl)
Legt die Breite des Boden-Overlays fest.
Ungültig
setImage(BitmapDescriptor-ImageDescriptor)
Legt das Bild für das Boden-Overlay fest.
Ungültig
setPosition(LatLng latLng)
Legt die Position des Boden-Overlays fest, indem die Position des Ankerpunkts geändert wird.
Ungültig
setPositionFromBounds(LatLngBounds Grenzen)
Legt die Position des Boden-Overlays fest, indem sie an das angegebene LatLngBounds angepasst wird.
Ungültig
setTag(Objekt-Tag)
Legt das Tag für das Boden-Overlay fest.
Ungültig
setTransparency(Gleitkommatransparenz)
Legt die Transparenz dieses Boden-Overlays fest.
Ungültig
setVisible(boolesch sichtbar)
Legt die Sichtbarkeit dieses Boden-Overlays fest.
Ungültig
setZIndex(Gleitkommazahl zIndex)
Legt den zIndex dieses Boden-Overlays fest.

Inherited Method Summary

Public Methods

Öffentlich boolesch ist gleich (Objekt Sonstiges)

Testet, ob dieses GroundOverlay einem anderen entspricht.

Parameter
Weitere Object.
Rückgabe:
  • "true", wenn beide Objekte dasselbe Objekt sind, also == other.

public float getBearing ()

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

Rückgabe:
  • die Lage des Boden-Overlays.

öffentlich LatLngBounds getBounds ()

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

Rückgabe:
  • LatLngBounds, das das Boden-Overlay enthält, wobei die Rotation ignoriert wird

public float getHeight ()

Ruft die Höhe des Boden-Overlays ab.

Rückgabe:
  • Höhe des Boden-Overlays in Metern.

public String getId ()

Ruft diese ID für das Boden-Overlay ab. Die ID ist unter allen GroundOverlays auf einer Karte eindeutig.

Rückgabe:
  • die ID dieses Boden-Overlays.

public eCPM getPosition ()

Ruft die Position des Ankerpunkts ab.

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

public Object getTag ()

Ruft das Tag für den Kreis ab.

Rückgabe:
  • 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ückgabe:
  • die Transparenz dieses Boden-Overlays.

öffentlichen Gleitkomma getWidth ()

Ruft die Breite des Boden-Overlays ab.

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

öffentlichen Gleitkomma getZIndex ()

Ruft den zIndex dieses Boden-Overlays ab.

Rückgabe:
  • zIndex des Boden-Overlays.

public int HashCode ()

Öffentlich boolesch isClickable ()

Ruft die Anklickbarkeit des Boden-Overlays ab. Wenn das Boden-Overlay anklickbar ist, erhält deine App Benachrichtigungen an GoogleMap.OnGroundOverlayClickListener, wenn der Nutzer auf das Boden-Overlay klickt. Der Ereignis-Listener ist über setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) registriert.

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

Öffentlich boolesch isVisible ()

Ruft die Sichtbarkeit dieses Boden-Overlays ab. Beachten Sie, dass dabei nicht zurückgegeben wird, ob das Boden-Overlay tatsächlich auf dem Bildschirm sichtbar ist, sondern ob es gezeichnet werden soll, wenn es sich im Darstellungsbereich der Kamera befindet.

Rückgabe:
  • die Sichtbarkeit dieses Boden-Overlays.

öffentlich void entfernen ()

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

public void setBearing (Gleitkommazahl)

Legt die Lage des Boden-Overlays (in Richtung der vertikalen Achse des Boden-Overlays) in Grad im Uhrzeigersinn von Norden aus fest. Die Rotation wird um den Ankerpunkt durchgeführt.

Parameter
bearing Ausrichtung in Grad im Uhrzeigersinn von Norden aus

public void setClickable (boolesch anklickbar)

Legt die Anklickbarkeit des Boden-Overlays fest. Wenn das Boden-Overlay anklickbar ist, erhält deine App Benachrichtigungen an GoogleMap.OnGroundOverlayClickListener, wenn der Nutzer auf das Boden-Overlay klickt. Der Ereignis-Listener ist über setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) registriert.

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

public void setAbmessungen (float width, float height)

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

Parameter
width Breite in Metern
height Höhe in Metern

public void setAbmessungen (Gleitkommabreite)

Legt die Breite des Boden-Overlays fest. Die Höhe des Boden-Overlays wird entsprechend angepasst.

Parameter
width Breite in Metern

public void setImage (BitmapDescriptor imageDescriptor)

Legt das Bild für das Boden-Overlay fest. Das neue Image nimmt die gleichen Grenzen wie das alte Image ein.

Parameter
Bildbeschreibung Das BitmapDescriptor, das für dieses Boden-Overlay verwendet werden soll.

public void setPosition (LatLng latLng)

Legt die Position des Boden-Overlays fest, indem die Position des Ankerpunkts geändert wird. Behält alle anderen Eigenschaften des Bildes bei.

Parameter
latLng LatLng, das den neuen Ankerpunkt darstellt.

public void setPositionFromBounds (LatLngBounds bounds)

Legt die Position des Boden-Overlays fest, indem sie an das angegebene LatLngBounds angepasst wird. Bei dieser Methode wird die Drehrichtung des Boden-Overlays beim Positionieren ignoriert. Die Lage wird beim Zeichnen jedoch weiterhin 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 eine beliebige Object mit diesem Boden-Overlay zu verknüpfen. So kann beispielsweise Object Daten zur Darstellung des Boden-Overlays enthalten. Dies ist einfacher als das Speichern einer separaten Map<GroundOverlay, Object>. Ein weiteres Beispiel: Sie können eine String-ID zuordnen, die der ID aus einem Dataset entspricht. Diese Property wird vom Google Maps SDK for Android weder gelesen noch geschrieben. Sie sind dafür verantwortlich, setTag(null) aufzurufen und das Tag zu löschen, wenn Sie es nicht mehr benötigen, um Speicherlecks in Ihrer App zu vermeiden.

Parameter
Tag bei 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 diesem Kurs.

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

public void setVisible (boolesch sichtbar)

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 Bei true ist das Boden-Overlay sichtbar, bei false nicht.

public void setZIndex (float zIndex)

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

Parameter
Z-Index zIndex dieses Boden-Overlays