Circle

公共最终类 圆形 扩展对象

地球表面上的圆（球帽）。

圆形具有以下属性。

居中对齐
圆形的中心被指定为 LatLng。
半径
圆形的半径（以米为单位）。该值应大于或等于 0。
描边宽度
圆形的轮廓的宽度（以像素为单位）。宽度是恒定且独立的 相机的缩放级别。默认值为 10。
描边颜色
圆形轮廓的颜色，采用 ARGB 格式，与 Color 所使用的格式相同。默认值为黑色 (0xff000000)。
描边图案
实心（默认，由 null 表示）或一系列 PatternItem 对象 在圆圈的轮廓上重复可用的PatternItem类型：Gap （由间隔长度定义，以像素为单位）、Dash（由 像素）和 Dot（圆形，以圆圈轮廓为中心，直径由 描边宽度（以像素为单位）。
填充颜色
圆形填充的颜色，采用 ARGB 格式，与 Color 使用的格式相同。默认值为透明 (0x00000000)。
Z-index
此图块叠加层相对于其他叠加层（包括 GroundOverlay、TileOverlay、Polyline和Polygon，但 而不是 Marker）。Z-index 较大的叠加层绘制在具有较小 Z-index 的叠加层之上 Z 索引。Z-index 相同的叠加层可按任意顺序绘制。默认的 zIndex 为 0.
可见性
指示圆形是否可见，即是否绘制在地图上。一个 不可见圆形不会绘制，但会保留其所有其他属性。默认值为 true，即可见。
标记
与圈子关联的 Object。例如，Object 可以包含 有关圆所代表含义的数据。这比存储单独的 Map<Circle, Object> 更简单。再举一例，您可以将 String ID 与数据集中的 ID 相对应。Google Maps SDK for Android 既不会读取 写入此属性。

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

示例

GoogleMap map;
 // ... get a map.
 // Add a circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));

请注意，如果 包含北极或南极的圆圈。不过，系统仍会绘制轮廓 正确。

开发者指南

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

公共方法摘要

LatLng
getCenter()
以 LatLng 形式返回中心。
int
getFillColor()
返回此圆的填充颜色。
字符串
getId()
获取此圈子的 ID。
双精度
getRadius()
返回圆的半径（以米为单位）。
int
getStrokeColor()
返回描边颜色。
List<PatternItem>PatternItem
getStrokePattern()
返回此圆形轮廓的描边图案。
float
getStrokeWidth()
返回描边宽度。
对象
getTag()
获取圆形的标记。
float
getZIndex()
返回 ZIndex。
boolean
isClickable()
获取圆形的可点击性。
boolean
isVisible()
查看圆圈是否可见。
void
remove()
从地图中删除此圆形。
void
setCenter(LatLng 中心)LatLng
使用 LatLng 设置中心。
void
setClickable（布尔值，可点击）
设置圆形的可点击性。
void
setFillColor（整型颜色）
设置填充颜色。
void
setRadius（双半径）
设置半径（以米为单位）。
void
setStrokeColor(整型颜色)
设置描边颜色。
void
setStrokePattern(List<PatternItem> 模式)
设置圆形轮廓的描边图案。
void
setStrokeWidth（浮动宽度）
设置描边宽度。
void
setTag（对象标记）
设置圈子的标记。
void
setVisible(boolean visible)
设置圆形的可见性。
void
setZIndexsetZIndex(float zIndex)
设置 ZIndex。

继承的方法摘要

公共方法

公开 LatLng getCenter ()

以 LatLng 形式返回中心。

返回
  • 地理位置中心，格式为 LatLng。

公开 整数 getFillColor ()

返回此圆的填充颜色。

返回
  • 圆形的填充颜色，采用 ARGB 格式。

公开 字符串 getId ()

获取此圈子的 ID。该 ID 在地图上的所有圈子中都是唯一的。

公开 双精度 getRadius ()

返回圆的半径（以米为单位）。

返回
  • 半径（以米为单位）。

公开 整数 getStrokeColor ()

返回描边颜色。

返回
  • 圆形的颜色，采用 ARGB 格式。

