Polylignes

la classe finale publique 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 a les propriétés suivantes:

Points
sommets de la ligne. Les 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épart et d'arrivée doivent être identiques.
Largeur
Largeur de segment de ligne en pixels à 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 du segment de ligne au format ARVB, le même que celui utilisé par Color. La valeur par défaut est "0xff000000" (noir).
Point de départ/fin
Définit la forme à utiliser au début ou à la fin d'une polyligne. Types de pointes compatibles : ButtCap, SquareCap, RoundCap (applicable pour le motif de trait plein) et CustomCap (applicable pour 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 pour joindre des segments de ligne adjacents à tous les sommets de la polyligne, à l'exception des sommets de début et de fin. Pour connaître les types de jointures compatibles, consultez JointType. La valeur par défaut est DEFAULT.
Motif du trait
Solide (par défaut, représenté par null) ou séquence d'objets PatternItem à répéter sur la ligne. Types PatternItem disponibles : Gap (défini par la longueur d'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, les TileOverlay, les Circle et les Polygon, mais pas les Marker). Une superposition avec un z-index plus grand est superposée aux superpositions avec des z-indices plus petits. L'ordre des superpositions ayant le même z-index est arbitraire. La valeur par défaut de la propriété zIndex est 0.
Visibilité
Indique si la polyligne est visible ou invisible, c'est-à-dire si elle est tracée sur la carte. Une polyligne invisible n'est pas tracé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 tracés en tant que géodésiques, par opposition aux lignes droites de la projection de Mercator. Une géodésique est le chemin 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.
Clicabilité
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 pour les GoogleMap.OnPolylineClickListener enregistrés via setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).
Tag
Object associé à la polyligne. Par exemple, Object peut contenir des données sur ce que la polyligne représente. C'est plus facile que de stocker un Map<Polyline, Object> distinct. Vous pouvez également 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é.
Objets Span
Définit les délais avec différents styles utilisés pour afficher cette polyligne. Vous pouvez utiliser cette propriété pour créer une polyligne comportant différents StrokeStyle sur différents segments de la polyligne.

Les méthodes de cette classe doivent être appelées sur le thread UI Android. Sinon, une erreur 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

