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) undCustomCap
(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 istDEFAULT
. - Strichmuster
- Durchgängig (Standard, dargestellt durch
null
) oder eine Folge vonPatternItem
-Objekten entlang der Linie wiederholt werden. VerfügbarePatternItem
-Typen:Gap
(definiert durch Abstandslänge in Pixeln),Dash
(definiert durch Linienbreite und Strichlänge in Pixeln) undDot
(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 undPolygon
s, aber nichtMarker
s). 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 istfalse
. Wenn dieses auftrue
gesetzt ist, erhält deine App Benachrichtigungen an dieGoogleMap.OnPolylineClickListener
, die übersetOnPolylineClickListener(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 separatenMap<Polyline, Object>
. Ein weiteres Beispiel: Du kannst eineString
-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 |
hashCode()
|
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 | |
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 | |
void | |
void | |
void | |
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)
<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 wurdenull
, 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 wirdfalse
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 LatLng s, 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. |
---|