公开 列表<PatternItem>PatternItem getStrokePattern ()

返回此圆形轮廓的描边图案。

返回
  • 描边图案

公开 浮点数 getStrokeWidth ()

返回描边宽度。

返回
  • 宽度（以像素为单位）。

公开 对象 getTag ()

获取圆形的标记。

返回
  • 如果通过 setTag 设置了标记，则为相应标记；如果未设置任何标记，则为 null。

公开 浮点数 getZIndex ()

返回 ZIndex。

返回
  • 此圆的 ZIndex。

公开 布尔值 isClickable ()

获取圆形的可点击性。如果圆圈可点击，您的应用将收到 通知会发送到 GoogleMap.OnCircleClickListener。 事件监听器通过 setOnCircleClickListener(GoogleMap.OnCircleClickListener) 注册。

返回
  • 如果圆圈可点击，则为 true；如果不可点击，则为 false。

公开 布尔值 isVisible ()

查看圆圈是否可见。

返回
  • 如果圆圈可见，则为 true；如果不可见，则为 false。

公开 无效 删除 ()

从地图中删除此圆形。移除某个圆后，其所有相关行为 方法。

公开 无效 setCenter （LatLng 中心）

使用 LatLng 设置中心。

中心不能为 null，因为没有默认值。

参数
center 圆形的地理中心，以 LatLng 的形式指定。
抛出
NullPointerException 如果 center 为 null

公开 无效 setClickable （可点击的布尔值）

设置圆形的可点击性。如果圆圈可点击，您的应用将收到 当用户点击圆圈时，系统会向 GoogleMap.OnCircleClickListener 发送一条通知。 事件监听器通过 setOnCircleClickListener(GoogleMap.OnCircleClickListener) 注册。

参数
可点击 圈子的新可点击性设置。

公开 无效 setFillColor （整数颜色）

设置填充颜色。

填充颜色是圆圈内的颜色，采用 Color 指定的整数格式。如果使用 TRANSPARENT，则不会绘制任何填充。

参数
颜色 采用 Color 格式的颜色。

公开 无效 setRadius （双半径）

设置半径（以米为单位）。

半径必须大于或等于零。

参数
半径 半径（以米为单位）。
抛出
IllegalArgumentException 如果半径为负数

公开 无效 setStrokeColor （整数颜色）

设置描边颜色。

描边颜色是此圆形轮廓的颜色，采用 Color。如果使用 TRANSPARENT，则不会绘制轮廓。

参数
颜色 描边颜色，采用 Color 格式。

公开 无效 setStrokePattern （List<PatternItem> 模式）

设置圆形轮廓的描边图案。默认的描边图案是纯色 用 null 表示。

参数
图案 描边图案

公开 无效 setStrokeWidth （浮动宽度）

设置描边宽度。

描边宽度是圆形轮廓的宽度（以屏幕像素为单位）。该值必须为零或 。如果为零，则不绘制轮廓。默认值为 10。

参数
width 描边宽度（以像素为单位）。
抛出
IllegalArgumentException 如果宽度为负数

公开 无效 setTag （对象标记）

设置圈子的标记。

你可以使用此属性将任意 Object 与此圈子相关联。对于 例如，Object 可以包含有关圆所代表含义的数据。这样更简单 与存储单独的 Map<Circle, Object> 相比。再举一例，您可以将 与数据集中的 ID 对应的 String ID。Google Maps SDK for Android 读取或写入此属性。您需要负责调用 setTag(null) 来清除 在不再需要时，使用此标记，以防止应用中发生内存泄漏。

参数
标记 如果为 null，则清除该代码。

公开 无效 setVisible （布尔值可见）

设置圆形的可见性。

如果此圆圈不可见，则不会进行绘制。所有其他状态都会保留。 默认情况下，圈子是可见的。

参数
可见 true可显示此圈子；false 可将其设为不可见。

公开 无效 setZIndex （浮动 zIndex）

设置 ZIndex。

zInIndex 较高的叠加层（如圆形）绘制在 zIndics 较小的叠加层之上。

参数
zIndex ZIndex 值。