Circle

공개 최종 클래스 원형 객체
를 확장합니다.

지구 표면의 원 (구면 캡)입니다.

원에는 다음과 같은 속성이 있습니다.

가운데

원의 중심은 LatLng로 지정됩니다.

반경

원의 반지름으로, 미터 단위로 지정됩니다. 0 이상이어야 합니다.

획 너비

원 윤곽선의 너비(화면 픽셀 단위)입니다. 너비가 일정하고 독립적임 변경할 수 있습니다. 기본값은 10입니다.

획 색상

Color에서 사용하는 것과 동일한 ARGB 형식의 원 윤곽선 색상입니다. 기본값은 검은색 (0xff000000)입니다.

를 통해 개인정보처리방침을 정의할 수 있습니다.

획 패턴

솔리드 (기본값, null로 표시됨) 또는 일련의 PatternItem 객체 원의 윤곽선을 따라 반복할 수도 있습니다. 사용 가능한 PatternItem 유형: Gap (픽셀 단위의 간격 길이로 정의), Dash (획 너비 및 대시 길이로 정의됨) 픽셀) 및 Dot (원형, 원의 윤곽선 중심, 로 정의되는 지름) 획 너비)

채우기 색상

원 채우기 색상은 Color에서 사용하는 것과 동일한 ARGB 형식입니다. 기본값은 투명입니다 (0x00000000).

를 통해 개인정보처리방침을 정의할 수 있습니다.

Z-색인

다른 오버레이( GroundOverlay, TileOverlay, Polyline, Polygon이지만 Marker가 아님). Z-색인이 큰 오버레이는 작은 크기의 오버레이 위에 그려집니다. z-색인입니다. 동일한 Z-인덱스를 가진 오버레이의 순서는 무작위입니다. 기본 zIndex: 0.

공개 상태

원이 지도에 표시되는지, 표시되지 않는지를 나타냅니다. 보이지 않는 원은 그려지지 않지만 다른 속성은 모두 유지합니다. 기본값은 true, 즉 표시.

태그

원과 연결된 Object입니다. 예를 들어 Object에는 원이 나타내는 것에 대한 데이터입니다. 이는 별도의 Map<Circle, Object>를 저장하는 것보다 쉽습니다. 또 다른 예로 String ID를 데이터 세트의 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));
 

현재 지도 렌더기는 원은 북극 또는 남극을 포함합니다. 그러나 윤곽선은 여전히 있습니다.

개발자 가이드

자세한 내용은 Shapes 개발자를 참고하세요. 참조하세요.

공개 메서드 요약

LatLng	getCenter() 중심을 LatLng로 반환합니다.
int	getFillColor() 이 원의 채우기 색상을 반환합니다.
문자열	getId() 이 서클의 ID를 가져옵니다.
double	getRadius() 원의 반지름을 미터 단위로 반환합니다.
int	getStrokeColor() 획 색상을 반환합니다.
목록<PatternItem>	getStrokePattern() 이 원의 윤곽선의 획 패턴을 반환합니다.
float	getStrokeWidth() 획 너비를 반환합니다.
객체	getTag() 원의 태그를 가져옵니다.
float	getZIndex() ZIndex를 반환합니다.
부울	isClickable() 원의 클릭 가능 여부를 가져옵니다.
부울	isVisible() 원이 표시되는지 확인합니다.
void	remove() 지도에서 원을 삭제합니다.
void	setCenter(LatLng center) LatLng를 사용하여 중심을 설정합니다.
void	setClickable(불리언 클릭 가능) 원의 클릭 가능 여부를 설정합니다.
void	setFillColor(int color) 채우기 색상을 설정합니다.
void	setRadius(이중 반지름) 반경을 미터 단위로 설정합니다.
void	setStrokeColor(정수 색상) 획 색상을 설정합니다.
void	setStrokePattern(List<PatternItem> 패턴) 원의 윤곽선 획 패턴을 설정합니다.
void	setStrokeWidth(부동 소수점 수) 획 너비를 설정합니다.
void	setTag(객체 태그) 원의 태그를 설정합니다.
void	setVisible(boolean visible) 원의 가시성을 설정합니다.
void	setZIndex(부동 소수점 수 zIndex) ZIndex를 설정합니다.

상속받은 메서드 요약

java.lang.Object 클래스에서 상속됨

부울	같음(객체 arg0)
최종 클래스<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
문자열	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

공개 메서드

<ph type="x-smartling-placeholder"></ph> 공개 LatLng getCenter ()

중심을 LatLng로 반환합니다.

반환 값

• LatLng인 지리적 중심입니다.

<ph type="x-smartling-placeholder"></ph> 공개 정수 를 통해 개인정보처리방침을 정의할 수 있습니다. getFillColor ()

이 원의 채우기 색상을 반환합니다.

반환 값

• ARGB 형식의 원의 채우기 색상입니다.

<ph type="x-smartling-placeholder"></ph> 공개 문자열 를 통해 개인정보처리방침을 정의할 수 있습니다. getId ()

이 서클의 ID를 가져옵니다. ID는 지도의 모든 서클에서 고유합니다.

<ph type="x-smartling-placeholder"></ph> 공개 이중 를 통해 개인정보처리방침을 정의할 수 있습니다. getRadius ()

원의 반지름을 미터 단위로 반환합니다.

반환 값

• 반경입니다(미터 단위).

<ph type="x-smartling-placeholder"></ph> 공개 정수 를 통해 개인정보처리방침을 정의할 수 있습니다. getStrokeColor ()

