Polyline

La classe publique finale Polyline étend l'objet

Une polyligne est une liste de points, où des segments de ligne sont tracés entre des points consécutifs. Une polyligne possède les propriétés suivantes:

Points
aux sommets de la ligne. Des segments de ligne sont tracés entre des points consécutifs. Une polyligne n'est pas fermée par défaut. Pour former une polyligne fermée, les points de début et de fin doivent être identiques.
Largeur
Largeur du segment de ligne en pixels de l'écran. La largeur est constante et indépendante du niveau de zoom de la caméra. La valeur par défaut est 10.
Couleur
Couleur des segments de ligne au format ARVB (format utilisé par Color). La valeur par défaut est le noir (0xff000000).
Image de début/fin
Définit la forme à utiliser au début ou à la fin d'une polyligne. Types de majuscules acceptés: ButtCap, SquareCap, RoundCap (applicable au motif de trait plein) et CustomCap (applicable à tout motif de trait). Valeur par défaut pour le début et la fin : ButtCap.
Type de jointure
Le type de jointure définit la forme à utiliser lors de la jointure de segments de ligne adjacents à tous les sommets de la polyligne, à l'exception des sommets de début et de fin. Consultez la section JointType pour connaître les types de jointures compatibles. La valeur par défaut est DEFAULT.
Motif du trait
Plein (par défaut, représenté par null) ou séquence d'objets PatternItem à répéter le long de la ligne. Types de PatternItem disponibles: Gap (défini par la longueur de l'espace en pixels), Dash (défini par l'épaisseur de la ligne et la longueur du tiret en pixels) et Dot (circulaire, centré sur la ligne, diamètre défini par l'épaisseur de la ligne en pixels).
z-index
Ordre dans lequel cette superposition de tuiles est dessinée par rapport aux autres superpositions (y compris les GroundOverlay, TileOverlay, Circle et Polygon, mais pas les Marker). Une superposition avec un z-index plus grand apparaît sur des superpositions comportant des z-indices plus petits. L'ordre des superpositions ayant le même z-index est arbitraire. Le zIndex par défaut est 0.
Visibilité
Indique si la polyligne est visible ou invisible, c'est-à-dire si elle est dessinée sur la carte. Une polyligne invisible n'est pas dessinée, mais conserve toutes ses autres propriétés. La valeur par défaut est true, c'est-à-dire visible.
État géodésique
Indique si les segments de la polyligne doivent être dessinés sous forme de géodésiques, par opposition aux lignes droites sur la projection de Mercator. Une géodésique est le tracé le plus court entre deux points sur la surface de la Terre. La courbe géodésique est construite en supposant que la Terre est une sphère.
Cliquabilité
Si vous souhaitez gérer les événements déclenchés lorsque l'utilisateur clique sur la polyligne, définissez cette propriété sur true. Vous pouvez modifier cette valeur à tout moment. La valeur par défaut est false. Si cette propriété est définie sur true, votre application recevra des notifications au GoogleMap.OnPolylineClickListener enregistré via setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).
Tag
Object associé à la polyligne. Par exemple, Object peut contenir des données sur ce que la polyligne représente. Cette opération est plus facile que de stocker un élément Map<Polyline, Object> distinct. Autre exemple, vous pouvez associer un ID String correspondant à l'ID d'un ensemble de données. Le SDK Google Maps pour Android ne lit ni n'écrit cette propriété.
Segments
Définit les intervalles avec différents styles utilisés pour afficher cette polyligne. Vous pouvez utiliser cette propriété pour créer une polyligne avec différentes StrokeStyle sur différents segments de la polyligne.

Les méthodes de cette classe doivent être appelées sur le thread UI Android. Dans le cas contraire, une exception IllegalStateException est générée au moment de l'exécution.

Exemple

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

Guide du développeur

Pour en savoir plus, consultez le guide du développeur Shapes.

Récapitulatif des méthodes publiques

