Auf der Google Maps Platform ist bald eine neue Version der Funktionen für das cloudbasierte Gestalten von Karteninhalten verfügbar. Die Aktualisierung umfasst eine neue Standardfarbvorlage und Optimierungen in Bezug auf die Nutzerfreundlichkeit der Karten. Alle Kartenstile werden im März 2025 automatisch aktualisiert. Weitere Informationen zur Verfügbarkeit und Aktivierung sind unter Neuer Kartenstil für die Google Maps Platform verfügbar.

Diese Seite wurde von der Cloud Translation API übersetzt.

Kreis

public final class Einkreisen erweitert Objekt

Ein Kreis auf der Erdoberfläche (Kugelkappe).

Ein Kreis hat folgende Eigenschaften.

Mitte: Der Mittelpunkt des Kreises wird als LatLng angegeben.
Radius: Der Radius des Kreises, angegeben in Metern. Der Wert sollte null oder größer sein.
Strichbreite: Die Breite der Kreislinie in Bildschirmpixeln. Die Breite ist konstant und unabhängig Zoomstufe der Kamera anpassen. Der Standardwert ist 10.
Strichfarbe: Die Farbe des Kreisumrisses im ARGB-Format, das auch von Color verwendet wird. Der Standardwert ist Schwarz (0xff000000).
Strichmuster: Durchgängig (Standard, dargestellt durch null) oder eine Folge von PatternItem-Objekten entlang des Umrisses des Kreises zu wiederholen. Verfügbare PatternItem-Typen: Gap (definiert durch die Lückenlänge in Pixeln), Dash (definiert durch die Strichbreite und Strichlänge in Pixel) und Dot (kreisförmig, zentriert auf dem Umriss des Kreises, Durchmesser definiert durch Strichbreite in Pixeln).
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 im Verhältnis zu anderen Overlays gezeichnet wird (einschließlich GroundOverlay s, TileOverlay s, Polyline s und Polygon s, aber und nicht Markers). Ein Overlay mit einem größeren Z-Index wird über Overlays mit kleineren z-Indizes. 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, also ob er auf der Karte gezeichnet wurde. Eine unsichtbarer Kreis wird nicht gezeichnet, behält aber alle anderen Eigenschaften bei. Die Standardeinstellung ist true, also sichtbar.
Tag: Ein Object, das mit dem Kreis verknüpft ist. Object kann beispielsweise Folgendes enthalten: was der Kreis darstellt. Das ist einfacher als das Speichern einer separaten Map<Circle, Object>. Ein weiteres Beispiel: Du kannst eine String-ID der ID aus einem Datensatz entspricht. Google Maps SDK for Android kann weder lesen noch schreibt diese Property.

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

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

Entwicklerleitfaden

Weitere Informationen finden Sie auf der Website des Shapes-Entwicklers. .

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.
double	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.
Object	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 von der Karte.
void	setCenter(LatLng-Zentrum) Legt den Mittelpunkt mithilfe eines `LatLng` fest.
void	setClickable(boolesch anklickbar) Legt die Anklickbarkeit des Kreises fest.
void	setFillColor(int color) 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 der Kreislinie fest.
void	setStrokeWidth(Gleitkommabreite) Legt die Strichbreite fest.
void	setTag(Objekt-Tag) Legt das Tag für den Kreis fest.
void	setVisible(boolean visible) Legt die Sichtbarkeit des Kreises fest.
void	setZIndex(Gleitkommazahl zIndex) Legt den zIndex fest.

Inherited Method Summary

From class java.lang.Object

boolean	equals(Objekt arg0)
letzte Klasse<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

<ph type="x-smartling-placeholder"></ph> öffentlich LatLng getCenter ()

Gibt den Mittelpunkt als LatLng zurück.

Gibt Folgendes zurück:

Der geografische Mittelpunkt als LatLng.

<ph type="x-smartling-placeholder"></ph> öffentlich Ganzzahl getFillColor ()

Gibt die Füllfarbe dieses Kreises zurück

Gibt Folgendes zurück:

Die Füllfarbe des Kreises im ARGB-Format.

<ph type="x-smartling-placeholder"></ph> öffentlich Zeichenfolge getId ()

Ruft die ID dieses Kreises ab. Diese ID ist für alle Kreise auf einer Karte eindeutig.

<ph type="x-smartling-placeholder"></ph> öffentlich Double getRadius ()

Gibt den Radius des Kreises in Metern zurück.

Gibt Folgendes zurück:

Der Radius in Metern.

