Polylinie

public final class Polyline erweitert Objekt

Eine Polylinie ist eine Liste von Punkten, wobei zwischen aufeinanderfolgenden Punkten Liniensegmente gezeichnet werden. A Polylinie hat die folgenden Eigenschaften:

Punkte
Die Eckpunkte der Linie. Zwischen aufeinanderfolgenden Punkten werden Liniensegmente gezogen. Eine Polylinie ist nicht standardmäßig geschlossen; Um eine geschlossene Polylinie zu bilden, müssen die Start- und Endpunkte ist das Gleiche.
Breite
Liniensegmentbreite in Bildschirmpixeln. Die Breite ist konstant und unabhängig von der Zoomstufe. Der Standardwert ist 10.
Farbe
Farbe des Liniensegments im ARGB-Format, das auch von Color verwendet wird. Der Standardwert ist Schwarz (0xff000000).
Start-/Endbanner
Definiert die Form, die am Anfang oder Ende einer Polylinie verwendet werden soll. Unterstützte Begrenzungstypen: ButtCap, SquareCap, RoundCap (gilt für durchgehendes Strichmuster) und CustomCap (gilt für jedes Strichmuster). Standardeinstellung für Start und Ende: ButtCap
Verbindungstyp
Der Verbindungstyp bestimmt die Form, die verwendet werden soll, wenn benachbarte Liniensegmente verbunden werden Eckpunkte der Polylinie außer den Start- und Endeckpunkten. JointType ansehen für unterstützten Verbindungstypen. Der Standardwert ist DEFAULT.
Strichmuster
Durchgängig (Standard, dargestellt durch null) oder eine Folge von PatternItem-Objekten entlang der Linie wiederholt werden. Verfügbare PatternItem-Typen: Gap (definiert durch Abstandslänge in Pixeln), Dash (definiert durch Linienbreite und Strichlänge in Pixeln) und Dot (kreisförmig, zentriert auf der Linie, Durchmesser definiert durch die Linienbreite in Pixeln).
Z-Index
Die Reihenfolge, in der dieses Kachel-Overlay im Verhältnis zu anderen Overlays gezeichnet wird (einschließlich GroundOverlay s, TileOverlay s, Circle s und Polygon s, aber 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 eine Polylinie sichtbar oder unsichtbar ist, also ob sie auf der Karte gezeichnet wurde. Eine unsichtbare Polylinie wird nicht gezeichnet, behält aber alle anderen Eigenschaften bei. Die Standardeinstellung ist true, also sichtbar.
Geodätischer Status
Gibt an, ob die Segmente der Polylinie geodätisch und nicht als gerade Linien auf der Mercator-Projektion an. Eine Geodäte ist der kürzeste Weg zwischen zwei auf der Erdoberfläche. Die geodätische Kurve wird unter der Annahme konstruiert, dass es sich bei der Erde um eine Kugel
Anklickbarkeit
Wenn Sie Ereignisse verarbeiten möchten, die ausgelöst werden, wenn der Nutzer auf die Polylinie klickt, setzen Sie diese Eigenschaft auf true. Sie können diesen Wert jedoch jederzeit ändern. Der Standardwert ist false. Wenn dieses auf true gesetzt ist, erhält deine App Benachrichtigungen an die GoogleMap.OnPolylineClickListener, die über setOnPolylineClickListener(GoogleMap.OnPolylineClickListener) registriert sind.
Tag
Eine Object, die der Polylinie zugeordnet ist. Object kann beispielsweise Folgendes enthalten: Daten zur Darstellung der Polylinie. Das ist einfacher als das Speichern einer separaten Map<Polyline, 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.
Spans
Definiert die Spans mit verschiedenen Stilen, die zum Rendern dieser Polylinie verwendet werden. Sie können diese können Sie eine Polylinie mit unterschiedlichen StrokeStyle-Werten für verschiedene Segmente von die Polylinie.

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 thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));
 

Entwicklerleitfaden

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

Public Method Summary

