目录

Circle

Class Info

public final class Circle

地图上的圆形对象,包括实心圆和空心圆两种。在调用HuaweiMap类的addCircle方法时会返回该类型的实例。

Public Method Summary

Qualifier and Type

Method Name and Description

boolean

clearAnimation()

清除所有动画。

LatLng

getCenter()

获取圆心经纬度。

int

getFillColor()

获取圆的填充色。

String

getId()

获取圆的id属性。

double

getRadius()

获取圆的半径。

int

getStrokeColor()

获取圆的边框颜色值。

List<PatternItem>

getStrokePattern()

获取圆的边框样式。

float

getStrokeWidth()

获取圆的边框宽度。

Object

getTag()

获取圆的tag属性。

float

getZIndex()

获取圆的z指数。

boolean

isClickable()

获取圆的可点击性。

boolean

isVisible()

获取圆的可见性。

void

remove()

从地图上移除该圆,移除后,该圆的所有方法行为都将无效。

void

setAnimation(Animation animation)

设置Circle动画。

void

setCenter(LatLng center)

给圆心设置经纬度坐标。

void

setClickable(boolean clickable)

设置圆的可点击性。

void

setFillColor(int color)

设置圆的填充色。

void

setRadius(double radius)

设置圆的半径。

void

setStrokeColor(int color)

设置圆的边框颜色。

void

setStrokePattern(List<PatternItem> pattern)

设置圆的边框样式。

void

setStrokeWidth(float width)

设置圆的边框宽度。

<T> void

setTag(T tag)

设置圆的tag属性。

void

setVisible(boolean visible)

设置圆的可见性。

void

setZIndex(float zIndex)

设置圆的z指数。

void

startAnimation()

启动动画。

Public Methods

[h2]clearAnimation

Method

public boolean clearAnimation()

您调用此API清除所有动画。

Returns

Type

Description

boolean

  • true,清除成功
  • false,清楚失败

[h2]getCenter

Method

public LatLng getCenter()

您调用此API可以获取圆心经纬度。

Returns

Type

Description

LatLng

圆心的经纬度。

[h2]getFillColor

Method

public int getFillColor()

您调用此API可以获取圆的填充色。

Returns

Type

Description

int

ARGB格式的颜色值。

[h2]getId

Method

public String getId()

您调用此API可以获取圆的id属性,该id在地图上的所有圆中都是唯一的。

Returns

Type

Description

String

圆的ID属性。

[h2]getRadius

Method

public double getRadius()

您调用此API可以获取圆的半径。

Returns

Type

Description

double

圆的半径,单位:米。

[h2]getStrokeColor

Method

public int getStrokeColor()

您调用此API可以获取圆的边框颜色值。

Returns

Type

Description

int

ARGB格式的颜色值。

[h2]getStrokePattern

Method

public List<PatternItem> getStrokePattern()

您调用此API可以获取圆的边框样式。

Returns

Type

Description

List<PatternItem>

圆的边框样式。

[h2]getStrokeWidth

Method

public float getStrokeWidth()

您调用此API可以获取圆的边框宽度。

Returns

Type

Description

float

圆的边框宽度,单位:像素。

[h2]getTag

Method

public Object getTag()

您调用此API将获取圆的tag属性。

Returns

Type

Description

Object

圆的tag属性。如果已设置tag,则返回Object;如果未设置,则返回null。

[h2]getZIndex

Method

public float getZIndex()

您调用此API可以获取圆的z指数。

Returns

Type

Description

float

z指数,即圆的叠加顺序。

[h2]isClickable

Method

public boolean isClickable()

您调用此API可以获取圆的可点击性。

Returns

Type

Description

boolean

圆的可点击性。

  • true:可点击
  • false:不可点击

[h2]isVisible

Method

public boolean isVisible()

您调用此API可以获取圆的可见性。

Returns

Type

Description

boolean

圆的可见性。

  • true:可见
  • false:不可见

