도형
도형이란 지도 위에 그릴 수 있는 기하학적인 벡터 그래픽을 의미합니다. 도형의 종류로는 폴리곤, 폴리라인, 원 등이 있습니다. 도형을 지도 위에 그리는 방법을 설명합니다.
폴리곤
지도상에 다각형 모양의 면 형태로 표출되는 셰이프를 의미합니다.
추가 및 삭제
지도 위에 다각형을 추가하려면 InvPolygon
객체를 생성한 다음 반드시 coords
속성을 설정해주어야 합니다. coords
속성은 setCoords()
함수를 사용하거나, 폴리곤 객체 생성자를 통해 설정할 수 있습니다.
생성된 폴리곤 객체의 map
속성을 표출하고자 하는 지도 객체로 설정하면 폴리곤이 지도 위에 표출됩니다.
반대로 지도에서 폴리곤을 제거하려면 map
속성을 null
로 설정하면 됩니다.
좌표열
coords
속성으로 폴리곤의 좌표열을 가져오거나 새로 설정할 수 있습니다. 좌표열 원소의 개수는 3
이상이어야 합니다. coords
속성을 설정하지 않았거나, 좌표열의 원소 개수가 3
미만이거나, 좌표열 중 null
인 좌표가 존재할 경우 InvalidLatLngException
이 발생합니다.
coords
속성을 설정하는데 사용한 객체 또는 이미 설정된 coords
속성 객체의 원소를 추가하거나 삭제하더라도 지도에 변경사항이 반영되지 않습니다. 반드시 coords
속성을 다시 설정해주어야 좌표열의 변경사항이 반영됩니다.
채우기 색상
fillColor
속성으로 폴리곤의 채우기 색상을 가져오거나 새로 설정할 수 있습니다.
테두리 두께 및 색상
strokeWidth
속성으로 폴리곤의 테두리 두께를, strokeColor
속성으로 테두리 색상을 각각 가져오거나 새로 설정할 수 있습니다.
폴리라인
지도상에 선 형태로 표출되는 셰이프를 의미합니다.
추가 및 삭제
지도 위에 선형을 추가하려면 InvPolyline
객체를 생성한 다음 반드시 coords
속성을 설정해주어야 합니다. coords
속성은 setCoords()
함수를 사용하거나, 폴리라인 객체 생성자를 통해 설정할 수 있습니다.
생성된 폴리라인 객체의 map
속성을 표출하고자 하는 지도 객체로 설정하면 폴리라인이 지도 위에 표출됩니다.
반대로 지도에서 폴리라인을 제거하려면 map
속성을 null
로 설정하면 됩니다.
좌표열
coords
속성으로 폴리라인의 좌표열을 가져오거나 새로 설정할 수 있습니다. 좌표열 원소의 개수는 2
이상이어야 합니다. coords
속성을 설정하지 않았거나, 좌표열의 원소 개수가 2
미만이거나, 좌표열 중 null
인 좌표가 존재할 경우 InvalidLatLngException
이 발생합니다.
coords
속성을 설정하는데 사용한 객체 또는 이미 설정된 coords
속성을 가져와서 원소를 추가하거나 삭제하더라도 지도에 변경사항이 반영되지 않습니다. 반드시 coords
속성을 다시 설정해주어야 좌표열의 변경사항이 반영됩니다.
두께
width
속성으로 폴리라인의 두께를 가져오거나 새로 설정할 수 있습니다.
색상
color
속성으로 폴리라인의 색상을 가져오거나 새로 설정할 수 있습니다.
점선 패턴
pattern
속성으로 폴리라인의 점선 패턴을 가져오거나 새로 설정할 수 있습니다. setPattern()
함수 호출 시 파라미터의 개수는 반드시 2개 이상이어야 합니다. 홀수 번째 파라미터는 실선의 길이, 짝수 번째 파라미터는 공백의 길이를 의미하며, 설정한 파라미터의 개수만큼 실선과 공백이 반복되는 패턴이 적용됩니다.
끝 지점 모양
capType
속성으로 폴리라인의 끝 지점 모양을 가져오거나 새로 설정할 수 있습니다. 끝 지점 모양의 유형은 InvPolyline.LineCap
열거형에 정의되어 있으며, 유형별 특징은 다음과 같습니다.
연결점 모양
joinType
속성으로 폴리라인의 연결점 모양을 가져오거나 새로 설정할 수 있습니다. 연결점 모양의 유형은 InvPolyline.LineJoin
열거형에 정의되어 있으며, 유형별 특징은 다음과 같습니다.
원
지도상에 원 모양의 면 형태로 표출되는 셰이프를 의미합니다.
추가 및 삭제
지도 위에 원을 추가하려면 InvCircle
객체를 생성한 다음 반드시 center
속성을 설정해주어야 합니다. center
속성은 setCenter()
함수를 사용하거나, 원 객체 생성자를 통해 설정할 수 있습니다.
생성된 원 객체의 map
속성을 표출하고자 하는 지도 객체로 설정하면 원이 지도 위에 표출됩니다.
반대로 지도에서 원을 제거하려면 map
속성을 null
로 설정하면 됩니다.
중심점 좌표
center
속성으로 원의 중심점 좌표를 가져오거나 새로 설정할 수 있습니다. center
속성을 설정하지 않으면 InvalidLatLngException
이 발생합니다. 이미 지도에 원이 그려지고 있는 상태에서 center
속성을 변경하면 변경된 좌표로 원이 이동합니다.
반경
radius
속성으로 원의 반경을 가져오거나 새로 설정할 수 있습니다.
채우기 색상
fillColor
속성으로 원의 채우기 색상을 가져오거나 새로 설정할 수 있습니다.
테두리 두께 및 색상
strokeWidth
속성으로 원의 테두리 두께를, strokeColor
속성으로 테두리 색상을 각각 가져오거나 새로 설정할 수 있습니다.
Last updated