boolean
est égal à(autre objet)
Vérifie si cet élément Polyline est égal à un autre.
int
getColor()
Récupère la couleur de cette polyligne.
Casquette
getEndCap()
Récupère l'extrémité au sommet final de cette polyligne.
Chaîne
getId()
Récupère l'ID de cette polyligne.
int
getJointType()
Récupère le type de jointure utilisé à tous les sommets de la polyligne, à l'exception des sommets de début et de fin.
List<PatternItem>
getPattern()
Récupère le motif du trait de cette polyligne.
List<LatLng>
getPoints()
Renvoie un instantané des sommets de cette polyligne à l'instant T .
Casquette
getStartCap()
Récupère l'extrémité au sommet de début de cette polyligne.
Objet
getTag()
Récupère le tag de la polyligne.
float
getWidth()
Récupère la largeur de cette polyligne.
float
getZIndex()
Récupère le zIndex de cette polyligne.
int
boolean
isClickable()
Récupère la cliquabilité de la polyligne.
boolean
isGeodesic()
Détermine si chaque segment de la ligne est tracé sous forme de géodésique.
boolean
isVisible()
Récupère la visibilité de cette polyligne.
void
supprimer()
Supprime cette polyligne de la carte.
void
setClickable(valeur booléenne cliquable)
Définit la cliquabilité de la polyligne.
void
setColor(nombre entier)
Définit la couleur de cette polyligne.
void
setEndCap(Cap endCap)
Définit l'extrémité au sommet final de cette polyligne.
void
setGeodesic(géodésique booléenne)
Détermine si chaque segment de la ligne doit être dessiné sous forme de géodésique.
void
setJointType(int jointType)
Définit le type de jointure de tous les sommets de la polyligne, à l'exception des sommets de début et de fin.
void
setPattern(modèle List<PatternItem>)
Définit le motif du trait de la polyligne.
void
setPoints(List<LatLng> points)
Définit les points de cette polyligne.
void
setSpans(List<StyleSpan>, segments)
Définit les intervalles de la polyligne.
void
setStartCap(Cap startCap)
Définit l'extrémité au sommet de début de cette polyligne.
void
setTag(tag d'objet)
Définit le tag de la polyligne.
void
setVisible(booléen visible)
Définit la visibilité de cette polyligne.
void
setWidth(largeur flottante)
Définit la largeur de cette polyligne.
void
setZIndex(zIndex flottant)
Définit le zIndex de cette polyligne.

Récapitulatif des méthodes héritées

Méthodes publiques

public boolean est égal à (objet autre)

Vérifie si cet élément Polyline est égal à un autre.

Paramètres
other un Object.
Renvoie
  • "true" si les deux objets sont le même, c'est-à-dire que ceci == other.

public int getColor ()

Récupère la couleur de cette polyligne.

Renvoie
  • la couleur au format ARVB.

public Cap getEndCap ()

Récupère l'extrémité au sommet final de cette polyligne.

Renvoie
  • comme le type d'image de fin.

public String getId ()

Récupère l'ID de cette polyligne. L'ID est unique parmi toutes les polylignes d'une carte.

Renvoie
  • l'identifiant de cette polyligne.

public int getJointType ()

Récupère le type de jointure utilisé à tous les sommets de la polyligne, à l'exception des sommets de début et de fin. Consultez JointType pour connaître les valeurs possibles.

Renvoie
  • le type de jointure.

public List<PatternItem> getPattern ()

Récupère le motif du trait de cette polyligne.

Renvoie
  • le motif du trait.

public List<LatLng> getPoints ()

Renvoie un instantané des sommets de cette polyligne à l'instant T . La liste renvoyée est une copie de la liste des sommets. Par conséquent, les modifications apportées aux sommets de la polyligne ne seront pas reflétées par cette liste, et les modifications apportées à cette liste ne seront pas reflétées par la polyligne. Pour modifier les sommets de la polyligne, appelez setPoints(List).

public Cap getStartCap ()

Récupère l'extrémité au sommet de début de cette polyligne.

Renvoie
  • le début.

objet public getTag ()

Récupère le tag de la polyligne.

Renvoie
  • la balise si une balise a été définie avec setTag ; null si aucune balise n'a été définie.

public float getWidth ()

Récupère la largeur de cette polyligne.

Renvoie
  • la largeur en pixels de l’écran.

public float getZIndex ()

Récupère le zIndex de cette polyligne.

Renvoie
  • le zIndex de la polyligne.

public int hashCode ()

public boolean isClickable ()

Récupère la cliquabilité de la polyligne. Si la polyligne est cliquable, votre application reçoit une notification à GoogleMap.OnPolylineClickListener lorsque l'utilisateur clique sur la polyligne. L'écouteur d'événements est enregistré via setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Renvoie
  • true si la polyligne est cliquable. Sinon, renvoie false.

public boolean isGeodesic ()

Détermine si chaque segment de la ligne est tracé sous forme de géodésique.

Renvoie
  • true si chaque segment est dessiné sous forme de géodésique ; false si chaque segment est tracé sous forme de ligne droite sur la projection de Mercator.

public boolean isVisible ()

Récupère la visibilité de cette polyligne.

Renvoie
  • la visibilité de cette polyligne.

public vide remove ()

Supprime cette polyligne de la carte. Une fois qu'une polyligne a été supprimée, le comportement de toutes ses méthodes n'est plus défini.

public void setClickable (booléen cliquable)

Définit la cliquabilité de la polyligne. Si la polyligne est cliquable, votre application reçoit une notification à GoogleMap.OnPolylineClickListener lorsque l'utilisateur clique sur la polyligne. L'écouteur d'événements est enregistré via setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Paramètres
Vous pouvez appuyer. Nouveau paramètre de cliquabilité pour la polyligne.

public void setColor (int color)

Définit la couleur de cette polyligne.

Paramètres
couleur la couleur au format ARVB.

public vide setEndCap (Cap endCap)

Définit l'extrémité au sommet final de cette polyligne. L'image de fin par défaut est ButtCap.

Paramètres
endCap l'image de fin. Ne doit pas être null.

public void setGeodesic (boolean geodesic)

Détermine si chaque segment de la ligne doit être dessiné sous forme de géodésique.

Paramètres
géodésique Si la valeur est true, chaque segment est dessiné sous forme de géodésique. Si la valeur est false, chaque segment est tracé par une ligne droite sur la projection de Mercator.

public vide setJointType (int jointType)

Définit le type de jointure de tous les sommets de la polyligne, à l'exception des sommets de début et de fin.

Consultez JointType pour connaître les valeurs autorisées. La valeur par défaut DEFAULT sera utilisée si le type de jointure n'est pas défini ou ne fait pas partie des valeurs autorisées.

Paramètres
jointType le type de jointure.

public vide setPattern (modèle List<PatternItem>)

Définit le motif du trait de la polyligne. Le motif du trait par défaut est plein et représenté par null.

Paramètres
modèle le motif du trait.

public void setPoints (List<LatLng> points)

Définit les points de cette polyligne. Cette méthode utilisera une copie des points. Par conséquent, toute autre mutation de points n'aura aucun effet sur cette polyligne.

Paramètres
points une liste de LatLng, qui sont les sommets de la polyligne ;

public void setSpans (List<StyleSpan> spans)

Définit les intervalles de la polyligne.

Paramètres
segments

public void setStartCap (Cap startCap)

Définit l'extrémité au sommet de début de cette polyligne. La limite de début par défaut est de ButtCap.

Paramètres
startCap l'extrémité de début. Ne doit pas être null.

public vide setTag (tag d'objet)

Définit le tag de la polyligne.

Vous pouvez utiliser cette propriété pour associer un Object arbitraire à cette polyligne. Par exemple, Object peut contenir des données sur ce que la polyligne représente. Cette opération est plus facile que de stocker un élément Map<Polyline, Object> distinct. Autre exemple, vous pouvez associer un ID String correspondant à l'ID d'un ensemble de données. Le SDK Google Maps pour Android ne lit ni n'écrit cette propriété. Vous êtes tenu d'appeler setTag(null) pour effacer la balise lorsque vous n'en avez plus besoin afin d'éviter les fuites de mémoire dans votre application.

Paramètres
tag Si la valeur est "null", la balise est effacée.

public void setVisible (boolean visible)

Définit la visibilité de cette polyligne. Lorsqu'elle n'est pas visible, la polyligne n'est pas dessinée, mais elle conserve toutes ses autres propriétés.

Paramètres
visible Si la valeur est true, la polyligne est visible. Si la valeur est false, elle ne l'est pas.

public void setWidth (largeur flottante)

Définit la largeur de cette polyligne.

Paramètres
largeur la largeur en pixels de l'écran

public void setZIndex (float zIndex)

Définit le zIndex de cette polyligne. Les polylignes dont l'indice z est plus élevé sont dessinées au-dessus de celles dont l'indice est inférieur.

Paramètres
zIndex le zIndex de cette polyligne.