Polygon

공개 최종 클래스 Polygon은 Object
를 확장합니다.

지구 표면의 다각형입니다. 다각형은 볼록하거나 오목할 수 있으며 180자오선을 아우르고 채워지지 않은 구멍이 있을 수 있습니다. 다음과 같은 속성이 있습니다.

윤곽선
윤곽선은 시계 방향 또는 시계 반대 방향 방향의 꼭짓점 목록으로 지정됩니다. 시작점과 끝점이 일치하지 않아도 됩니다. 일치하지 않으면 다각형이 자동으로 닫힙니다. 선분은 두 방향 중 더 짧은 방향 (동쪽 또는 서쪽)으로 이어지는 점 사이에 그려집니다.
구멍들
구멍은 다각형 내부에서 채워지지 않은 영역입니다. 구멍은 윤곽선과 정확히 같은 방식으로 지정됩니다. 구멍은 윤곽선 안에 완전히 포함되어야 합니다. 여러 개의 구멍을 지정할 수 있지만 겹치는 구멍은 지원되지 않습니다.
획 너비
화면 픽셀 단위의 선분 너비입니다. 너비는 일정하고 카메라의 확대/축소 수준과 무관합니다. 기본값은 10입니다.
획 색상
ARGB 형식의 선분 색상입니다. Color에서 사용하는 형식과 동일합니다. 기본값은 검은색 (0xff000000)입니다.
획 연결부 유형
이 연결부 유형은 다각형 윤곽선의 모든 꼭짓점에서 인접한 선분을 결합할 때 사용되는 도형을 정의합니다. 지원되는 연결부 유형은 JointType를 참고하세요. 기본값은 DEFAULT입니다.
획 패턴
다각형 (기본값, null으로 표시됨) 또는 다각형의 윤곽선을 따라 반복될 PatternItem 객체의 시퀀스입니다. 사용 가능한 PatternItem 유형: Gap(픽셀 단위 간격 길이로 정의됨), Dash(픽셀 단위로 획 너비와 대시 길이로 정의됨), Dot(원형, 다각형 윤곽선 중심, 지름(픽셀 단위 획 너비로 정의됨))
채우기 색상
Color에서 사용된 것과 동일한 형식인 ARGB 형식으로 채우기 색상을 적용합니다. 기본값은 투명 (0x00000000)입니다. 다각형 도형이 올바르게 지정되지 않으면 (위의 윤곽선 및 구멍 참고) 채우기가 이루어지지 않습니다.
Z-색인
Polyline, Circle, GroundOverlay, TileOverlay 등 다른 오버레이와 관련하여 이 다각형을 그리는 순서입니다(Marker는 아님). Z-색인 값이 큰 오버레이는 Z-색인 값이 작은 오버레이 위에 그려집니다. Z-색인 값이 동일한 오버레이의 순서는 무작위입니다. 기본값은 0입니다.
공개 상태
다각형이 표시되는지 여부(예: 지도에 그려졌는지 여부)를 나타냅니다. 보이지 않는 다각형은 그려지지 않지만 다른 모든 속성은 유지합니다. 기본값은 true, 즉 visible입니다.
최단 거리 상태
다각형의 선분을 메르카토르 투영법의 직선이 아닌 최단 거리로 그려야 하는지 여부를 나타냅니다. 최단 거리는 지표면의 두 지점 간의 최단 경로입니다. 지구를 구라고 가정하여 최단 거리 곡선이 구성됩니다.
클릭 가능 여부
사용자가 다각형을 클릭할 때 실행되는 이벤트를 처리하려면 이 속성을 true로 설정합니다. 이 값은 언제든지 변경할 수 있습니다. 기본값은 false입니다. 이 속성이 true로 설정되면 앱은 setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)를 통해 등록된 GoogleMap.OnPolygonClickListener로 알림을 수신합니다.
태그
다각형과 연결된 Object입니다. 예를 들어 Object에는 다각형이 나타내는 내용에 관한 데이터가 포함될 수 있습니다. 이는 별도의 Map<Polygon, Object>를 저장하는 것보다 쉽습니다. 또 다른 예로, 데이터 세트의 ID에 해당하는 String ID를 연결할 수 있습니다. Android용 Google Maps SDK에서는 이 속성을 읽거나 쓰지 않습니다.

