Kreis

Öffentliche finale Klasse Circle erweitert Objekt

Ein Kreis auf der Erdoberfläche (Kappe)

Kreise haben folgende Eigenschaften.

Center
Der Mittelpunkt des Kreises wird als LatLng angegeben.
Radius
Der Radius des Kreises in Metern. Der Wert sollte null oder größer sein.
Strichbreite
Die Breite des Kreises in Bildschirmpixeln. Die Breite ist konstant und unabhängig von der Zoomstufe der Kamera. Der Standardwert ist 10.
Strichfarbe
Die Farbe der Kreiskontur im ARGB-Format, dasselbe Format, das von Color verwendet wird. Der Standardwert ist Schwarz (0xff000000).
Strichmuster
Durchgängig (Standardeinstellung, dargestellt durch null) oder eine Abfolge von PatternItem-Objekten, die entlang des Umrisses des Kreises wiederholt werden. Verfügbare PatternItem-Typen: Gap (definiert durch die Abstandslänge in Pixeln), Dash (definiert durch die Strichbreite und die Strichlänge in Pixeln) und Dot (kreisförmig, auf dem Umriss des Kreises zentriert, Durchmesser von der Strichbreite in Pixeln definiert).
Füllfarbe
Die Farbe der Kreisfüllung im ARGB-Format, das auch von Color verwendet wird. Der Standardwert ist transparent (0x00000000).
Z-Index
Die Reihenfolge, in der dieses Kachel-Overlay in Bezug auf andere Overlays gezeichnet wird (einschließlich GroundOverlay-, TileOverlay-, Polyline- und Polygon-, aber nicht Marker-Elementen). Ein Overlay mit einem größeren Z-Index wird über Overlays mit kleineren Z-Indizes gezogen. Die Reihenfolge von Überlagerungen mit identischen z-Indizes ist beliebig. Der Standard-ZIndex ist 0.
Sichtbarkeit
Gibt an, ob der Kreis sichtbar oder unsichtbar ist, d.h., ob er auf der Karte eingezeichnet wird. Ein unsichtbarer Kreis wird nicht gezeichnet, behält aber alle anderen Eigenschaften bei. Der Standardwert ist true, d.h. sichtbar.
Taggen
Eine Object, die mit dem Kreis verknüpft ist. Beispielsweise kann Object Daten darüber enthalten, was der Kreis darstellt. Dies ist einfacher als das Speichern einer separaten Map<Circle, 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.

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.
 // Add a circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

Der aktuelle Karten-Renderer kann die Kreisfüllung nicht zeichnen, wenn der Kreis entweder den Nord- oder Südpol umfasst. Der Umriss wird trotzdem korrekt gezeichnet.

Entwicklerleitfaden

Weitere Informationen finden Sie im Entwicklerleitfaden für Formen.

Public Method Summary

LatLng
getCenter()
Gibt den Mittelpunkt als LatLng zurück.
int
getFillColor()
Gibt die Füllfarbe dieses Kreises zurück
String
getId()
Ruft die ID dieses Kreises ab.
Doppelwert
getRadius()
Gibt den Radius des Kreises in Metern zurück.
int
getStrokeColor()
Gibt die Strichfarbe zurück.
List<PatternItem>
getStrokePattern()
Gibt das Strichmuster des Umrisses dieses Kreises zurück
float
getStrokeWidth()
Gibt die Strichbreite zurück.
Objekt
getTag()
Ruft das Tag für den Kreis ab.
float
getZIndex()
Gibt den zIndex zurück.
boolean
isClickable()
Ruft die Anklickbarkeit des Kreises ab.
boolean
isVisible()
Überprüft, ob der Kreis sichtbar ist.
void
remove()
Entfernt diesen Kreis aus der Karte.
void
setCenter(LatLng-Mitte)
Legt den Mittelpunkt mithilfe von LatLng fest.
void
setClickable(boolesch klickbar)
Legt die Anklickbarkeit des Kreises fest.
void
setFillColor(int-Farbe)
Legt die Füllfarbe fest.
void
setRadius(doppelter Radius)
Legt den Radius in Metern fest.
void
setStrokeColor(int-Farbe)
Legt die Strichfarbe fest.
void
setStrokePattern(List<PatternItem>-Muster)
Legt das Strichmuster des Umrisses des Kreises fest.
void
setStrokeWidth(Gleitkommazahl)
Legt die Strichbreite fest.
void
setTag(Objekt-Tag)
Legt das Tag für den Kreis fest.
void
setVisible(boolesch sichtbar)
Legt die Sichtbarkeit des Kreises fest.
void
setZIndex(Gleitkommazahl zIndex)
Legt den zIndex fest.

Inherited Method Summary

Public Methods

public LatLng getCenter ()

Gibt den Mittelpunkt als LatLng zurück.

Rückgaben
  • Das geografische Zentrum als LatLng.

public int getFillColor ()

Gibt die Füllfarbe dieses Kreises zurück

Rückgaben
  • Die Füllfarbe des Kreises im ARGB-Format.

public String getId ()

