Advanced Markers (beta)

AdvancedMarkerView 클래스

google.maps.marker.AdvancedMarkerView 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

지정된 옵션으로 AdvancedMarkerView를 만듭니다. 지도를 지정하면 생성 시 AdvancedMarkerView가 지도에 추가됩니다. AdvancedMarkerView가 표시되도록 위치를 설정해야 합니다.

이 클래스는 AdvancedMarkerViewOptions를 구현합니다.

&libraries=marker URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {AdvancedMarkerView} = await google.map.importLibrary("marker")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

생성자
AdvancedMarkerView	AdvancedMarkerView([options]) 매개변수: options:  AdvancedMarkerViewOptions optional

속성
collisionBehavior	유형: CollisionBehavior optional AdvancedMarkerViewOptions.collisionBehavior 페이지를 참고하세요.
content	유형: Element optional AdvancedMarkerViewOptions.content 페이지를 참고하세요.
draggable	유형: boolean optional AdvancedMarkerViewOptions.draggable 페이지를 참고하세요.
element optional	유형: HTMLElement|SVGElement optional 읽기 전용 필드입니다. 뷰를 지원하는 DOM 요소입니다.
map	유형: Map optional AdvancedMarkerViewOptions.map 페이지를 참고하세요.
position	유형: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional AdvancedMarkerViewOptions.position 페이지를 참고하세요.
title	유형: string optional AdvancedMarkerViewOptions.title 페이지를 참고하세요.
zIndex	유형: number optional AdvancedMarkerViewOptions.zIndex 페이지를 참고하세요.

방법
addListener	addListener(eventName, handler) 매개변수: eventName: string handler:  Function 반환 값: MapsEventListener 지정된 이벤트 이름에 지정된 리스너 함수를 추가합니다.

이벤트
click	function(event) 인수: event: MapMouseEvent 이 이벤트는 AdvancedMarkerView 요소를 클릭하면 시작됩니다.
drag	function(event) 인수: event: MapMouseEvent 이 이벤트는 사용자가 AdvancedMarkerView를 드래그하는 동안 반복적으로 발생합니다.
dragend	function(event) 인수: event: MapMouseEvent 이 이벤트는 사용자가 AdvancedMarkerView 드래그를 중지하면 실행됩니다.
dragstart	function(event) 인수: event:  MapMouseEvent 이 이벤트는 사용자가 AdvancedMarkerView 드래그를 시작하면 시작됩니다.

AdvancedMarkerViewOptions 인터페이스

google.maps.marker.AdvancedMarkerViewOptions 인터페이스

참고: v=beta 채널에서만 사용할 수 있습니다.

AdvancedMarkerView를 구성하기 위한 옵션입니다.

