Polygon

地球表面上的多边形。多边形可以是凸的，也可以是凹的，可跨越 180 它可能会有未填充的孔。它具有以下属性：

概要

轮廓由一系列顶点按顺时针或逆时针顺序指定。它 无需使起点和终点重合；否则多边形将会 自动关闭线段在较短内容中的连续点之间绘制 两个方向（东或西）。

孔

孔是指多边形内未填充的区域。空洞的精确位置是 与大纲相同孔必须完全包含在轮廓内。多个 可指定孔，但不支持重叠的孔。

描边宽度

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

描边颜色

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

描边连接类型

连接类型定义了完全连接相邻的线段时使用的形状 绘制多边形的轮廓的顶点。如需了解支持的连接类型，请参阅 JointType。通过 默认值为 DEFAULT。

描边图案

实心（默认，由 null 表示）或一系列 PatternItem 对象 在多边形的轮廓上重复。可用的 PatternItem 类型：Gap（由间距长度定义，以像素为单位）、Dash（由描边宽度和短划线定义） 长度（以像素为单位）和 Dot（圆形，以多边形轮廓为中心，直径） 由描边宽度（以像素为单位）定义）。

填充颜色

填充颜色采用 ARGB 格式，与 Color 使用的格式相同。通过 默认值为透明 (0x00000000)。如果未指定多边形几何图形 （请参阅上文的轮廓和孔），则不会绘制任何填充。

Z-index

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

可见性

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

测地状态

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

可点击性

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

标记

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

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

示例

GoogleMap map;
 // ... get a map.
 // Add a triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

开发者指南

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