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.
IllegalArgumentException
ausgelöst, wenn das Boden-Overlay zur Karte hinzugefügt wird. Außerdem müssen Sie die Position nur mit einer dieser Methoden imGroundOverlayOptions
-Objekt angeben. Andernfalls wird einIllegalStateException
ausgelöst, wenn mit einer zweiten Methode angegeben wird. - Ort verwenden: Du musst ein Bild des Boden-Overlays, einen
- 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 wirdIllegalArgumentException
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
Polyline
s undTileOverlay
s, aber nicht aufMarker
s). 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]
, wobei0
das Overlay undurchsichtig und1
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 istfalse
. Wenn diese Property auftrue
gesetzt ist, erhält deine App Benachrichtigungen an dieGoogleMap.OnGroundOverlayClickListener
, die übersetOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
registriert ist. - Tag
- Eine
Object
, die mit dem Boden-Overlay verknüpft ist. So kann beispielsweiseObject
Daten zur Darstellung des Boden-Overlays enthalten. Dies ist einfacher als das Speichern einer separatenMap<GroundOverlay, Object>
. Ein weiteres Beispiel: Sie können eineString
-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 |
hashCode()
|
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 | |
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 wirdfalse
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 |
---|