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) etCustomCap
(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 estDEFAULT
. - Motif du trait
- Solide (par défaut, représenté par
null
) ou séquence d'objetsPatternItem
à répéter sur la ligne. TypesPatternItem
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) etDot
(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
, lesTileOverlay
, lesCircle
et lesPolygon
, mais pas lesMarker
). 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 estfalse
. Si cette propriété est définie surtrue
, votre application recevra des notifications pour lesGoogleMap.OnPolylineClickListener
enregistrés viasetOnPolylineClickListener(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 unMap<Polyline, Object>
distinct. Vous pouvez également associer un IDString
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 | |
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 | |
void | |
void | |
void | |
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)
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, renvoiefalse
.
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. |
---|