[h2]remove

Method

public void remove()

您调用此API可以从地图上移除该圆,移除后,该圆的所有方法行为都将无效。

[h2]setAnimation

Method

public void setAnimation(Animation animation)

您调用此API设置Circle动画。

说明:

仅支持TranslateAnimation。

Parameters

Name

Description

Animation

动画对象。

[h2]setCenter

Method

public void setCenter(LatLng center)

您调用此API可以给圆心设置经纬度坐标,该圆心不能为空,因为圆没有默认的圆心。

说明:

圆的中心点纬度在[-85.051119, 85.051119]范围内才能画出圆。若圆中心点纬度正好为-85.051119或85.051119时,能画出半径为1米的圆。

Parameters

Name

Description

center

圆心对象。

Throws

Name

Description

NullPointerException

当传入的center为空时,抛出异常。

[h2]setClickable

Method

public void setClickable(boolean clickable)

您调用此API可以设置圆的可点击性。

Parameters

Name

Description

clickable

圆的可点击性。

  • true:可点击
  • false:不可点击

[h2]setFillColor

Method

public void setFillColor(int color)

您调用此API可以设置圆的填充色,如果使用Color.TRANSPARENT,则不会绘制填充。

Parameters

Name

Description

color

ARGB格式颜色值,默认填充色为透明色(0x00000000)。

[h2]setRadius

Method

public void setRadius(double radius)

您调用此API可以设置圆的半径。

说明:

圆的中心点纬度在[-85.051119, 85.051119]范围内才能画出圆。若圆中心点纬度正好为-85.051119或85.051119时,能画出半径为1米的圆。

Parameters

Name

Description

radius

圆的半径,单位:米。取值范围:大于等于0,默认为0。

[h2]setStrokeColor

Method

public void setStrokeColor(int color)

您调用此API可以设置圆的边框颜色,如果使用TRANSPARENT,则不会绘制边框。

Parameters

Name

Description

color

ARGB格式的颜色值,默认为黑色(0xff000000)。

[h2]setStrokePattern

Method

public void setStrokePattern(List<PatternItem> pattern)

您调用此API可以设置圆的边框样式。

Parameters

Name

Description

pattern

PatternItem对象的集合。默认的边框样式为实心,用null表示。

[h2]setStrokeWidth

Method

public void setStrokeWidth(float width)

您调用此API可以设置圆的边框宽度。

Parameters

Name

Description

width

边框的宽度,单位:像素。取值范围:大于等于0,默认为10。

Throws

Name

Description

IllegalArgumentException

当传入的宽度width是负数时,抛出异常。

[h2]setTag

Method

public <T> void setTag(T tag)

您调用此API可以设置圆的tag属性,tag属性可以是任意对象,如果设置为空,则清除tag。当您不再需要使用tag时,您可以调用setTag(null)清除tag,以防止应用程序发生内存泄漏。

Parameters

Name

Description

tag

圆的tag属性。

[h2]setVisible

Method

public void setVisible(boolean visible)

您调用此API可以设置圆的可见性,如果圆不可见,则不会绘制,其他所有状态均保留,圆默认是可见的。

Parameters

Name

Description

visible

圆的可见性。

  • true:可见
  • false:不可见

默认值为true。

[h2]setZIndex

Method

public void setZIndex(float zIndex)

设置圆的z指数。z指数指的是圆的叠加顺序,具有较大z指数的圆会绘制在具有较小z指数的圆上,具有相同z指数的叠加顺序为元素添加的先后顺序。默认的z指数是0。

说明:

数量限制:添加Circle和Polygon的总数乘以2加上添加Polyline和GroundOverlay的总数不超过1450,否则会出现图形叠加错误。

Parameters

Name

Description

zIndex

z指数,即圆的叠加顺序。默认值为0。

[h2]startAnimation

Method

public void startAnimation()

您调用此API可以启动动画。