Eine Polylinie ist eine Liste von Punkten, wobei Liniensegmente zwischen aufeinanderfolgenden Punkten gezeichnet werden. Polylinien haben folgende Eigenschaften:
- Punkte
- Die Eckpunkte der Linie. Zwischen aufeinanderfolgenden Punkten werden Liniensegmente gezeichnet. Eine Polylinie ist nicht standardmäßig geschlossen. Um eine geschlossene Polylinie zu bilden, müssen die Start- und Endpunkte identisch sein.
- Breite
- Breite des Liniensegments in Bildschirmpixeln. Die Breite ist konstant und unabhängig von der Zoomstufe der Kamera. Der Standardwert ist 10.
- Farbe
- Farbe des Liniensegments im ARGB-Format, dasselbe Format, das auch von
Color
verwendet wird Der Standardwert ist Schwarz (0xff000000
). - Start- und Endbanner
- Definiert die Form, die am Anfang oder Ende einer Polylinie verwendet werden soll. Unterstützte Begrenzungstypen:
ButtCap
,SquareCap
,RoundCap
(gilt für durchgezogene Strichmuster) undCustomCap
(gilt für alle Strichmuster). Standardwert für Start und Ende:ButtCap
. - Verbindungstyp
- Der Verbindungstyp definiert die Form, die beim Verbinden benachbarter Liniensegmente an allen Eckpunkten der Polylinie, mit Ausnahme der Eckpunkte von Anfang und Ende, verwendet werden soll. Informationen zu unterstützten Verbindungstypen finden Sie unter
JointType
. Der Standardwert istDEFAULT
. - Strichmuster
- Durchgängig (Standard, dargestellt durch
null
) oder eine Abfolge vonPatternItem
-Objekten, die entlang der Linie wiederholt werden sollen. VerfügbarePatternItem
-Typen:Gap
(definiert durch die Abstandslänge in Pixeln),Dash
(definiert durch die Linienbreite und die Strichlänge in Pixeln) undDot
(kreisförmig, auf der Linie zentriert, Durchmesser durch Linienbreite in Pixeln definiert). - Z-Index
- Die Reihenfolge, in der dieses Kachel-Overlay in Bezug auf andere Overlays gezeichnet wird (einschließlich
GroundOverlay
s,TileOverlay
s,Circle
s undPolygon
s, aber nichtMarker
s). 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 die Polylinie sichtbar oder unsichtbar ist, d.h., ob sie auf der Karte eingezeichnet wird. Eine unsichtbare Polylinie wird nicht gezeichnet, behält aber alle anderen Eigenschaften bei. Der Standardwert ist
true
, d.h. sichtbar. - Geodätischer Status
- Gibt an, ob die Segmente der Polylinie als geodätische Linien und nicht als gerade Linien in der Mercator-Projektion gezeichnet werden sollen. Eine Geodäte ist der kürzeste Weg zwischen zwei Punkten auf der Erdoberfläche. Die geodätische Kurve wird unter der Annahme, dass die Erde eine Kugel ist, konstruiert.
- Anklickbarkeit
- Wenn Ereignisse verarbeitet werden sollen, die ausgelöst werden, wenn der Nutzer auf die Polylinie klickt, legen Sie dieses Attribut auf
true
fest. Sie können diesen Wert jedoch jederzeit ändern. Der Standardwert istfalse
. Wenn dieses Attribut auftrue
gesetzt ist, erhält deine App Benachrichtigungen an dieGoogleMap.OnPolylineClickListener
, die übersetOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
registriert sind. - Taggen
- Ein
Object
, der mit der Polylinie verknüpft ist. Beispielsweise kannObject
Daten darüber enthalten, was die Polylinie darstellt. Dies ist einfacher als das Speichern einer separatenMap<Polyline, 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. - Spans
- Definiert die Spannen mit verschiedenen Stilen, die zum Rendern dieser Polylinie verwendet werden. Mit dieser Eigenschaft können Sie eine Polylinie mit unterschiedlichen
StrokeStyle
für verschiedene Segmente der Polylinie erstellen.
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 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 im Entwicklerleitfaden für Formen.
Public Method Summary
boolean |
ist gleich(Sonstiges Objekt)
Testet, ob diese
Polyline einem anderen entspricht. |
int |
getColor()
Ruft die Farbe der Polylinie ab.
|
Obergrenze |
getEndCap()
Ruft den Abschluss am Endscheitelpunkt dieser Polylinie ab.
|
String |
getId()
Ruft die ID dieser Polylinie ab.
|
int |
getJointType()
Ruft den Verbindungstyp ab, der für alle Eckpunkte der Polylinie mit Ausnahme der Anfangs- und Endeckpunkte verwendet wird.
|
List<PatternItem> |
getPattern()
Ruft das Strichmuster der Polylinie ab.
|
List<LatLng> |
getPoints()
Gibt zu diesem Zeitpunkt einen Snapshot der Scheitelpunkte dieser Polylinie zurück .
|
Obergrenze |
getStartCap()
Ruft den Cap am Anfangsscheitelpunkt dieser Polylinie ab.
|
Objekt |
getTag()
Ruft das Tag für die Polylinie ab.
|
float |
getWidth()
Ruft die Breite der Polylinie ab.
|
float |
getZIndex()
Ruft den zIndex dieser Polylinie ab.
|
int |
hashCode()
|
boolean |
isClickable()
Ruft die Anklickbarkeit der Polylinie ab.
|
boolean |
isGeodesic()
Ruft ab, ob die einzelnen Segmente der Linie geodätisch gezeichnet wurden.
|
boolean |
isVisible()
Ruft die Sichtbarkeit dieser Polylinie ab.
|
void |
remove()
Entfernt diese Polylinie aus der Karte.
|
void |
setClickable(boolesch klickbar)
Legt die Anklickbarkeit der Polylinie fest.
|
void |
setColor(int-Farbe)
Legt die Farbe der Polylinie fest.
|
void | |
void |
setGeodesic(boolesch geodätisch)
Legt fest, ob die einzelnen Segmente der Linie geodätisch gezeichnet werden sollen.
|
void |
setJointType(int JoinType)
Legt den Verbindungstyp für alle Eckpunkte der Polylinie mit Ausnahme der Anfangs- und Endeckpunkte fest.
|
void | |
void | |
void | |
void | |
void |
setTag(Objekt-Tag)
Legt das Tag für die Polylinie fest.
|
void |
setVisible(boolesch sichtbar)
Legt die Sichtbarkeit dieser Polylinie fest.
|
void |
setWidth(Gleitkommazahl)
Legt die Breite der Polylinie fest.
|
void |
setZIndex(Gleitkommazahl zIndex)
Legt den zIndex dieser Polylinie fest.
|
Inherited Method Summary
Public Methods
public boolesch ist gleich (Objekt anderes)
public int getColor ()
Ruft die Farbe der Polylinie ab.
Rückgaben
- die Farbe im ARGB-Format.
public Cap getEndCap ()
Ruft den Abschluss am Endscheitelpunkt dieser Polylinie ab.
Rückgaben
- als Endbanner.
public String getId ()
Ruft die ID dieser Polylinie ab. Die ID ist für alle Polylinien auf einer Karte eindeutig.
Rückgaben
- die ID dieser Polylinie.
public int getJointType ()
Ruft den Verbindungstyp ab, der für alle Eckpunkte der Polylinie mit Ausnahme der Anfangs- und Endeckpunkte verwendet wird. Mögliche Werte siehe JointType
.
Rückgaben
- den Verbindungstyp.
public List<PatternItem> getPattern ()
Ruft das Strichmuster der Polylinie ab.
Rückgaben
- des Strichmusters.
public List<LatLng> getPoints ()
Gibt zu diesem Zeitpunkt einen Snapshot der Scheitelpunkte dieser Polylinie zurück . Die zurückgegebene Liste ist eine Kopie der Liste der Eckpunkte. Änderungen an den Eckpunkten der Polylinie wirken sich daher weder auf diese Liste noch auf Änderungen an dieser Liste aus. Um die Scheitelpunkte der Polylinie zu ändern, rufen Sie setPoints(List)
auf.
public Cap getStartCap ()
Ruft den Cap am Anfangsscheitelpunkt dieser Polylinie ab.
Rückgaben
- das Startlimit.
public Objekt getTag ()
Ruft das Tag für die Polylinie ab.
Rückgaben
- das Tag, wenn ein Tag mit
setTag
festgelegt wurde;null
, wenn kein Tag festgelegt wurde.
public float getWidth ()
Ruft die Breite der Polylinie ab.
Rückgaben
- die Breite in Bildschirmpixeln.
public float getZIndex ()
Ruft den zIndex dieser Polylinie ab.
Rückgaben
- zIndex der Polylinie.
public int hashCode ()
public boolesch isClickable ()
Ruft die Anklickbarkeit der Polylinie ab. Wenn die Polylinie anklickbar ist, erhält deine App Benachrichtigungen an GoogleMap.OnPolylineClickListener
, wenn der Nutzer auf die Polylinie klickt. Der Event-Listener wird über setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
registriert.
Rückgaben
true
, wenn die Polylinie anklickbar ist. Andernfalls wirdfalse
zurückgegeben.
public boolean isGeodesic ()
Ruft ab, ob die einzelnen Segmente der Linie geodätisch gezeichnet wurden.
Rückgaben
true
, wenn jedes Segment als Geodäte gezeichnet wird;false
, wenn jedes Segment als gerade Linie in der Mercator-Projektion gezeichnet wird.
public boolesch isVisible ()
Ruft die Sichtbarkeit dieser Polylinie ab.
Rückgaben
- die Sichtbarkeit dieser Polylinie ändern.
public void entfernen ()
Entfernt diese Polylinie aus der Karte. Nachdem eine Polylinie entfernt wurde, ist das Verhalten all ihrer Methoden nicht mehr definiert.
public void setClickable (boolesch klickbar)
Legt die Anklickbarkeit der Polylinie fest. Wenn die Polylinie anklickbar ist, erhält deine App Benachrichtigungen an GoogleMap.OnPolylineClickListener
, wenn der Nutzer auf die Polylinie klickt. Der Event-Listener wird über setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
registriert.
Parameter
Anklickbar | Neue Einstellung für die Anklickbarkeit der Polylinie. |
---|
public void setColor (int color)
Legt die Farbe der Polylinie fest.
Parameter
Farbe | die Farbe im ARGB-Format |
---|
public void setEndCap (Cap endCap)
Legt den Abschluss am Ende der Polylinie fest. Der standardmäßige Endbanner ist ButtCap
.
Parameter
endCap | das Endbanner. Darf nicht null sein.
|
---|
public void setGeodesic (boolean geodesic)
Legt fest, ob die einzelnen Segmente der Linie geodätisch gezeichnet werden sollen.
Parameter
geodesic | Bei true wird jedes Segment als Geodäte gezeichnet. Bei false wird jedes Segment als gerade Linie in der Mercator-Projektion gezeichnet.
|
---|
public void setJointType (int joinType)
Legt den Verbindungstyp für alle Eckpunkte der Polylinie mit Ausnahme der Anfangs- und Endeckpunkte fest.
Zulässige Werte finden Sie unter JointType
. Wenn der Verbindungstyp nicht definiert ist oder keiner der zulässigen Werte ist, wird der Standardwert DEFAULT
verwendet.
Parameter
jointType | den Verbindungstyp. |
---|
public void setPattern (List<PatternItem>-Muster)
Legt das Strichmuster der Polylinie fest. Das Standardstrichmuster ist ausgefüllt und wird durch null
dargestellt.
Parameter
Muster | des Strichmusters. |
---|
public void setPoints (List<LatLng>-Punkte)
Legt die Punkte dieser Polylinie fest. Diese Methode verwendet eine Kopie der Punkte, sodass weitere Mutationen an points
keine Auswirkungen auf die Polylinie haben.
Parameter
Punkte | Eine Liste von LatLng s, die die Scheitelpunkte der Polylinie sind.
|
---|
public void setSpans (List<StyleSpan> spans)
Legt die Überbrückungen der Polylinie fest.
Parameter
Spans |
---|
public void setStartCap (Cap startCap)
Legt den Abschluss am Anfangseckpunkt dieser Polylinie fest. Die standardmäßige Startobergrenze ist ButtCap
.
Parameter
startCap | das Startlimit. Darf nicht null sein.
|
---|
public void setTag (Objekt-Tag)
Legt das Tag für die Polylinie fest.
Du kannst diese Eigenschaft verwenden, um eine beliebige Object
mit dieser Polylinie zu verknüpfen. Beispielsweise kann Object
Daten darüber enthalten, was die Polylinie darstellt. Dies ist einfacher als das Speichern einer separaten Map<Polyline, 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 dieser Polylinie fest. Wenn sie nicht sichtbar ist, wird eine Polylinie nicht gezeichnet, alle anderen Eigenschaften werden jedoch beibehalten.
Parameter
sichtbar | Bei true ist die Polylinie sichtbar, bei false jedoch nicht.
|
---|
public void setWidth (Gleitkommabreite)
Legt die Breite der Polylinie fest.
Parameter
width | Breite in Bildschirmpixeln |
---|
public void setZIndex (Gleitkomma zIndex)
Legt den zIndex dieser Polylinie fest. Polylinien mit höheren zIndizes werden über denen mit niedrigeren Indizes gezeichnet.
Parameter
zIndex | zIndex dieser Polylinie. |
---|