새로운 지도 스타일이 곧 Google Maps Platform에 제공될 예정입니다. 이 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트와 지도 환경 및 사용성 개선사항이 포함됩니다. 모든 지도 스타일이 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 더 일찍 선택하는 방법에 대한 자세한 내용은 Google Maps Platform용 새로운 지도 스타일을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Polygon

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

지구 표면의 다각형입니다. 다각형은 볼록하거나 오목한 형태일 수 있으며, 180도에 걸쳐 채워지지 않은 구멍이 있을 수 있습니다. 여기에는 다음과 같은 속성이 있습니다.

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

개발자 가이드

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

공개 메서드 요약

부울	같음(기타 객체) 이 `Polygon`가 다른 `Polygon`와 같은지 테스트합니다.
int	getFillColor() 이 폴리곤의 채우기 색상을 가져옵니다.
List<List<LatLng>>	getHoles() 현재 이 폴리곤의 구멍에 대한 스냅샷을 반환합니다 .
문자열	getId() 이 폴리곤의 ID를 가져옵니다.
List<LatLng>	getPoints() 현재 이 폴리곤의 꼭짓점에 대한 스냅샷을 반환합니다 .
int	getStrokeColor() 이 폴리곤의 획 색상을 가져옵니다.
int	getStrokeJointType() 다각형 윤곽선의 모든 꼭짓점에 사용되는 획 연결부 유형을 가져옵니다.
목록<PatternItem>	getStrokePattern() 이 폴리곤 윤곽선의 획 패턴을 가져옵니다.
float	getStrokeWidth() 이 폴리곤의 획 너비를 가져옵니다.
객체	getTag() 다각형의 태그를 가져옵니다.
float	getZIndex() 이 폴리곤의 zIndex를 가져옵니다.
int	hashCode()
부울	isClickable() 다각형의 클릭 가능 여부를 가져옵니다.
부울	isGeodesic() 선의 각 부분이 최단 거리로 그려졌는지 여부를 가져옵니다.
부울	isVisible() 이 폴리곤의 가시성을 가져옵니다.
void	remove() 지도에서 폴리곤을 제거합니다.
void	setClickable(불리언 클릭 가능) 다각형의 클릭 가능 여부를 설정합니다.
void	setFillColor(int color) 이 폴리곤의 채우기 색상을 설정합니다.
void	setGeodesic(boolean geodesic) 선의 각 부분을 최단 거리로 그릴지 여부를 설정합니다.
void	setHoles(List<? extends List<LatLng>> 구멍) 이 다각형의 구멍을 설정합니다.
void	setPoints(List<LatLng> 포인트) 이 다각형의 점을 설정합니다.
void	setStrokeColor(정수 색상) 이 폴리곤의 획 색상을 설정합니다.
void	setStrokeJointType(int joinType) 다각형 윤곽선의 모든 꼭짓점에 대한 연결부 유형을 설정합니다.
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> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. 같음 (객체 기타)

이 Polygon가 다른 Polygon와 같은지 테스트합니다.

매개변수

기타	`Object`

반환 값

두 객체가 동일한 객체라면 true, 즉 이 == other입니다.

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

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

반환 값

ARGB 형식으로 표시됩니다.

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

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

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

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

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

현재 이 폴리곤의 꼭짓점에 대한 스냅샷을 반환합니다 . 반환된 목록은 사본입니다. 따라서 다각형의 꼭짓점에 대한 변경사항은 여기에 반영되지 않습니다. 이 목록의 변경사항은 다각형에 반영되지 않습니다. 정점을 변경하려면 setPoints(List)를 호출합니다.

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

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

반환 값

ARGB 형식으로 표시됩니다.

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

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

반환 값

획 연결부 유형입니다.

<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> 공개 정수 를 통해 개인정보처리방침을 정의할 수 있습니다. hashCode ()

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

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

반환 값

다각형을 클릭할 수 있는 경우 true, 그렇지 않으면 false를 반환합니다.

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

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

반환 값

각 세그먼트가 최단 거리로 그려진 경우 true 각 세그먼트가 다음과 같은 경우 false 메르카토르 투영법에서 직선으로 그려집니다.

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

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

반환 값

볼 수 있습니다.

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

지도에서 폴리곤을 제거합니다. 다각형을 제거한 후에는 모든 다각형의 동작이 메서드가 정의되지 않은 것입니다.

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

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

매개변수

클릭 가능	다각형에 대한 새로운 클릭 가능 여부 설정

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

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

매개변수

색상	ARGB 형식의 색상

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

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

매개변수

geodesic	`true`인 경우 각 세그먼트는 최단 거리로 그려집니다. `false`인 경우, 각 세그먼트는 메르카토르 투영법에서 직선으로 그려집니다.

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

이 다각형의 구멍을 설정합니다. 이 방법은 구멍의 복사본을 가져오므로 holes로 변경해도 이 다각형에 영향을 미치지 않습니다.

매개변수

홀	구멍 목록. 여기서 구멍은 `LatLng`의 목록입니다.

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

이 다각형의 점을 설정합니다. 이 메서드는 점의 사본을 가져오므로 points에 대한 변형은 이 다각형에 영향을 미치지 않습니다.

매개변수

포인트	다각형의 꼭짓점인 `LatLng`의 목록입니다.

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

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

매개변수

색상	ARGB 형식의 색상

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

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

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

매개변수

jointType	획 연결부 유형입니다.

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

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

매개변수

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

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

이 다각형의 획 너비를 설정합니다.

매개변수

너비	디스플레이 픽셀 단위의 너비입니다.

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

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

이 속성을 사용하여 임의의 Object을 이 다각형과 연결할 수 있습니다. 대상 예를 들어 Object에는 다각형이 나타내는 대상에 관한 데이터가 포함될 수 있습니다. 더 쉽습니다. 별도의 Map<Polygon, 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를 설정합니다. z 인덱스가 높은 다각형은 z 인덱스가 낮은 다각형 위에 그려집니다. 색인을 생성합니다.

매개변수

zIndex	폴리곤의 zIndex입니다.