이 클래스의 메서드는 Android UI 스레드에서 호출되어야 합니다. 그러지 않으면 런타임에 IllegalStateException이 발생합니다.

GoogleMap map;
 // ... get a map.
 // Add a triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

개발자 가이드

자세한 내용은 도형 개발자 가이드를 참고하세요.

공개 메서드 요약

boolean
같음(기타 객체)
Polygon가 다른 것과 같은지 테스트합니다.
int
getFillColor()
이 폴리곤의 채우기 색상을 가져옵니다.
List<List<LatLng>>
getHoles()
현재 이 폴리곤의 구멍에 대한 스냅샷을 반환합니다 .
문자열
getId()
이 폴리곤의 ID를 가져옵니다.
List<LatLng>
getPoints()
현재 이 폴리곤의 꼭짓점의 스냅샷을 반환합니다 .
int
getStrokeColor()
이 폴리곤의 획 색상을 가져옵니다.
int
getStrokeJointType()
다각형 윤곽선의 모든 꼭짓점에 사용되는 획 연결부 유형을 가져옵니다.
List<PatternItem>
getStrokePattern()
이 폴리곤 윤곽선의 획 패턴을 가져옵니다.
float
getStrokeWidth()
이 폴리곤의 획 너비를 가져옵니다.
객체
getTag()
다각형의 태그를 가져옵니다.
float
getZIndex()
이 폴리곤의 zIndex를 가져옵니다.
int
boolean
isClickable()
다각형의 클릭 가능 여부를 가져옵니다.
boolean
isGeodesic()
선의 각 세그먼트가 최단 거리로 그려졌는지 여부를 가져옵니다.
boolean
isVisible()
이 폴리곤의 가시성을 가져옵니다.
void
remove()
지도에서 폴리곤을 삭제합니다.
void
setClickable(부울 클릭 가능)
다각형의 클릭 가능 여부를 설정합니다.
void
setFillColor(int color)
이 폴리곤의 채우기 색상을 설정합니다.
void
setGeodesic(불리언 최단 거리)
선의 각 세그먼트를 최단 거리로 그릴지 여부를 설정합니다.
void
setHoles(List<? extends List<LatLng>> 홀)
이 폴리곤의 구멍을 설정합니다.
void
setPoints(List<LatLng> 지점)
이 다각형의 점을 설정합니다.
void
setStrokeColor(int color)
이 폴리곤의 획 색상을 설정합니다.
void
setStrokeJointType(int jointType)
다각형 윤곽선의 모든 꼭짓점에 대한 연결부 유형을 설정합니다.
void
setStrokePattern(List<PatternItem> 패턴)
다각형 윤곽선의 획 패턴을 설정합니다.
void
setStrokeWidth(부동 소수점 너비)
이 폴리곤의 획 너비를 설정합니다.
void
setTag(객체 태그)
다각형에 태그를 설정합니다.
void
setVisible(불리언 표시)
이 폴리곤의 가시성을 설정합니다.
void
setZIndex(부동 소수점 수 zIndex)
이 폴리곤의 zIndex를 설정합니다.

상속받은 메서드 요약

공개 메서드

공개 부울 같음 (기타 객체)

Polygon가 다른 것과 같은지 테스트합니다.

매개변수
기타 Object
반환 값
  • 두 객체가 동일한 객체인 경우, 즉 == other인 경우 true입니다.

public int getFillColor ()

이 폴리곤의 채우기 색상을 가져옵니다.

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

public List<List<LatLng>> getHoles ()

현재 이 폴리곤의 구멍에 대한 스냅샷을 반환합니다 . 반환된 목록은 구멍 목록의 사본이므로 다각형의 구멍 변경사항은 이 목록에 반영되지 않으며 이 목록에 대한 변경사항은 다각형에 반영되지 않습니다.

공개 문자열 getId ()

이 폴리곤의 ID를 가져옵니다. ID는 지도의 모든 다각형에서 고유합니다.

public List<LatLng> getPoints ()

현재 이 폴리곤의 꼭짓점의 스냅샷을 반환합니다 . 반환된 목록은 꼭짓점 목록의 사본이므로 다각형의 꼭짓점 변경사항은 이 목록에 반영되지 않으며 이 목록의 변경사항은 다각형에 반영되지 않습니다. 다각형의 꼭짓점을 변경하려면 setPoints(List)를 호출하세요.

