GroundOverlay

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

Position

Es gibt zwei Möglichkeiten, Boden-Overlays zu positionieren. <ph type="x-smartling-placeholder">

</ph>
• Mit einem Standort: Sie müssen ein Bild des Boden-Overlays bereitstellen, ein LatLng auf der der Anker fixiert wird, sowie die Breite des Overlays (in Metern). Die Der Ankerpunkt befindet sich standardmäßig 50% vom oberen Rand des Bildes und 50% vom linken Rand des Bildes entfernt. Bild. Dies kann geändert werden. Optional können Sie die Höhe des Overlays (in Meter). Wenn Sie die Höhe des Overlays nicht angeben, wird diese automatisch um die Proportionen des Bildes beizubehalten.
• Verwenden von Grenzen: Sie müssen ein LatLngBounds angeben, das das Bild enthält.

Sie müssen die Position des Boden-Overlays angeben, bevor Sie es der Karte hinzufügen. Andernfalls wird IllegalArgumentException ausgelöst, wenn das Boden-Overlay der Karte hinzugefügt wurde. Außerdem dürfen Sie die Position nur mit einer dieser Optionen angeben. im GroundOverlayOptions-Objekt. Andernfalls wird bei der Angabe mit einer zweiten Methode ein IllegalStateException ausgelöst.

Bild

Das Bild (als BitmapDescriptor), das für dieses Overlay verwendet werden soll. Das Bild wird an die angegebene Position angepasst. Sie müssen ein Bild angeben, bevor Sie den Boden hinzufügen. Overlay zur Karte hinzufügen; Andernfalls wird IllegalArgumentException ausgelöst, wenn es der Karte hinzugefügt wurde.

Peilung

Der Wert, um den das Bild im Uhrzeigersinn gedreht werden soll. Das Zentrum der Rotation ist der Anker des Bildes. Dies ist optional und die Standardausrichtung ist 0, d.h. ist das Bild so ausgerichtet, dass es nach Norden ausgerichtet ist.

zIndex

Die Reihenfolge, in der dieses Boden-Overlay im Verhältnis zu anderen Overlays gezeichnet wird (einschließlich Polyline und TileOverlay, aber nicht Marker. Ein Overlay mit einem Ein größerer zIndex wird über Overlays mit kleineren zIndexen gezeichnet. Die Reihenfolge der Overlays mit der zIndex-Wert beliebig ist. Dies ist optional und der Standard-zIndex ist 0.

Transparenz

Transparenz des Boden-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 Boden-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 Boden-Overlay sichtbar oder unsichtbar ist, d.h., ob es auf dem 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 Folgendes fest: zu true. 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 über setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) registriert.

Tag

Ein Object, das dem Boden-Overlay zugeordnet ist. Beispielsweise kann der Object enthält Daten darüber, was das Boden-Overlay darstellt. Das ist einfacher als das Speichern eines separate Map<GroundOverlay, Object>. Als weiteres Beispiel können Sie eine String-ID verknüpfen, die der ID aus einem Datensatz entspricht. Google Maps SDK for Android weder liest oder schreibt diese Eigenschaft.

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

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