를 확장합니다.
다중선은 점의 목록으로, 연속된 점 사이에 선분이 그려집니다. 가 다중선에는 다음과 같은 속성이 있습니다.
- 포인트
- 선의 꼭짓점입니다. 선분은 연속되는 점 사이에 그려집니다. 다중선은 않습니다. 닫힌 폴리라인을 만들려면 시작점과 끝점이 사용할 수 있습니다.
- 너비
- 선 세그먼트 너비(화면 픽셀)입니다. 너비는 일정하며 카메라의 너비와 무관합니다. 확대/축소 수준입니다. 기본값은 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>를 저장하는 것보다 쉽습니다. 또 다른 예로StringID를 데이터 세트의 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 개발자를 참고하세요. 참조하세요.
공개 메서드 요약
| 부울 | |
| int |
getColor()
이 폴리라인의 색상을 가져옵니다.
|
| 한도 |
getEndCap()
이 폴리라인의 끝 꼭짓점에 있는 캡을 가져옵니다.
|
| 문자열 |
getId()
이 폴리라인의 ID를 가져옵니다.
|
| int |
getJointType()
시작 및 끝 꼭짓점을 제외하고 다중선의 모든 꼭짓점에 사용되는 연결부 유형을 가져옵니다.
|
| 목록<PatternItem> |
getPattern()
이 다중선의 획 패턴을 가져옵니다.
|
| List<LatLng> |
getPoints()
현재 이 폴리라인의 꼭짓점에 대한 스냅샷을 반환합니다 .
|
| 한도 |
getStartCap()
이 폴리라인의 시작 꼭짓점에 있는 캡을 가져옵니다.
|
| 객체 |
getTag()
폴리라인의 태그를 가져옵니다.
|
| float |
getWidth()
이 폴리라인의 너비를 가져옵니다.
|
| float |
getZIndex()
이 폴리라인의 zIndex를 가져옵니다.
|
| int |
hashCode()
|
| 부울 |
isClickable()
다중선의 클릭 가능 여부를 가져옵니다.
|
| 부울 |
isGeodesic()
선의 각 부분이 최단 거리로 그려졌는지 여부를 가져옵니다.
|
| 부울 |
isVisible()
이 폴리라인의 가시성을 가져옵니다.
|
| void |
remove()
지도에서 이 폴리라인을 삭제합니다.
|
| void |
setClickable(불리언 클릭 가능)
다중선의 클릭 가능 여부를 설정합니다.
|
| void |
setColor(int color)
이 다중선의 색상을 설정합니다.
|
| void | |
| void |
setGeodesic(boolean geodesic)
선의 각 부분을 최단 거리로 그릴지 여부를 설정합니다.
|
| void |
setJointType(int joinType)
시작 및 끝 꼭짓점을 제외한 다중선의 모든 꼭짓점에 대한 연결부 유형을 설정합니다.
|
| void | |
| void | |
| void | |
| void | |
| void |
setTag(객체 태그)
다중선에 태그를 설정합니다.
|
| void |
setVisible(boolean visible)
이 다중선의 표시 여부를 설정합니다.
|
| void |
setWidth(부동 소수점 수)
다중선의 너비를 설정합니다.
|
| void |
setZIndex(부동 소수점 수 zIndex)
이 폴리라인의 zIndex를 설정합니다.
|
상속받은 메서드 요약
공개 메서드
<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. 같음 (객체 기타)
<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)
<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입니다. |
|---|