地球表面上的圆(球帽)。
圆形具有以下属性。
- 居中对齐
- 圆形的中心被指定为
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 | |
int |
getFillColor()
返回此圆的填充颜色。
|
字符串 |
getId()
获取此圈子的 ID。
|
双精度 |
getRadius()
返回圆的半径(以米为单位)。
|
int |
getStrokeColor()
返回描边颜色。
|
List<PatternItem>PatternItem |
getStrokePattern()
返回此圆形轮廓的描边图案。
|
float |
getStrokeWidth()
返回描边宽度。
|
对象 |
getTag()
获取圆形的标记。
|
float |
getZIndex()
返回 ZIndex。
|
boolean |
isClickable()
获取圆形的可点击性。
|
boolean |
isVisible()
查看圆圈是否可见。
|
void |
remove()
从地图中删除此圆形。
|
void | |
void |
setClickable(布尔值,可点击)
设置圆形的可点击性。
|
void |
setFillColor(整型颜色)
设置填充颜色。
|
void |
setRadius(双半径)
设置半径(以米为单位)。
|
void |
setStrokeColor(整型颜色)
设置描边颜色。
|
void | |
void |
setStrokeWidth(浮动宽度)
设置描边宽度。
|
void |
setTag(对象标记)
设置圈子的标记。
|
void |
setVisible(boolean visible)
设置圆形的可见性。
|
void |
setZIndexsetZIndex(float zIndex)
设置 ZIndex。
|
继承的方法摘要
公共方法
公开 整数 getFillColor ()
返回此圆的填充颜色。
返回
- 圆形的填充颜色,采用 ARGB 格式。
公开 字符串 getId ()
获取此圈子的 ID。该 ID 在地图上的所有圈子中都是唯一的。
公开 双精度 getRadius ()
返回圆的半径(以米为单位)。
返回
- 半径(以米为单位)。
公开 整数 getStrokeColor ()
返回描边颜色。
返回
- 圆形的颜色,采用 ARGB 格式。
公开 浮点数 getStrokeWidth ()
返回描边宽度。
返回
- 宽度(以像素为单位)。
公开 对象 getTag ()
获取圆形的标记。
返回
- 如果通过
setTag
设置了标记,则为相应标记;如果未设置任何标记,则为null
。
公开 浮点数 getZIndex ()
返回 ZIndex。
返回
- 此圆的 ZIndex。
公开 布尔值 isClickable ()
获取圆形的可点击性。如果圆圈可点击,您的应用将收到
通知会发送到 GoogleMap.OnCircleClickListener
。
事件监听器通过 setOnCircleClickListener(GoogleMap.OnCircleClickListener)
注册。
返回
- 如果圆圈可点击,则为
true
;如果不可点击,则为false
。
公开 布尔值 isVisible ()
查看圆圈是否可见。
返回
- 如果圆圈可见,则为
true
;如果不可见,则为false
。
公开 无效 删除 ()
从地图中删除此圆形。移除某个圆后,其所有相关行为 方法。
公开 无效 setCenter (LatLng 中心)
公开 无效 setClickable (可点击的布尔值)
设置圆形的可点击性。如果圆圈可点击,您的应用将收到
当用户点击圆圈时,系统会向 GoogleMap.OnCircleClickListener
发送一条通知。
事件监听器通过 setOnCircleClickListener(GoogleMap.OnCircleClickListener)
注册。
参数
可点击 | 圈子的新可点击性设置。 |
---|
公开 无效 setFillColor (整数颜色)
公开 无效 setRadius (双半径)
设置半径(以米为单位)。
半径必须大于或等于零。
参数
半径 | 半径(以米为单位)。 |
---|
抛出
IllegalArgumentException | 如果半径为负数 |
---|
公开 无效 setStrokeColor (整数颜色)
公开 无效 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 值。 |
---|