Polyline

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

다중선은 점의 목록으로, 연속된 점 사이에 선분이 그려집니다. 가 다중선에는 다음과 같은 속성이 있습니다.

포인트
선의 꼭짓점입니다. 선분은 연속되는 점 사이에 그려집니다. 다중선은 않습니다. 닫힌 폴리라인을 만들려면 시작점과 끝점이 사용할 수 있습니다.
너비
선 세그먼트 너비(화면 픽셀)입니다. 너비는 일정하며 카메라의 너비와 무관합니다. 확대/축소 수준입니다. 기본값은 10입니다.
색상
Color에서 사용하는 것과 동일한 ARGB 형식의 선분 색상입니다. 기본값은 검은색 (0xff000000)입니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.
시작/끝 모양
다중선의 시작이나 끝에 사용할 도형을 정의합니다. 지원되는 한도 유형: ButtCap, SquareCap, RoundCap (실선 패턴에 적용 가능) CustomCap (모든 획 패턴에 적용 가능). 시작 및 끝 모두 기본값: ButtCap
연결부 유형
연결점 유형은 인접한 선분을 결합할 때 사용할 도형을 정의합니다. 시작 및 끝 꼭짓점을 제외한 폴리라인의 꼭짓점입니다. JointType에서 다음을 확인하세요. 지원되는 연결 유형 기본값은 DEFAULT입니다.
획 패턴
솔리드 (기본값, null로 표시됨) 또는 일련의 PatternItem 객체 선을 따라 반복될 것입니다. 사용 가능한 PatternItem 유형: Gap (다음으로 정의됨) 간격 길이(픽셀), Dash(선 너비 및 대시 길이(픽셀)로 정의) 및 Dot(원형, 선 중앙, 선 너비(픽셀 단위로 정의되는 지름)).
Z-색인
다른 오버레이( GroundOverlay, TileOverlay, Circle, Polygon(포함되지 않음) Marker)을 입력합니다. Z-색인이 큰 오버레이는 작은 크기의 오버레이 위에 그려집니다. z-색인입니다. 동일한 Z-인덱스를 가진 오버레이의 순서는 무작위입니다. 기본 zIndex: 0.
공개 상태
다중선의 표시 여부(예: 지도에 다중선을 그렸는지 여부)를 나타냅니다. 보이지 않는 다중선은 그려지지 않지만 다른 속성은 모두 유지합니다. 기본값은 true, 즉 표시.
최단 거리 상태
다중선의 선분을 다중선 선분이 아닌 최단 거리로 그려야 하는지 여부를 나타냅니다. 직선이 표시됩니다. 최단 거리는 두 지점 간의 최단 경로입니다. 점의 개수입니다. 최단 거리 곡선은 지구가 구
를 통해 개인정보처리방침을 정의할 수 있습니다.
클릭 가능 여부
사용자가 다중선을 클릭할 때 발생하는 이벤트를 처리하려면 이 속성을 다음과 같이 설정합니다. true입니다. 이 값은 언제든지 변경할 수 있습니다. 기본값은 false입니다. 만약 속성이 true로 설정되면 앱에서 setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)를 통해 등록된 GoogleMap.OnPolylineClickListener로 알림을 수신합니다.
태그
다중선과 연결된 Object입니다. 예를 들어 Object에는 표시할 수 있습니다. 이는 별도의 Map<Polyline, Object>를 저장하는 것보다 쉽습니다. 또 다른 예로 String ID를 데이터 세트의 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));
 

개발자 가이드

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

공개 메서드 요약

부울
같음(기타 객체)
Polyline가 다른 Polyline와 같은지 테스트합니다.
int
getColor()
이 폴리라인의 색상을 가져옵니다.
한도
getEndCap()
이 폴리라인의 끝 꼭짓점에 있는 캡을 가져옵니다.
문자열
getId()
이 폴리라인의 ID를 가져옵니다.
int
getJointType()
시작 및 끝 꼭짓점을 제외하고 다중선의 모든 꼭짓점에 사용되는 연결부 유형을 가져옵니다.
목록<PatternItem>
getPattern()
이 다중선의 획 패턴을 가져옵니다.
List<LatLng>
getPoints()
현재 이 폴리라인의 꼭짓점에 대한 스냅샷을 반환합니다 .
한도
getStartCap()
이 폴리라인의 시작 꼭짓점에 있는 캡을 가져옵니다.
객체
getTag()
폴리라인의 태그를 가져옵니다.
float
getWidth()
이 폴리라인의 너비를 가져옵니다.
float
getZIndex()
이 폴리라인의 zIndex를 가져옵니다.
int
부울
isClickable()
다중선의 클릭 가능 여부를 가져옵니다.
부울
isGeodesic()
선의 각 부분이 최단 거리로 그려졌는지 여부를 가져옵니다.
부울
isVisible()
이 폴리라인의 가시성을 가져옵니다.
void
remove()
지도에서 이 폴리라인을 삭제합니다.
void
setClickable(불리언 클릭 가능)
다중선의 클릭 가능 여부를 설정합니다.
void
setColor(int color)
이 다중선의 색상을 설정합니다.
void
setEndCap(Cap endCap)
이 다중선의 끝 꼭짓점에 상한을 설정합니다.
void
setGeodesic(boolean geodesic)
선의 각 부분을 최단 거리로 그릴지 여부를 설정합니다.
void
setJointType(int joinType)
시작 및 끝 꼭짓점을 제외한 다중선의 모든 꼭짓점에 대한 연결부 유형을 설정합니다.
void
setPattern(List<PatternItem> 패턴)
다중선의 획 패턴을 설정합니다.
void
setPoints(List<LatLng> 포인트)
이 다중선의 점을 설정합니다.
void
setSpans(List<StyleSpan> spans)
다중선의 범위를 설정합니다.
void
setStartCap(Cap startCap)
이 다중선의 시작 꼭짓점에 상한을 설정합니다.
void
setTag(객체 태그)
다중선에 태그를 설정합니다.
void
setVisible(boolean visible)
이 다중선의 표시 여부를 설정합니다.
void
setWidth(부동 소수점 수)
다중선의 너비를 설정합니다.
void
setZIndex(부동 소수점 수 zIndex)
이 폴리라인의 zIndex를 설정합니다.