booléen
est égal(e) à(Objet autre)
Teste si Polyline est égal à un autre.
int
getColor
Récupère la couleur de cette polyligne.
Casquette
getEndCap
Récupère la terminaison au sommet de cette polyligne.
String
getId
Récupère l'identifiant de cette polyligne.
int
getJointType ()
Récupère le type de jointure utilisé pour 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 pour le moment .
Casquette
getStartCap
Récupère la terminaison au sommet de début de cette polyligne.
Objet
getTag
Récupère le tag de la polyligne.
float (nombre à virgule flottante)
getWidth
Récupère la largeur de cette polyligne.
float (nombre à virgule flottante)
getZIndex
Récupère le zIndex de cette polyligne.
int
booléen
isClickable()
Récupère la cliquabilité de la polyligne.
booléen
isGeodesic
Détermine si chaque segment de la ligne est tracé en tant que géodésique ou non.
booléen
isVisible()
Récupère la visibilité de cette polyligne.
void
remove
Supprime cette polyligne de la carte.
void
setClickable (valeur cliquable cliquable)
Définit la cliquabilité de la polyligne.
void
setColor(couleur d'ensemble)
Définit la couleur de cette polyligne.
void
setEndCap(Cap endCap)
Définit l'extrémité au sommet de cette polyligne.
void
setGeodesic (valeur géodésique booléenne)
Détermine si chaque segment de la ligne doit être tracé ou non en tant que géodésique.
void
setJointType(int jointType)
Définit le type de jointure pour tous les sommets de la polyligne, à l'exception des sommets de début et de fin.
void
setPattern(List<PatternItem> motif)
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> délais)
Définit les étendues de la polyligne.
void
setStartCap(Cap startCap)
Définit la terminaison au sommet de début de cette polyligne.
void
setTag(tag d'objet)
Définit le tag de la polyligne.
void
setVisible(valeur booléenne 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 à (Object other)

Teste si Polyline est égal à un autre.

Paramètres
other un Object.
Renvoie
  • Valeur "true" si les deux objets sont le même objet, autrement dit, == other.

public int getColor ()

Récupère la couleur de cette polyligne.

Renvoie
  • la couleur au format ARVB.

public Cap getEndCap ()

Récupère la terminaison au sommet de cette polyligne.

Renvoie
  • le type d'image de fin.

public String getId ()

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

Renvoie
  • cet ID de polyligne.

public intgetJointType()

Récupère le type de jointure utilisé pour tous les sommets de la polyligne, à l'exception des sommets de début et de fin. Consultez la section 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
  • motif du trait.

public List<LatLng> getPoints ()

Renvoie un instantané des sommets de cette polyligne pour le moment . La liste renvoyée est une copie de la liste des sommets. Par conséquent, les modifications apportées aux sommets des polylignes 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 la terminaison au sommet de début de cette polyligne.

Renvoie
  • la limite de départ.

public Object getTag ()

Récupère le tag de la polyligne.

Renvoie
  • le tag si un tag a été défini avec setTag ; null si aucun tag n'a été défini.

float public getWidth ()

Récupère la largeur de cette polyligne.

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

float public getZIndex ()

Récupère le zIndex de cette polyligne.

Renvoie
  • zIndex de la polyligne.

public inthashCode()

public boolean isClickable ()

Récupère la cliquabilité de la polyligne. Si la polyligne est cliquable, votre application reçoit des notifications pour 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 booleanisGeodesic()

Détermine si chaque segment de la ligne est tracé en tant que géodésique ou non.

Renvoie
  • true si chaque segment est tracé 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 void supprimer ()

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

public voidsetClickable(booléen cliquable)

Définit la cliquabilité de la polyligne. Si la polyligne est cliquable, votre application reçoit des notifications pour 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é de la polyligne.

public voidsetColor(int color)

Définit la couleur de cette polyligne.

Paramètres
couleur la couleur au format ARVB

public void setEndCap (Cap endCap)

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

Paramètres
Image de fin l'image de fin (ne doit pas être null).

public void setGeodesic (valeur géodésique booléenne)

Détermine si chaque segment de la ligne doit être tracé ou non en tant que géodésique.

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

public void setJointType (int jointType)

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

Pour connaître les valeurs autorisées, consultez JointType. La valeur par défaut DEFAULT est utilisée si le type de jointure n'est pas défini ou ne correspond pas à l'une des valeurs autorisées.

Paramètres
jointType le type de jointure.

public void setPattern (List<MotifÉlément> schéma)

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

Paramètres
pattern motif du trait.

public void setPoints (List<LatLng> points)

Définit les points de cette polyligne. Cette méthode utilise une copie des points. Par conséquent, les mutations ultérieures de points n'auront aucun effet sur cette polyligne.

Paramètres
points Liste de LatLng correspondant aux sommets de la polyligne.

public void setSpans (List<StyleSpan> spans)

Définit les étendues de la polyligne.

Paramètres
délais

public void setStartCap (Cap startCap)

Définit la terminaison au sommet de début de cette polyligne. La limite de départ par défaut est ButtCap.

Paramètres
startCap La limite de début. Ne doit pas être null.

public void setTag (tag d'objet)

Définit le tag de la polyligne.

Vous pouvez utiliser cette propriété pour associer une Object arbitraire à cette polyligne. Par exemple, Object peut contenir des données sur ce que la polyligne représente. Cette méthode est plus facile que de stocker un Map<Polyline, Object> distinct. Vous pouvez également 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 devez appeler setTag(null) pour supprimer le tag 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", le tag est effacé.

public void setVisible (valeur booléenne visible)

Définit la visibilité de cette polyligne. Lorsqu'elle n'est pas visible, la polyligne n'est pas tracé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, ce n'est pas le cas.

public void setWidth (largeur flottante)

Définit la largeur de cette polyligne.

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

public void setZIndex (float zIndex)

Définit le zIndex de cette polyligne. Les polylignes avec un z-indice plus élevé sont dessinées au-dessus de celles ayant un indice plus faible.

Paramètres
z-index zIndex de cette polyligne.