Polyline

폴리라인은 연속되는 점 사이에 선분이 그려지는 점의 목록입니다. 다중선에는 다음과 같은 속성이 있습니다.

점수

선의 꼭짓점입니다. 선분이 연속되는 점 사이에 그려집니다. 다중선은 기본적으로 닫혀 있지 않습니다. 닫힌 다중선을 형성하려면 시작점과 끝점이 동일해야 합니다.

너비

화면 픽셀 단위의 선분 너비입니다. 너비는 일정하고 카메라의 확대/축소 수준과 무관합니다. 기본값은 10입니다.

색상

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

시작/종료 한도

다중선의 시작 또는 끝 부분에 사용할 도형을 정의합니다. 지원되는 상한 유형: ButtCap, SquareCap, RoundCap (실선 획 패턴에 적용 가능) 및 CustomCap (모든 획 패턴에 적용 가능) 시작과 끝 모두의 기본값은 ButtCap입니다.

연결부 유형

연결부 유형은 시작 및 끝 꼭짓점을 제외한 다중선의 모든 꼭짓점에서 인접한 선분을 결합할 때 사용되는 도형을 정의합니다. 지원되는 연결부 유형은 JointType를 참고하세요. 기본값은 DEFAULT입니다.

획 패턴

실선 (기본값, null으로 표시됨) 또는 선을 따라 반복될 PatternItem 객체의 시퀀스입니다. 사용 가능한 PatternItem 유형: Gap(픽셀 단위 간격 길이로 정의됨), Dash(선 너비와 파선 길이(픽셀 단위)로 정의됨), Dot(원형, 선 중앙, 선 너비로 정의됨)

Z-색인

다른 오버레이 (Marker는 포함되지만 GroundOverlay, TileOverlay, Circle, Polygon 포함)와 관련하여 이 타일 오버레이가 그려지는 순서입니다. Z-색인 값이 큰 오버레이는 Z-색인 값이 작은 오버레이 위에 그려집니다. 동일한 Z-인덱스를 가진 오버레이의 순서는 무작위입니다. 기본 zIndex는 0입니다.

공개 상태

다중선이 지도에 그려지는지 여부를 나타냅니다. 보이지 않는 다중선은 그려지지 않지만 다른 모든 속성은 유지합니다. 기본값은 true, 즉 visible입니다.

최단 거리 상태

다중선의 선분을 메르카토르 투영법의 직선이 아닌 최단 거리로 그려야 하는지 여부를 나타냅니다. 최단 거리는 지표면의 두 지점 간의 최단 경로입니다. 지구를 구라고 가정하여 최단 거리 곡선이 구성됩니다.

클릭 가능 여부

사용자가 다중선을 클릭할 때 실행되는 이벤트를 처리하려면 이 속성을 true로 설정합니다. 이 값은 언제든지 변경할 수 있습니다. 기본값은 false입니다. 이 속성이 true로 설정되면 앱은 setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)를 통해 등록된 GoogleMap.OnPolylineClickListener로 알림을 수신합니다.

태그

다중선과 연결된 Object입니다. 예를 들어 Object에는 다중선이 나타내는 내용에 관한 데이터가 포함될 수 있습니다. 이는 별도의 Map<Polyline, Object>를 저장하는 것보다 쉽습니다. 또 다른 예로, 데이터 세트의 ID에 해당하는 String ID를 연결할 수 있습니다. Android용 Google Maps SDK에서는 이 속성을 읽거나 쓰지 않습니다.

스팬

이 다중선을 렌더링하는 데 사용되는 다양한 스타일로 스팬을 정의합니다. 이 속성을 사용하여 다중선의 여러 선분에 다른 StrokeStyle로 다중선을 만들 수 있습니다.

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

예

GoogleMap map;
 // ... get a map.
 // Add a thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));
 

개발자 가이드

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