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.
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 ObjektGroundOverlayOptions
angeben. Andernfalls wird bei Verwendung einer zweiten Methode einIllegalStateException
ausgelöst. - Standort verwenden: Du musst ein Bild des Boden-Overlays, ein
- 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 einIllegalArgumentException
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
- undTileOverlay
-Elementen, aber nichtMarker
-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]
, wobei0
bedeutet, dass das Overlay undurchsichtig ist und1
, 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 istfalse
. Wenn dieses Attribut auftrue
gesetzt ist, erhält deine App Benachrichtigungen an dieGoogleMap.OnGroundOverlayClickListener
, die übersetOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
registriert sind. - Taggen
- Ein
Object
, das mit dem Boden-Overlay verknüpft ist. Beispielsweise kannObject
Daten darüber enthalten, was das Boden-Overlay darstellt. Dies ist einfacher als das Speichern einer separatenMap<GroundOverlay, Object>
. Als weiteres Beispiel können Sie eineString
-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 |
hashCode()
|
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 | |
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 wirdfalse
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 |
---|