<ph type="x-smartling-placeholder"></ph> öffentlich Ganzzahl getStrokeColor ()

Gibt die Strichfarbe zurück.

Gibt Folgendes zurück:

Die Farbe des Kreises im ARGB-Format.

<ph type="x-smartling-placeholder"></ph> öffentlich List<PatternItem> > getStrokePattern ()

Gibt das Strichmuster des Umrisses dieses Kreises zurück.

Gibt Folgendes zurück:

Strichmuster an.

<ph type="x-smartling-placeholder"></ph> öffentlich schweben getStrokeWidth ()

Gibt die Strichbreite zurück.

Gibt Folgendes zurück:

Die Breite in Bildschirmpixeln.

<ph type="x-smartling-placeholder"></ph> öffentlich Objekt getTag ()

Ruft das Tag für den Kreis ab

Gibt Folgendes zurück:

das Tag, wenn ein Tag mit setTag festgelegt wurde null, wenn kein Tag festgelegt wurde.

<ph type="x-smartling-placeholder"></ph> öffentlich schweben getZIndex ()

Gibt den zIndex zurück.

Gibt Folgendes zurück:

Der zIndex dieses Kreises

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert isClickable ()

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

Gibt Folgendes zurück:

true, wenn der Kreis anklickbar ist false, wenn es nicht anklickbar ist.

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert isVisible ()

Überprüft, ob der Kreis sichtbar ist.

Gibt Folgendes zurück:

true, wenn der Kreis sichtbar ist; false, wenn er unsichtbar ist.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm entfernen ()

Entfernt diesen Kreis von der Karte. Nachdem ein Kreis entfernt wurde, sind nicht definiert.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setCenter (LatLng Mitte)

Legt den Mittelpunkt mithilfe eines LatLng fest.

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

Parameter

Center	Der geografische Mittelpunkt des Kreises, angegeben als `LatLng`.

Löst aus

NullPointerException	wenn Mittelpunkt null ist

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setClickable (Boolescher Wert anklickbar)

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

Parameter

Anklickbar	Neue Anklickbarkeitseinstellung für den Kreis.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setFillColor (int color)

Legt die Füllfarbe fest.

Die Füllfarbe ist die Farbe innerhalb des Kreises im durch Color festgelegten Ganzzahlformat. Bei TRANSPARENT wird keine Füllung gezeichnet.

Parameter

Farbe	Die Farbe im Format `Color`.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm 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	wenn Radius negativ ist

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setStrokeColor (int color)

Legt die Strichfarbe fest.

Die Strichfarbe ist die Farbe der Umrisslinie dieses Kreises im durch Color Bei TRANSPARENT wird kein Umriss gezeichnet.

Parameter

Farbe	Die Strichfarbe im Format `Color`.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setStrokePattern (List<PatternItem> Muster)

Legt das Strichmuster der Kreislinie fest. Das Standardmuster der Striche ist „Durchgängig“, dargestellt durch null.

Parameter

Muster	Strichmuster an.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setStrokeWidth (Breite Gleitkommazahl)

Legt die Strichbreite fest.

Die Strichbreite ist die Breite des Kreisumrisses in Bildschirmpixeln. Er muss null sein oder größer sein. Bei Null wird kein Umriss gezeichnet. Der Standardwert ist 10.

Parameter

Breite	Die Strichbreite in Bildschirmpixeln.

Löst aus

IllegalArgumentException	wenn die Breite negativ ist

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setTag (Objekt-Tag)

Legt das Tag für den Kreis fest.

Mit dieser Eigenschaft können Sie eine beliebige Object mit diesem Kreis verknüpfen. Für Beispiel: Object kann Daten darüber enthalten, was der Kreis repräsentiert. Das ist einfacher als separate Map<Circle, Object> speichern. Als weiteres Beispiel können Sie String ID, die der ID aus einem Datensatz entspricht. Google Maps SDK for Android weder liest oder schreibt diese Eigenschaft. Sie sind dafür verantwortlich, setTag(null) anzurufen, um wenn Sie es nicht mehr benötigen, um Speicherlecks in Ihrer App zu vermeiden.

Parameter

Tag	Wenn null, wird das Tag gelöscht.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setVisible (Boolescher Wert sichtbar)

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; `false`, um ihn unsichtbar zu machen.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setZIndex (ZIndex als Gleitkommazahl)

Legt den zIndex fest.

Überlagerungen (wie Kreise) mit höheren zIndices werden über solche mit niedrigeren Indizes gezeichnet.

Parameter

zIndex	Der zIndex-Wert.