Circle

공개 최종 클래스 Circle은 Object
를 확장함

지구 표면의 원 (구형 캡)

원은 다음과 같은 속성을 가지고 있습니다.

센터
원의 중심은 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
getCenter()
중심을 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
setCenter(LatLng 중심)
LatLng를 사용하여 중심을 설정합니다.
void
setClickable(부울 클릭 가능)
원의 클릭 가능 여부를 설정합니다.
void
setFillColor(int color)
채우기 색상을 설정합니다.
void
setRadius(이중 반지름)
반경을 미터 단위로 설정합니다.
void
setStrokeColor(int color)
획 색상을 설정합니다.
void
setStrokePattern(List<PatternItem> 패턴)
원 윤곽선의 획 패턴을 설정합니다.
void
setStrokeWidth(부동 소수점 너비)
획 너비를 설정합니다.
void
setTag(객체 태그)
원의 태그를 설정합니다.
void
setVisible(불리언 표시)
원의 가시성을 설정합니다.
void
setZIndex(부동 소수점 수 zIndex)
zIndex를 설정합니다.

상속받은 메서드 요약

공개 메서드

공개 LatLng getCenter ()

중심을 LatLng로 반환합니다.

반환 값
  • LatLng로서의 지리적 중심입니다.

public int getFillColor ()

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

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

공개 문자열 getId ()

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

public double getRadius ()

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

반환 값
  • 반경(미터)입니다.

public int getStrokeColor ()

획 색상을 반환합니다.

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

공개 List<PatternItem> getStrokePattern ()

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

반환 값
  • 획 패턴을 사용합니다.

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 중심)

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

기본값이 없으므로 중심이 null이면 안 됩니다.

매개변수
가운데 원의 지리적 중심이며 LatLng로 지정됩니다.
생성 값
NullPointerException center가 null인 경우

public void setClickable (부울 클릭 가능)

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

매개변수
클릭 가능 원의 새로운 클릭 가능 여부 설정

public void setFillColor (int color)

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

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

매개변수
색상 Color 형식의 색상입니다.

public void setRadius (이중 반경)

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

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

매개변수
반경 반경(미터)입니다.
생성 값
IllegalArgumentException 반경이 음수인 경우

public void setStrokeColor (int color)

획 색상을 설정합니다.

획 색상은 이 원의 윤곽선 색상이며 Color로 지정된 정수 형식입니다. TRANSPARENT를 사용하면 윤곽선이 그려지지 않습니다.

매개변수
색상 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 값입니다.