Polyline

多段线是一个点列表，其中线段在连续的点之间绘制。答 多段线具有以下属性：

积分

线条的顶点。在连续的点之间绘制线段。多段线是 未默认关闭；要形成一个闭合的多段线，起点和终点必须 一样。

宽度

线段宽度（以像素为单位）。该宽度恒定不变，并且与镜头的 缩放级别。默认值为 10。

颜色

ARRGB 格式的线段颜色，与 Color 使用的格式相同。 默认值为黑色 (0xff000000)。

开始/结束上限

定义要在多段线起点或终点使用的形状。支持的上限类型：ButtCap、SquareCap、RoundCap（适用于纯色描边图案）和 CustomCap（适用于任何描边图案）。开始和结束的默认值： ButtCap。

连接类型

连接类型定义了完全连接相邻的线段时使用的形状 多段线的顶点（起点和结束顶点除外）。查看JointType 支持的连接类型。默认值为 DEFAULT。

描边图案

实心（默认，由 null 表示）或一系列 PatternItem 对象 要在整个行中重复的内容可用的 PatternItem 类型：Gap（由 间隔长度（以像素为单位）、Dash（由线条宽度和短划线长度定义（以像素为单位）和 Dot（圆形，在线居中，直径由线条宽度定义，以像素为单位）。

Z-index

此图块叠加层相对于其他叠加层（包括 GroundOverlay、TileOverlay、Circle 和 Polygon，但不是 Marker）。Z-index 较大的叠加层绘制在具有较小 Z-index 的叠加层之上 Z 索引。Z-index 相同的叠加层可按任意顺序绘制。默认的 zIndex 为 0.

可见性

用于指示多段线是可见还是不可见，即是否绘制在地图上。一个 不可见的多段线不会绘制，但会保留其所有其他属性。默认值为 true，即可见。

测地状态

表示是否应将多段线的线段绘制为测地线，而不是绘制为测地线 在墨卡托投影上绘制直线。测地线是指 不同地球表面的点测地曲线在构建时假设地球处于 球形

可点击性

如果您想要处理用户点击多段线时触发的事件，请将此属性设为 true。您可以随时更改此值。默认值为 false。如果 属性设置为 true，您的应用将会收到发送给通过 setOnPolylineClickListener(GoogleMap.OnPolylineClickListener) 注册的 GoogleMap.OnPolylineClickListener 的通知。

标记

与多段线关联的 Object。例如，Object 可以包含 有关多段线所表示内容的数据。这比存储单独的 Map<Polyline, Object> 更简单。再举一例，您可以将 String ID 与数据集中的 ID 相对应。Google Maps SDK for Android 既不会读取 写入此属性。

Span

使用不同样式定义用于渲染此多段线的跨度。您可以使用 属性以StrokeStyle不同线段上 绘制多段线

此类中的方法必须在 Android 界面线程上调用。否则，系统会在运行时抛出 IllegalStateException。

示例

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

开发者指南

有关详情，请参阅形状开发者 指南。