boolean
ist gleich(anderes Objekt)
Prüft, ob dieser Polyline gleich einer anderen ist.
int
getColor()
Ruft die Farbe dieser Polylinie ab.
Kappe
getEndCap()
Ruft die Kappe am Endeckpunkt dieser Polylinie ab.
String
getId()
Ruft die ID dieser Polylinie ab.
int
getJointType()
Ruft den Verbindungstyp ab, der für alle Eckpunkte der Polylinie verwendet wird, mit Ausnahme der Start- und Endeckpunkte.
List< PatternItem>
getPattern()
Ruft das Strichmuster dieser Polylinie ab.
List<LatLng>
getPoints()
Gibt einen Snapshot der Eckpunkte dieser Polylinie zu diesem Zeitpunkt zurück .
Kappe
getStartCap()
Ruft das Cap am Start-Scheitelpunkt dieser Polylinie ab.
Object
getTag()
Ruft das Tag für die Polylinie ab.
float
getWidth()
Ruft die Breite dieser Polylinie ab.
float
getZIndex()
Ruft den zIndex dieser Polylinie ab.
int
boolean
isClickable()
Ruft die Anklickbarkeit der Polylinie ab.
boolean
isGeodesic()
Ruft ab, ob jedes Segment der Linie geodätisch gezeichnet ist oder nicht.
boolean
isVisible()
Ruft die Sichtbarkeit dieser Polylinie ab.
void
remove()
Entfernt diese Polylinie aus der Karte.
void
setClickable(boolesch anklickbar)
Legt die Anklickbarkeit der Polylinie fest.
void
setColor(int-Farbe)
Legt die Farbe dieser Polylinie fest.
void
setEndCap(Cap endCap)
Legt das Kappen am Ende des Scheitelpunkts dieser Polylinie fest.
void
setGeodesic(boolean geodesic)
Legt fest, ob jedes Segment der Linie geodätisch gezeichnet werden soll oder nicht.
void
setJointType(int joinType)
Legt den Verbindungstyp für alle Eckpunkte der Polylinie außer den Start- und Endeckpunkten fest.
void
setPattern(List<PatternItem> Muster)
Legt das Strichmuster der Polylinie fest.
void
setPoints(List<LatLng> Punkte)
Legt die Punkte dieser Polylinie fest.
void
setSpans(List<StyleSpan>-Spans)
Legt die Spans der Polylinie fest.
void
setStartCap(Cap startCap)
Legt das Cap am Startscheitelpunkt dieser Polylinie fest.
void
setTag(Objekt-Tag)
Legt das Tag für die Polylinie fest.
void
setVisible(boolean visible)
Legt die Sichtbarkeit dieser Polylinie fest.
void
setWidth(Breite Gleitkommazahl)
Legt die Breite dieser Polylinie fest.
void
setZIndex(Gleitkommazahl zIndex)
Legt den zIndex dieser Polylinie fest.

Inherited Method Summary

Public Methods

<ph type="x-smartling-placeholder"></ph> öffentlich Boolescher Wert ist gleich (Anderes Objekt)

Prüft, ob dieser Polyline gleich einer anderen ist.

Parameter
Weitere ein Object.
Gibt Folgendes zurück:
  • "true", wenn beide Objekte dasselbe Objekt sind, d. h. dies == other.

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

Ruft die Farbe dieser Polylinie ab.

Gibt Folgendes zurück:
  • die Farbe im ARGB-Format.

<ph type="x-smartling-placeholder"></ph> öffentlich Kap. getEndCap ()

Ruft die Kappe am Endeckpunkt dieser Polylinie ab.

Gibt Folgendes zurück:
  • den Endbannertyp.

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

Ruft die ID dieser Polylinie ab. Die ID ist unter allen Polylinien auf einer Karte eindeutig.

Gibt Folgendes zurück:
  • ID dieser Polylinie.

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

Ruft den Verbindungstyp ab, der für alle Eckpunkte der Polylinie verwendet wird, mit Ausnahme der Start- und Endeckpunkte. Weitere Informationen finden Sie unter JointType für mögliche Werte.

Gibt Folgendes zurück:
  • den Join-Typ.

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

Ruft das Strichmuster dieser Polylinie ab.

Gibt Folgendes zurück:
  • Strichmuster an.

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

Gibt einen Snapshot der Eckpunkte dieser Polylinie zu diesem Zeitpunkt zurück . Die zurückgegebene Liste ist eine Kopie der Liste mit Scheitelpunkten. Daher werden Änderungen an den Scheitelpunkten der Polylinie hier nicht berücksichtigt. noch werden Änderungen an dieser Liste von der Polylinie wiedergegeben. Um die Scheitelpunkte des Polylinienzug setPoints(List).

<ph type="x-smartling-placeholder"></ph> öffentlich Kap. getStartCap ()

Ruft das Cap am Start-Scheitelpunkt dieser Polylinie ab.

Gibt Folgendes zurück:
  • die Startkapitalisierung.

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

Ruft das Tag für die Polylinie 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 getWidth ()

Ruft die Breite dieser Polylinie ab.

Gibt Folgendes zurück:
  • die Breite in Bildschirmpixeln.

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