획 색상을 반환합니다.

반환 값

• ARGB 형식의 원의 색상입니다.

<ph type="x-smartling-placeholder"></ph> 공개 목록<PatternItem> getStrokePattern ()

이 원의 윤곽선의 획 패턴을 반환합니다.

반환 값

• 획 패턴을 변경할 수 있습니다.

<ph type="x-smartling-placeholder"></ph> 공개 부동 소수점 수 를 통해 개인정보처리방침을 정의할 수 있습니다. getStrokeWidth ()

획 너비를 반환합니다.

반환 값

• 화면 픽셀 단위의 너비입니다.

<ph type="x-smartling-placeholder"></ph> 공개 개체 를 통해 개인정보처리방침을 정의할 수 있습니다. getTag ()

원의 태그를 가져옵니다.

반환 값

• 태그가 setTag로 설정된 경우 태그입니다. 태그가 설정되지 않은 경우 null입니다.

<ph type="x-smartling-placeholder"></ph> 공개 부동 소수점 수 를 통해 개인정보처리방침을 정의할 수 있습니다. getZIndex ()

ZIndex를 반환합니다.

반환 값

• 이 원의 zIndex입니다.

<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. isClickable ()

원의 클릭 가능 여부를 가져옵니다. 원을 클릭할 수 있는 경우 앱은 사용자가 원을 클릭하면 GoogleMap.OnCircleClickListener에 알림을 전송합니다. 이벤트 리스너는 setOnCircleClickListener(GoogleMap.OnCircleClickListener)를 통해 등록됩니다.

반환 값

• 원을 클릭할 수 있는 경우 true, 클릭할 수 없는 경우 false입니다.

<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. isVisible ()

원이 표시되는지 확인합니다.

반환 값

• 원이 표시되는 경우 true, 보이지 않으면 false입니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. 삭제 ()

지도에서 원을 삭제합니다. 원이 제거되면 모든 메서드가 정의되지 않은 것입니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setCenter (LatLng center)

LatLng를 사용하여 중심을 설정합니다.

기본값이 없으므로 가운데는 null이 아니어야 합니다.

매개변수

가운데	원의 지리적 중심이며 LatLng로 지정됩니다.

생성 값

NullPointerException	중앙이 null인 경우

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setClickable (부울 클릭 가능)

원의 클릭 가능 여부를 설정합니다. 원을 클릭할 수 있는 경우 앱은 사용자가 원을 클릭하면 GoogleMap.OnCircleClickListener에 알림을 전송합니다. 이벤트 리스너는 setOnCircleClickListener(GoogleMap.OnCircleClickListener)를 통해 등록됩니다.

매개변수

클릭 가능	원에 대한 새로운 클릭 가능 여부 설정

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setFillColor (int color)

채우기 색상을 설정합니다.

채우기 색상은 원 안의 색상이며 Color로 지정된 정수 형식입니다. TRANSPARENT를 사용하면 채우기가 그려지지 않습니다.

매개변수

색상	Color 형식의 색상입니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setRadius (이중 반경)

반경을 미터 단위로 설정합니다.

반경은 0 이상이어야 합니다.

매개변수

반경	반경(미터)입니다.

생성 값

IllegalArgumentException	반경이 음수인 경우

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setStrokeColor (int color)

획 색상을 설정합니다.

획 색상은 이 원의 윤곽선 색상이며 Color TRANSPARENT를 사용하면 윤곽선이 그려지지 않습니다.

매개변수

색상	Color 형식의 획 색상입니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setStrokePattern (List<PatternItem> 패턴)

원의 윤곽선 획 패턴을 설정합니다. 기본 획 패턴은 단색이며 null로 표현됩니다.

매개변수

패턴	획 패턴을 변경할 수 있습니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setStrokeWidth (부동 소수점 수)

획 너비를 설정합니다.

획 너비는 원의 윤곽선 너비 (화면 픽셀)입니다. 0이거나 더 높습니다. 이 값이 0이면 윤곽선이 그려지지 않습니다. 기본값은 10입니다.

매개변수

너비	화면 픽셀 단위의 획 너비입니다.

생성 값

IllegalArgumentException	너비가 음수인 경우

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setTag (객체 태그)

원의 태그를 설정합니다.

이 속성을 사용하여 임의의 Object를 이 원과 연결할 수 있습니다. 대상 예를 들어 Object에는 원이 나타내는 항목에 관한 데이터가 포함될 수 있습니다. 더 쉽습니다. 별도의 Map<Circle, Object>을 저장하는 것보다 훨씬 더 쉽습니다. 또 다른 예로 데이터 세트의 ID에 해당하는 String ID Android용 Google Maps SDK 이 속성을 읽거나 쓰지 않습니다. setTag(null)를 호출하여 더 이상 필요하지 않을 때 태그를 제거하여 앱에서 메모리 누수를 방지하세요.

매개변수

태그	null인 경우 태그가 지워집니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setVisible (불리언 표시)

원의 가시성을 설정합니다.

이 원이 보이지 않으면 그려지지 않습니다. 다른 모든 상태는 유지됩니다. 서클은 기본적으로 표시됩니다.

매개변수

표시	true하여 원을 표시합니다. false하여 보이지 않게 만듭니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setZIndex (부동 소수점 수 zIndex)

ZIndex를 설정합니다.

zIndex가 높은 오버레이 (예: 원)는 색인이 낮은 오버레이 위에 그려집니다.

매개변수

zIndex	ZIndex 값입니다.