상속받은 메서드 요약

공개 메서드

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

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

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

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

이 폴리라인의 색상을 가져옵니다.

반환 값
  • ARGB 형식으로 표시됩니다.

<ph type="x-smartling-placeholder"></ph> 공개 한도 getEndCap ()

이 폴리라인의 끝 꼭짓점에 있는 캡을 가져옵니다.

반환 값
  • 엔드 캡 유형입니다.

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

이 폴리라인의 ID를 가져옵니다. ID는 지도의 모든 다중선에서 고유합니다.

반환 값
  • 이 폴리라인의 ID를 반환합니다.

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

시작 및 끝 꼭짓점을 제외하고 다중선의 모든 꼭짓점에 사용되는 연결부 유형을 가져옵니다. 자세한 내용은 JointType: 가능한 값

반환 값
  • 연결부 유형입니다.

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

이 다중선의 획 패턴을 가져옵니다.

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

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

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

<ph type="x-smartling-placeholder"></ph> 공개 한도 getStartCap ()

이 폴리라인의 시작 꼭짓점에 있는 캡을 가져옵니다.

반환 값
  • 있습니다

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

폴리라인의 태그를 가져옵니다.

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

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

이 폴리라인의 너비를 가져옵니다.

반환 값
  • 너비를 설정합니다.

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

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

반환 값
  • 폴리라인의 zIndex입니다.

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

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

다중선의 클릭 가능 여부를 가져옵니다. 폴리라인을 클릭할 수 있는 경우 앱은 사용자가 클릭 시 GoogleMap.OnPolylineClickListener에 알림 다중선입니다. 이벤트 리스너는 setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)를 통해 등록됩니다.

반환 값
  • 다중선을 클릭할 수 있는 경우 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.OnPolylineClickListener에 알림 다중선입니다. 이벤트 리스너는 setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)를 통해 등록됩니다.

매개변수
클릭 가능 다중선에 대한 새로운 클릭 가능 여부 설정

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

이 다중선의 색상을 설정합니다.

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

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

이 다중선의 끝 꼭짓점에 상한을 설정합니다. 기본 엔드 캡은 ButtCap입니다.

매개변수
endCap 엔드 캡입니다. null일 수 없습니다.

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

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

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

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

시작 및 끝 꼭짓점을 제외한 다중선의 모든 꼭짓점에 대한 연결부 유형을 설정합니다.

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

매개변수
jointType 연결부 유형입니다.

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

다중선의 획 패턴을 설정합니다. 기본 획 패턴은 실선으로 null

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

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

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

매개변수
포인트 다중선의 꼭짓점인 LatLng의 목록입니다.

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

다중선의 범위를 설정합니다.

매개변수
스팬

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

이 다중선의 시작 꼭짓점에 상한을 설정합니다. 기본 시작 한도는 ButtCap입니다.

매개변수
startCap 있습니다 null일 수 없습니다.

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

다중선에 태그를 설정합니다.

이 속성을 사용하여 임의의 Object를 이 다중선과 연결할 수 있습니다. 대상 예를 들어 Object에는 다중선이 나타내는 대상에 관한 데이터가 포함될 수 있습니다. 더 쉽습니다. 별도의 Map<Polyline, 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> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setWidth (부동 소수점 수)

다중선의 너비를 설정합니다.

매개변수
너비 너비(화면 픽셀)

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

이 폴리라인의 zIndex를 설정합니다. zIndice가 높은 폴리라인은 실적이 저조한 경우가 많습니다.

매개변수
zIndex 폴리라인의 zIndex입니다.