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 vonPatternItem
-Objekten, die entlang des Umrisses des Kreises wiederholt werden. VerfügbarePatternItem
-Typen:Gap
(definiert durch die Abstandslänge in Pixeln),Dash
(definiert durch die Strichbreite und die Strichlänge in Pixeln) undDot
(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
- undPolygon
-, aber nichtMarker
-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 kannObject
Daten darüber enthalten, was der Kreis darstellt. Dies ist einfacher als das Speichern einer separatenMap<Circle, Object>
. Als weiteres Beispiel können Sie eineString
-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 | |
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 | |
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 | |
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 ()
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)
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)
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)
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. |
---|