속성
collisionBehavior optional	유형: CollisionBehavior optional AdvancedMarkerView가 다른 AdvancedMarkerView 또는 벡터 지도의 기본 지도 라벨과 충돌할 때 동작하는 방법을 지정하는 열거형입니다. 참고: AdvancedMarkerView에서 AdvancedMarkerView로의 충돌은 래스터 지도와 벡터 지도 모두에서 작동하지만 AdvancedMarkerView에서 기본 지도의 라벨과의 충돌은 벡터 지도에서만 작동합니다.
content optional	유형: Element optional 기본값: PinView.element AdvancedMarkerView의 시각 요소를 지원하는 DOM 요소입니다. 참고: AdvancedMarkerView는 전달된 DOM 요소를 클론하지 않습니다. DOM 요소가 AdvancedMarkerView에 전달되면 동일한 DOM 요소를 다른 AdvancedMarkerView에 전달하면 DOM 요소가 이동되고 이전 AdvancedMarkerView는 비어 있는 것처럼 보입니다.
draggable optional	유형: boolean optional 기본값: false true인 경우 AdvancedMarkerView을 드래그할 수 있습니다. 참고: 고도가 있는 AdvancedMarkerView는 드래그할 수 없습니다.
element optional	유형: HTMLElement|SVGElement optional 읽기 전용 필드입니다. 뷰를 지원하는 DOM 요소입니다.
map optional	유형: Map optional AdvancedMarkerView를 표시할 지도입니다. 지도는 AdvancedMarkerView를 표시하는 데 필요하며 생성 시 제공되지 않는 경우 AdvancedMarkerView.map를 설정하여 제공할 수 있습니다.
position optional	유형: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional AdvancedMarkerView의 위치를 설정합니다. AdvancedMarkerView는 위치 없이 생성할 수 있지만 위치가 제공될 때까지 표시되지 않습니다(예: 사용자의 작업 또는 선택에 의해). AdvancedMarkerView의 위치는 생성 과정에서 제공되지 않는 경우 AdvancedMarkerView.position를 설정하여 제공할 수 있습니다. 참고: 고도가 포함된 AdvancedMarkerView는 벡터 지도에서만 지원됩니다.
title optional	유형: string optional 텍스트를 롤오버합니다. 제공되는 경우 접근성 텍스트 (예: 스크린 리더 사용)가 제공된 값과 함께 AdvancedMarkerView에 추가됩니다.
zIndex optional	유형: number optional 모든 AdvancedMarkerView가 zIndex 순으로 지도에 표시되며 값이 높은 값이 AdvancedMarkerView 앞에 표시됩니다. 기본적으로 AdvancedMarkerView는 화면의 세로 위치에 따라 표시되며 AdvancedMarkerView이 더 낮으면 화면 앞 AdvancedMarkerView에 표시됩니다. zIndex는 CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY 고급 마커 간의 상대적 우선순위를 결정하는 데도 사용됩니다. zIndex 값이 클수록 우선순위가 높습니다.

PinView 클래스

google.maps.marker.PinView 클래스

참고: v=beta 채널에서만 사용할 수 있습니다.

PinView은 도형과 글리프로 구성된 DOM 요소를 나타냅니다. 도형은 기본 AdvancedMarkerView에서와 동일한 풍선 스타일을 가집니다. 글리프는 풍선 모양에 표시되는 선택적 DOM 요소입니다. PinView는 PinView.scale에 따라 가로세로 비율이 다를 수 있습니다.

이 클래스는 PinViewOptions를 구현합니다.

&libraries=marker URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {PinView} = await google.map.importLibrary("marker")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

생성자
PinView	PinView([options]) 매개변수: options:  PinViewOptions optional

속성
background	유형: string optional PinViewOptions.background 페이지를 참고하세요.
borderColor	유형: string optional PinViewOptions.borderColor 페이지를 참고하세요.
element optional	유형: HTMLElement|SVGElement optional 읽기 전용 필드입니다. 뷰를 지원하는 DOM 요소입니다.
glyph	유형: string|Element|URL optional PinViewOptions.glyph 페이지를 참고하세요.
glyphColor	유형: string optional PinViewOptions.glyphColor 페이지를 참고하세요.
scale	유형: number optional PinViewOptions.scale 페이지를 참고하세요.

방법
addListener	addListener(eventName, handler) 매개변수: eventName:  string handler: Function 반환 값: MapsEventListener 지정된 이벤트 이름에 지정된 리스너 함수를 추가합니다.

PinViewOptions 인터페이스

google.maps.marker.PinViewOptions 인터페이스

참고: v=beta 채널에서만 사용할 수 있습니다.

PinView를 만드는 옵션입니다.

속성
background optional	유형: string optional 핀 도형의 배경색입니다. 모든 CSS 색상 값을 지원합니다.
borderColor optional	유형: string optional 핀 도형의 테두리 색상입니다. 모든 CSS 색상 값을 지원합니다.
element optional	유형: HTMLElement|SVGElement optional 읽기 전용 필드입니다. 뷰를 지원하는 DOM 요소입니다.
glyph optional	유형: string|Element|URL optional 핀에 표시되는 DOM 요소입니다.
glyphColor optional	유형: string optional 글리프의 색상입니다. 모든 CSS 색상 값을 지원합니다.
scale optional	유형: number optional 기본값: 1 핀의 크기입니다.