Ruft die ID dieses Kreises ab. Die ID ist unter allen Kreisen auf einer Karte eindeutig.

public double getRadius ()

Gibt den Radius des Kreises in Metern zurück.

Rückgaben
  • Der Radius in Metern.

public int getStrokeColor ()

Gibt die Strichfarbe zurück.

Rückgaben
  • Die Farbe des Kreises im ARGB-Format.

public List<PatternItem> getStrokePattern ()

Gibt das Strichmuster des Umrisses dieses Kreises zurück

Rückgaben
  • des Strichmusters.

public float getStrokeWidth ()

Gibt die Strichbreite zurück.

Rückgaben
  • Die Breite in Bildschirmpixeln.

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 getZIndex ()

Gibt den zIndex zurück.

Rückgaben
  • Der zIndex dieses Kreises.

public boolesch isClickable ()

Ruft die Anklickbarkeit des Kreises ab. Wenn der Kreis anklickbar ist, erhält deine App Benachrichtigungen an GoogleMap.OnCircleClickListener, wenn der Nutzer auf den Kreis klickt. Der Event-Listener wird über setOnCircleClickListener(GoogleMap.OnCircleClickListener) registriert.

Rückgaben
  • true, wenn der Kreis anklickbar ist; false, wenn er nicht anklickbar ist.

public boolesch isVisible ()

Überprüft, ob der Kreis sichtbar ist.

Rückgaben
  • true, wenn der Kreis sichtbar ist; false, wenn er unsichtbar ist.

public void entfernen ()

Entfernt diesen Kreis aus der Karte. Nachdem ein Kreis entfernt wurde, ist das Verhalten all seiner Methoden nicht mehr definiert.

public void setCenter (LatLng center)

Legt den Mittelpunkt mithilfe von LatLng fest.

Der Mittelpunkt darf nicht null sein, da es keinen Standardwert gibt.

Parameter
in der Mitte Der geografische Mittelpunkt des Kreises, angegeben als LatLng.
Löst aus
NullPointerException Mittelpunkt ist null

public void setClickable (boolesch klickbar)

Legt die Anklickbarkeit des Kreises fest. Wenn der Kreis anklickbar ist, erhält deine App Benachrichtigungen an GoogleMap.OnCircleClickListener, wenn der Nutzer auf den Kreis klickt. Der Event-Listener wird über setOnCircleClickListener(GoogleMap.OnCircleClickListener) registriert.

Parameter
Anklickbar Neue Einstellung für die Anklickbarkeit für den Kreis.

public void setFillColor (int color)

Legt die Füllfarbe fest.

Die Füllfarbe ist die Farbe innerhalb des Kreises im Ganzzahlformat, das durch Color angegeben wird. Bei Verwendung von TRANSPARENT wird keine Füllung gezeichnet.

Parameter
Farbe Die Farbe im Color-Format.

public void setRadius (doppelter Radius)

Legt den Radius in Metern fest.

Der Radius muss null oder größer sein.

Parameter
Umkreis Der Radius in Metern.
Löst aus
IllegalArgumentException Radius ist negativ

public void setStrokeColor (int color)

Legt die Strichfarbe fest.

Die Strichfarbe ist die Farbe des Umrisses des Kreises im Ganzzahlformat, das durch Color angegeben wird. Bei Verwendung von TRANSPARENT wird kein Umriss gezeichnet.

Parameter
Farbe Die Strichfarbe im Format Color.

public void setStrokePattern (List<PatternItem> pattern)

Legt das Strichmuster des Umrisses des Kreises fest. Das Standardstrichmuster ist durchgehend, dargestellt durch null.

Parameter
Muster des Strichmusters.

public void setStrokeWidth (Gleitkommabreite)

Legt die Strichbreite fest.

Die Strichbreite ist die Breite des Kreisumrisses (in Bildschirmpixeln). Er muss null oder größer sein. Ist sie null, wird kein Umriss gezeichnet. Der Standardwert ist 10.

Parameter
width Die Strichbreite in Bildschirmpixeln.
Löst aus
IllegalArgumentException wenn die Breite negativ ist

public void setTag (Objekt-Tag)

Legt das Tag für den Kreis fest.

Du kannst diese Eigenschaft verwenden, um einen beliebigen Object mit diesem Kreis zu verknüpfen. Beispielsweise kann Object Daten darüber enthalten, was der Kreis darstellt. Dies ist einfacher als das Speichern einer separaten Map<Circle, Object>. Als weiteres Beispiel kannst du 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 setVisible (boolean visible)

Legt die Sichtbarkeit des Kreises fest.

Wenn dieser Kreis nicht sichtbar ist, wird er nicht gezeichnet. Alle anderen Status werden beibehalten. Kreise sind standardmäßig sichtbar.

Parameter
sichtbar true, um diesen Kreis sichtbar zu machen, oder false, um ihn unsichtbar zu machen.

public void setZIndex (Gleitkomma zIndex)

Legt den zIndex fest.

Overlays (wie Kreise) mit höheren zIndices werden über denen mit niedrigeren Indizes gezeichnet.

Parameter
zIndex Der zIndex-Wert.