를 확장함
지구 표면의 원 (구형 캡)
원은 다음과 같은 속성을 가지고 있습니다.
- 센터
- 원의 중심은
LatLng
로 지정됩니다. - 반경
- 원의 반지름으로, 미터 단위로 지정됩니다. 0 이상이어야 합니다.
- 획 너비
- 원 윤곽선의 너비(화면 픽셀)입니다. 너비는 일정하고 카메라의 확대/축소 수준과 무관합니다. 기본값은 10입니다.
- 획 색상
- 원 윤곽선의 색상이며 ARGB 형식으로 표시되며
Color
에서 사용하는 형식과 동일합니다. 기본값은 검은색 (0xff000000
)입니다. - 획 패턴
- 실선 (기본값,
null
으로 표시됨) 또는 원의 윤곽선을 따라 반복될PatternItem
객체의 시퀀스입니다. 사용 가능한PatternItem
유형:Gap
(픽셀 단위의 간격 길이로 정의됨),Dash
(픽셀 단위의 획 너비와 대시 길이로 정의됨),Dot
(원형, 원의 윤곽선 중심, 지름이 픽셀 단위의 획 너비로 정의됨) - 채우기 색상
- 원의 색상은
Color
에서 사용하는 것과 동일한 ARGB 형식으로 채워집니다. 기본값은 투명 (0x00000000
)입니다. - Z-색인
- 다른 오버레이 (
Marker
는 포함되지만GroundOverlay
,TileOverlay
,Polyline
,Polygon
포함)와 관련하여 이 타일 오버레이가 그려지는 순서입니다. Z-색인 값이 큰 오버레이는 Z-색인 값이 작은 오버레이 위에 그려집니다. 동일한 Z-인덱스를 가진 오버레이의 순서는 무작위입니다. 기본 zIndex는 0입니다. - 공개 상태
- 원이 표시되는지, 보이지 않는지, 즉 지도에 그려지는지 여부를 나타냅니다. 보이지 않는 원은 그려지지 않지만 다른 모든 속성은 유지합니다. 기본값은
true
, 즉 visible입니다. - 태그
- 원과 연결된
Object
입니다. 예를 들어Object
에는 원이 나타내는 내용에 관한 데이터가 포함될 수 있습니다. 이는 별도의Map<Circle, Object>
를 저장하는 것보다 쉽습니다. 또 다른 예로, 데이터 세트의 ID에 해당하는String
ID를 연결할 수 있습니다. Android용 Google Maps SDK에서는 이 속성을 읽거나 쓰지 않습니다.
이 클래스의 메서드는 Android UI 스레드에서 호출되어야 합니다. 그러지 않으면 런타임에 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를 가져옵니다.
|
double |
getRadius()
원의 반지름을 미터 단위로 반환합니다.
|
int |
getStrokeColor()
획 색상을 반환합니다.
|
List<PatternItem> |
getStrokePattern()
이 원 윤곽선의 획 패턴을 반환합니다.
|
float |
getStrokeWidth()
획 너비를 반환합니다.
|
객체 |
getTag()
원의 태그를 가져옵니다.
|
float |
getZIndex()
zIndex를 반환합니다.
|
boolean |
isClickable()
원의 클릭 가능 여부를 가져옵니다.
|
boolean |
isVisible()
원이 표시되는지 확인합니다.
|
void |
remove()
지도에서 이 원을 삭제합니다.
|
void | |
void |
setClickable(부울 클릭 가능)
원의 클릭 가능 여부를 설정합니다.
|
void |
setFillColor(int color)
채우기 색상을 설정합니다.
|
void |
setRadius(이중 반지름)
반경을 미터 단위로 설정합니다.
|
void |
setStrokeColor(int color)
획 색상을 설정합니다.
|
void | |
void |
setStrokeWidth(부동 소수점 너비)
획 너비를 설정합니다.
|
void |
setTag(객체 태그)
원의 태그를 설정합니다.
|
void |
setVisible(불리언 표시)
원의 가시성을 설정합니다.
|
void |
setZIndex(부동 소수점 수 zIndex)
zIndex를 설정합니다.
|
상속받은 메서드 요약
공개 메서드
public int getFillColor ()
이 원의 채우기 색상을 반환합니다.
반환 값
- ARGB 형식의 원의 채우기 색상입니다.
공개 문자열 getId ()
이 원의 ID를 가져옵니다. ID는 지도의 모든 서클에서 고유합니다.
public double getRadius ()
원의 반지름을 미터 단위로 반환합니다.
반환 값
- 반경(미터)입니다.
public int getStrokeColor ()
획 색상을 반환합니다.
반환 값
- ARGB 형식의 원의 색상입니다.
public float getStrokeWidth ()
획 너비를 반환합니다.
반환 값
- 화면 픽셀 단위의 너비입니다.
공개 객체 getTag ()
원의 태그를 가져옵니다.
반환 값
setTag
로 태그가 설정된 경우 태그, 설정된 태그가 없으면null
입니다.
public float getZIndex ()
zIndex를 반환합니다.
반환 값
- 이 원의 zIndex입니다.
공개 불리언 isClickable ()
원의 클릭 가능 여부를 가져옵니다. 원을 클릭할 수 있는 경우 사용자가 원을 클릭하면 앱에서 GoogleMap.OnCircleClickListener
에 알림을 수신합니다.
이벤트 리스너는 setOnCircleClickListener(GoogleMap.OnCircleClickListener)
를 통해 등록됩니다.
반환 값
- 원을 클릭할 수 있으면
true
이고, 클릭할 수 없으면false
입니다.
공개 불리언 isVisible ()
원이 표시되는지 확인합니다.
반환 값
- 원이 표시되면
true
, 표시되지 않으면false
입니다.
public void remove ()
지도에서 이 원을 삭제합니다. 원이 삭제된 후에는 원의 모든 메서드의 동작이 정의되지 않습니다.
public void setCenter (LatLng 중심)
public void setClickable (부울 클릭 가능)
원의 클릭 가능 여부를 설정합니다. 원을 클릭할 수 있는 경우 사용자가 원을 클릭하면 앱에서 GoogleMap.OnCircleClickListener
에 알림을 수신합니다.
이벤트 리스너는 setOnCircleClickListener(GoogleMap.OnCircleClickListener)
를 통해 등록됩니다.
매개변수
클릭 가능 | 원의 새로운 클릭 가능 여부 설정 |
---|
public void setFillColor (int color)
public void setRadius (이중 반경)
반경을 미터 단위로 설정합니다.
반경은 0 이상이어야 합니다.
매개변수
반경 | 반경(미터)입니다. |
---|
생성 값
IllegalArgumentException | 반경이 음수인 경우 |
---|
public void setStrokeColor (int color)
public void setStrokePattern (List<PatternItem> pattern)
원 윤곽선의 획 패턴을 설정합니다. 기본 획 패턴은 null
로 표시되는 실선입니다.
매개변수
패턴 | 획 패턴을 사용합니다. |
---|
public void setStrokeWidth (부동 소수점 너비)
획 너비를 설정합니다.
획 너비는 원 윤곽선의 너비 (화면 픽셀 단위)입니다. 0 이상이어야 합니다. 값이 0이면 윤곽선이 그려지지 않습니다. 기본값은 10입니다.
매개변수
너비 | 획 너비(화면 픽셀)입니다. |
---|
생성 값
IllegalArgumentException | 너비가 음수인 경우 |
---|
public void setTag (객체 태그)
원의 태그를 설정합니다.
이 속성을 사용하여 임의의 Object
을 이 원과 연결할 수 있습니다. 예를 들어 Object
에는 원이 나타내는 내용에 관한 데이터가 포함될 수 있습니다. 이는 별도로 Map<Circle, Object>
를 저장하는 것보다 쉽습니다. 또 다른 예로, 데이터 세트의 ID에 해당하는 String
ID를 연결할 수 있습니다. Android용 Google Maps SDK에서는 이 속성을 읽거나 쓰지 않습니다. 앱에서 메모리 누수를 방지하기 위해 setTag(null)
를 호출하여 더 이상 필요하지 않은 태그를 삭제하는 것은 개발자의 책임입니다.
매개변수
태그 | null이면 태그가 지워집니다. |
---|
public void setVisible (boolean visible)
원의 가시성을 설정합니다.
이 원이 보이지 않으면 그려지지 않습니다. 다른 모든 상태는 보존됩니다. 서클은 기본적으로 표시됩니다.
매개변수
표시 | 이 원을 표시하려면 true , 숨김으로 설정하려면 false 하세요.
|
---|
public void setZIndex (float zIndex)
zIndex를 설정합니다.
zIndice가 높은 오버레이 (예: 원)는 색인이 낮은 오버레이 위에 그려집니다.
매개변수
zIndex | zIndex 값입니다. |
---|