Boden-Overlay

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