Polyline

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

Points

Sommets de la ligne. Des segments de ligne sont tracés entre des points consécutifs. Une polyligne est pas fermé par défaut ; pour former une polyligne fermée, les points de départ et d'arrivée doivent être identique.

Largeur

Largeur du segment de ligne en pixels de l'écran. La largeur est constante et indépendante de la le niveau de zoom. La valeur par défaut est 10.

Couleur

Couleur du segment de ligne au format ARVB (même format que celui 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 limites acceptés: ButtCap, SquareCap, RoundCap (applicable aux motifs à trait plein) et CustomCap (applicable à tous les motifs 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. sommets de la polyligne, à l'exception des sommets de début et de fin. Consultez les JointType pour types de jointures pris en charge. La valeur par défaut est DEFAULT.

Motif du trait

Uni (par défaut, représenté par null) ou une séquence d'objets PatternItem doit être répété tout au long de la ligne. Types PatternItem disponibles: Gap (défini par l'espace vide en pixels), Dash (définie par l'épaisseur de ligne et la longueur des tirets 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 tracée par rapport aux autres superpositions (y compris GroundOverlay, TileOverlay, Circle et Polygon, mais pas Markers). Une superposition avec un z-index plus grand s'affiche sur des superpositions dont la taille est plus petite z-indices. 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 la polyligne invisible n'est pas tracée, mais elle 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 en tant que géodésiques, et non en tant que sur des lignes droites dans la projection de Mercator. Une géodésique est le chemin le plus court entre à la surface de la Terre. La courbe géodésique s'obtient en supposant que la Terre 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 est définie sur true, votre application recevra des notifications à l'adresse GoogleMap.OnPolylineClickListener enregistrée 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. Autre exemple : vous pouvez associer un ID String correspondant à l'identifiant d'un ensemble de données. Le SDK Google Maps pour Android ne se lit ni ne lit écrit cette propriété.

Segments

Définit les étendues avec différents styles utilisés pour afficher cette polyligne. Vous pouvez utiliser cette pour créer une polyligne avec différentes valeurs StrokeStyle sur différents segments de la polyligne.

Les méthodes de cette classe doivent être appelées sur le thread UI Android. Si ce n'est pas le cas, 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 la page dédiée au développeur de Shapes. .