Ruft den zIndex dieser Polylinie ab.

Gibt Folgendes zurück:
  • zIndex der Polylinie.

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

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

Ruft die Anklickbarkeit der Polylinie ab. Wenn die Polylinie anklickbar ist, empfängt Ihre App Benachrichtigungen an GoogleMap.OnPolylineClickListener gesendet, wenn der Nutzer auf Polylinie. Der Event-Listener wird über setOnPolylineClickListener(GoogleMap.OnPolylineClickListener) registriert.

Gibt Folgendes zurück:
  • true, wenn die Polylinie anklickbar ist; Andernfalls wird false zurückgegeben.

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

Ruft ab, ob jedes Segment der Linie geodätisch gezeichnet ist oder nicht.

Gibt Folgendes zurück:
  • true, wenn jedes Segment als Geodäte gezeichnet ist; false, wenn jedes Segment auf der Mercator-Projektion als gerade Linie gezeichnet werden.

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

Ruft die Sichtbarkeit dieser Polylinie ab.

Gibt Folgendes zurück:
  • Sichtbarkeit dieser Polylinie.

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

Entfernt diese Polylinie aus der Karte. Nachdem eine Polylinie entfernt wurde, ist das Verhalten aller ihrer sind nicht definiert.

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

Legt die Anklickbarkeit der Polylinie fest. Wenn die Polylinie anklickbar ist, empfängt Ihre App Benachrichtigungen an GoogleMap.OnPolylineClickListener gesendet, wenn der Nutzer auf Polylinie. Der Event-Listener wird über setOnPolylineClickListener(GoogleMap.OnPolylineClickListener) registriert.

Parameter
Anklickbar Neue Anklickbarkeitseinstellung für die Polylinie.

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

Legt die Farbe dieser Polylinie fest.

Parameter
Farbe die Farbe im ARGB-Format

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

Legt das Kappen am Ende des Scheitelpunkts dieser Polylinie fest. Das standardmäßige Endbanner ist ButtCap.

Parameter
endCap das Endbanner. Darf nicht null sein.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setGeodesic (boolesch geodätisch)

Legt fest, ob jedes Segment der Linie geodätisch gezeichnet werden soll oder nicht.

Parameter
geodesic bei true wird jedes Segment als Geodäte gezeichnet. wenn false, Jedes Segment wird auf der Mercator-Projektion als gerade Linie gezeichnet.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setJointType (int joinType).

Legt den Verbindungstyp für alle Eckpunkte der Polylinie außer den Start- und Endeckpunkten fest.

Zulässige Werte finden Sie unter JointType. Der Standardwert DEFAULT wird verwendet, wenn der Verbindungstyp nicht definiert ist oder nicht zu den zulässigen Werten gehört.

Parameter
jointType den Join-Typ.

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

Legt das Strichmuster der Polylinie fest. Das Standardstrichmuster ist ausgefüllt, dargestellt durch null

Parameter
Muster Strichmuster an.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setPoints (List<LatLng>-Punkte)

Legt die Punkte dieser Polylinie fest. Bei dieser Methode wird eine Kopie der Punkte verwendet. Mutationen von points haben keine Auswirkungen auf diese Polylinie.

Parameter
Punkte Eine Liste von LatLngs, die die Eckpunkte der Polylinie sind.

<ph type="x-smartling-placeholder"></ph> öffentlich voidm setSpans (List<StyleSpan>-Spans)

Legt die Spans der Polylinie fest.

Parameter
Spans

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

Legt das Cap am Startscheitelpunkt dieser Polylinie fest. Standardmäßig ist das Limit ButtCap.

Parameter
startCap die Startkapitalisierung. Darf nicht null sein.

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

Legt das Tag für die Polylinie fest.

Mit dieser Eigenschaft können Sie eine beliebige Object mit dieser Polylinie verknüpfen. Für Object kann beispielsweise Daten über die Polylinie enthalten. Das ist einfacher als separate Map<Polyline, 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 dieser Polylinie fest. Ist sie nicht sichtbar, wird eine Polylinie nicht gezeichnet, mit allen anderen Eigenschaften.

Parameter
sichtbar Wenn true, ist die Polylinie sichtbar. Wenn false, trifft dies nicht zu.

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

Legt die Breite dieser Polylinie fest.

Parameter
Breite Breite in Bildschirmpixeln

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

Legt den zIndex dieser Polylinie fest. Polylinien mit höheren zIndices werden über denen mit niedrigere Indizes.

Parameter
zIndex zIndex dieser Polylinie.