public int getStrokeColor ()

이 폴리곤의 획 색상을 가져옵니다.

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

public int getStrokeJointType ()

다각형 윤곽선의 모든 꼭짓점에 사용되는 획 연결부 유형을 가져옵니다. 가능한 값은 JointType를 참고하세요.

반환 값
  • 지정할 수 있습니다.

공개 List<PatternItem> getStrokePattern ()

이 폴리곤 윤곽선의 획 패턴을 가져옵니다.

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

public float getStrokeWidth ()

이 폴리곤의 획 너비를 가져옵니다.

반환 값
  • 너비입니다.

공개 객체 getTag ()

다각형의 태그를 가져옵니다.

반환 값
  • setTag로 태그가 설정된 경우 태그, 설정된 태그가 없으면 null입니다.

public float getZIndex ()

이 폴리곤의 zIndex를 가져옵니다.

반환 값
  • 다각형의 zIndex입니다.

public int hashCode ()

공개 불리언 isClickable ()

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

반환 값
  • 다각형을 클릭할 수 있으면 true이고, 그렇지 않으면 false을 반환합니다.

공개 불리언 isGeodesic ()

선의 각 세그먼트가 최단 거리로 그려졌는지 여부를 가져옵니다.

반환 값
  • 각 선분이 최단 거리로 그려지면 true, 각 선분이 메르카토르 도법에서 직선으로 그려지면 false입니다.

공개 불리언 isVisible ()

이 폴리곤의 가시성을 가져옵니다.

반환 값
  • 지정하는 것입니다.

public void remove ()

지도에서 폴리곤을 삭제합니다. 다각형이 삭제된 후에는 모든 메서드의 동작이 정의되지 않습니다.

public void setClickable (부울 클릭 가능)

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

매개변수
클릭 가능 다각형의 새 클릭 가능 여부 설정

public void setFillColor (int color)

이 폴리곤의 채우기 색상을 설정합니다.

매개변수
색상 ARGB 형식의 색상

public void setGeodesic (boolean geodesic)

선의 각 세그먼트를 최단 거리로 그릴지 여부를 설정합니다.

매개변수
geodesic true인 경우 각 선분이 최단 거리로 그려지고, false인 경우 각 선분이 메르카토르 투영법에서 직선으로 그려집니다.

public void setHoles (List<? extends List<LatLng>> holes)

이 폴리곤의 구멍을 설정합니다. 이 메서드는 구멍의 사본을 취하므로 holes를 추가로 변형해도 이 다각형에 영향을 미치지 않습니다.

매개변수
구멍 구멍 목록. 여기서 구멍은 LatLng 목록입니다.

public void setPoints (List<LatLng> points)

이 다각형의 점을 설정합니다. 이 메서드는 점의 사본을 가져오므로 points를 추가적으로 변형해도 이 다각형에 영향을 미치지 않습니다.

매개변수
포인트 다각형의 꼭짓점인 LatLng의 목록

public void setStrokeColor (int color)

이 폴리곤의 획 색상을 설정합니다.

매개변수
색상 ARGB 형식의 색상

public void setStrokeJointType (int jointType)

다각형 윤곽선의 모든 꼭짓점에 대한 연결부 유형을 설정합니다.

허용되는 값은 JointType를 참조하세요. 연결부 유형이 정의되지 않았거나 허용되는 값 중 하나가 아닌 경우 기본값 DEFAULT이 사용됩니다.

매개변수
jointType 지정할 수 있습니다.

public void setStrokePattern (List<PatternItem> pattern)

다각형 윤곽선의 획 패턴을 설정합니다. 기본 획 패턴은 null로 표시되는 실선입니다.

매개변수
패턴 획 패턴을 사용합니다.

public void setStrokeWidth (부동 소수점 너비)

이 폴리곤의 획 너비를 설정합니다.

매개변수
너비 너비입니다.

public void setTag (객체 태그)

다각형에 태그를 설정합니다.

이 속성을 사용하여 임의의 Object을 이 다각형과 연결할 수 있습니다. 예를 들어 Object에는 다각형이 나타내는 내용에 관한 데이터가 포함될 수 있습니다. 이는 별도로 Map<Polygon, 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입니다.