이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Marker (legacy)

Marker 클래스

google.maps.Marker 클래스

이 클래스는 MVCObject를 확장합니다.

const {Marker} = await google.maps.importLibrary("marker")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

생성자
`Marker`	`Marker([opts])` 매개변수: `opts`: `MarkerOptions optional` 이름이 지정된 선택적 인수 지정된 옵션으로 마커를 만듭니다. 지도를 지정하면 생성 시 마커가 지도에 추가됩니다. 마커가 표시되려면 위치를 설정해야 합니다.

상수
`MAX_ZINDEX`	API가 마커에 할당할 최대 기본 z-색인입니다. 높은 z-색인을 설정하여 마커를 앞으로 가져올 수 있습니다.

메서드
`getAnimation`	`getAnimation()` 매개변수: 없음 반환 값: `Animation\|null\|undefined` 현재 실행 중인 애니메이션을 가져옵니다.
`getClickable`	`getClickable()` 매개변수: 없음 반환 값: 마커를 클릭할 수 있으면 `boolean` True입니다. `Marker`의 클릭 가능한 상태를 가져옵니다.
`getCursor`	`getCursor()` 매개변수: 없음 반환 값: `string\|null\|undefined` 마우스 오버 시 표시되는 마우스 커서 유형을 가져옵니다.
`getDraggable`	`getDraggable()` 매개변수: 없음 반환 값: 마커를 드래그할 수 있으면 `boolean` True입니다. `Marker`의 드래그 가능 상태를 가져옵니다.
`getIcon`	`getIcon()` 매개변수: 없음 반환 값: `string\|Icon\|Symbol\|null\|undefined` `Marker`의 아이콘을 가져옵니다. `MarkerOptions.icon` 페이지를 참고하세요.
`getLabel`	`getLabel()` 매개변수: 없음 반환 값: `MarkerLabel\|string\|null\|undefined` `Marker`의 라벨을 가져옵니다. `MarkerOptions.label` 페이지를 참고하세요.
`getMap`	`getMap()` 매개변수: 없음 반환 값: `Map\|StreetViewPanorama` `Marker`이 렌더링되는 지도 또는 파노라마를 가져옵니다.
`getOpacity`	`getOpacity()` 매개변수: 없음 반환 값: `number\|null\|undefined` 0.0~1.0 사이의 숫자입니다. `Marker`의 불투명도를 가져옵니다.
`getPosition`	`getPosition()` 매개변수: 없음 반환 값: `LatLng\|null\|undefined` `Marker`의 위치를 가져옵니다.
`getShape`	`getShape()` 매개변수: 없음 반환 값: `MarkerShape\|null\|undefined` 상호작용에 사용된 `Marker`의 모양을 가져옵니다. `MarkerOptions.shape` 및 `MarkerShape`을 참고하세요.
`getTitle`	`getTitle()` 매개변수: 없음 반환 값: `string\|null\|undefined` `Marker` 도움말의 제목을 가져옵니다. `MarkerOptions.title` 페이지를 참고하세요.
`getVisible`	`getVisible()` 매개변수: 없음 반환 값: 마커가 표시되면 `boolean` True입니다. `Marker`의 가시성을 가져옵니다.
`getZIndex`	`getZIndex()` 매개변수: 없음 반환 값: 마커의 `number\|null\|undefined` zIndex입니다. `Marker`의 zIndex를 가져옵니다. `MarkerOptions.zIndex` 페이지를 참고하세요.
`setAnimation`	`setAnimation([animation])` 매개변수: `animation`: `Animation optional` 재생할 애니메이션입니다. 반환 값: None 애니메이션을 시작합니다. 진행 중인 모든 애니메이션이 취소됩니다. 현재 지원되는 애니메이션은 `Animation.BOUNCE`, `Animation.DROP`입니다. `null`를 전달하면 애니메이션이 중지됩니다.
`setClickable`	`setClickable(flag)` 매개변수: `flag`: `boolean`인 경우 `true`이면 마커를 클릭할 수 있습니다. 반환 값: None `Marker`을 클릭할 수 있는지 설정합니다.
`setCursor`	`setCursor([cursor])` 매개변수: `cursor`: `string optional` 마우스 커서 유형입니다. 반환 값: None 마우스 오버 시 표시되는 마우스 커서 유형을 설정합니다.
`setDraggable`	`setDraggable(flag)` 매개변수: `flag`: `boolean optional`인 경우 `true`이면 마커를 드래그할 수 있습니다. 반환 값: None `Marker`이 드래그 가능한지 설정합니다.
`setIcon`	`setIcon([icon])` 매개변수: `icon`: `string\|Icon\|Symbol optional` 반환 값: None `Marker`의 아이콘을 설정합니다. `MarkerOptions.icon` 페이지를 참고하세요.
`setLabel`	`setLabel([label])` 매개변수: `label`: `string\|MarkerLabel optional` 라벨은 문자열 또는 `MarkerLabel` 객체일 수 있습니다. 반환 값: None `Marker`의 라벨을 설정합니다. `MarkerOptions.label` 페이지를 참고하세요.
`setMap`	`setMap(map)` 매개변수: `map`: `Map\|StreetViewPanorama` 반환 값: None 지정된 지도 또는 파노라마에 `Marker`를 렌더링합니다. 지도가 `null`로 설정되면 마커가 삭제됩니다.
`setOpacity`	`setOpacity([opacity])` 매개변수: `opacity`: `number optional` 0.0(투명)과 1.0(불투명) 사이의 숫자입니다. 반환 값: None `Marker`의 불투명도를 설정합니다.
`setOptions`	`setOptions(options)` 매개변수: `options`: `MarkerOptions` 반환 값: None `Marker` 옵션을 설정합니다.
`setPosition`	`setPosition([latlng])` 매개변수: `latlng`: `LatLng\|LatLngLiteral optional` 새 위치입니다. 반환 값: None `Marker`의 위치를 설정합니다.
`setShape`	`setShape([shape])` 매개변수: `shape`: `MarkerShape optional` 반환 값: None 상호작용에 사용되는 `Marker`의 모양을 설정합니다. `MarkerOptions.shape` 및 `MarkerShape`을 참고하세요.
`setTitle`	`setTitle([title])` 매개변수: `title`: `string optional` 반환 값: None `Marker` 도움말의 제목을 설정합니다. `MarkerOptions.title` 페이지를 참고하세요.
`setVisible`	`setVisible(visible)` 매개변수: `visible`: `true`인 경우 마커가 표시됩니다.`boolean` 반환 값: None `Marker`이 표시되는 경우 설정됩니다.
`setZIndex`	`setZIndex([zIndex])` 매개변수: `zIndex`: `number optional` 반환 값: None `Marker`의 zIndex를 설정합니다. `MarkerOptions.zIndex` 페이지를 참고하세요.
상속: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

이벤트
`animation_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` 애니메이션 속성이 변경될 때 발생합니다.
`click`	`function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 `Marker` 아이콘을 클릭했을 때 발생합니다.
`clickable_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` 클릭 가능 속성이 변경될 때 발생합니다.
`contextmenu`	`function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 `Marker`에서 DOM contextmenu 이벤트가 발생할 때 실행됩니다.
`cursor_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` 커서 속성이 변경될 때 발생합니다.
`dblclick`	`function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 `Marker` 아이콘을 더블클릭했을 때 발생합니다.
`drag`	`function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 사용자가 `Marker`을 드래그하는 동안 반복적으로 실행됩니다.
`dragend`	`function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 사용자가 `Marker` 드래그를 중지할 때 발생합니다.
`draggable_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` 드래그 가능 속성이 변경될 때 발생합니다.
`dragstart`	`function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 사용자가 `Marker`를 드래그하기 시작할 때 발생합니다.
`flat_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` 플랫 속성이 변경될 때 발생합니다.
`icon_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` 아이콘 속성이 변경될 때 발생합니다.
`mousedown`	`function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 `Marker`에서 마우스 다운이 발생할 때 실행됩니다.
`mouseout`	`function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 마우스가 `Marker` 아이콘 영역을 벗어날 때 발생합니다.
`mouseover`	`function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 마우스가 `Marker` 아이콘 영역에 들어가면 발생합니다.
`mouseup`	`function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 `Marker`에서 mouseup이 발생할 때 실행됩니다.
`position_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` 위치 속성이 변경될 때 발생합니다.
`shape_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` 도형 속성이 변경될 때 발생합니다.
`title_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` 제목 속성이 변경될 때 발생합니다.
`visible_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` 표시 속성이 변경될 때 발생합니다.
`zindex_changed`	`function()` 인수: 없음 이 이벤트는 `Marker` zIndex 속성이 변경될 때 발생합니다.
`rightclick`	지원 중단됨: macOS에서 control-click과 같은 사용 패턴을 지원하려면 `Marker.contextmenu` 이벤트를 대신 사용하세요. `function(event)` 인수: `event`: `MapMouseEvent` 이 이벤트는 `Marker`을 마우스 오른쪽 버튼으로 클릭할 때 발생합니다.

MarkerOptions 인터페이스

google.maps.MarkerOptions 인터페이스

마커에 설정할 수 있는 속성을 정의하는 데 사용되는 MarkerOptions 객체입니다.

속성
`anchorPoint optional`	유형: `Point optional` 마커의 위치에서 마커를 앵커로 사용하여 열린 정보 창의 끝까지의 오프셋입니다.
`animation optional`	유형: `Animation optional` 기본값: `null` 마커가 지도에 추가되면 재생할 애니메이션입니다.
`clickable optional`	유형: `boolean optional` 기본값: `true` `true`인 경우 마커에서 마우스 및 터치 이벤트를 수신합니다.
`collisionBehavior optional`	지원 중단됨: `collisionBehavior`은 2023년 7월부터 지원이 중단되었습니다. 대신 `AdvancedMarkerElement.collisionBehavior`를 사용하세요. 알림: v=beta 채널에서만 사용할 수 있습니다. 유형: `string\|CollisionBehavior optional` 기본값: `null` 벡터 지도의 마커에 대한 충돌 동작을 설정합니다.
`crossOnDrag optional`	유형: `boolean optional` 기본값: `true` `false`이면 드래그할 때 마커 아래에 표시되는 십자선을 사용 중지합니다.
`cursor optional`	유형: `string optional` 기본값: `pointer` 마우스 오버 시 표시되는 마우스 커서 유형
`draggable optional`	유형: `boolean optional` 기본값: `false` `true`인 경우 마커를 드래그할 수 있습니다. 참고: 이 값을 `true`로 설정하면 `clickable`이 `false`로 설정되어 있어도 마커를 클릭할 수 있습니다.
`icon optional`	유형: `string\|Icon\|Symbol optional` 포그라운드 아이콘 문자열이 제공되면 문자열이 `url`인 `Icon`인 것처럼 처리됩니다.
`label optional`	유형: `string\|MarkerLabel optional` 기본값: `null` 마커에 라벨을 추가합니다. 마커 라벨은 마커 안에 표시되는 문자 또는 숫자입니다. 라벨은 문자열이거나 `MarkerLabel` 객체일 수 있습니다. 제공되고 `MarkerOptions.title`가 제공되지 않으면 제공된 라벨의 텍스트가 포함된 접근성 텍스트 (예: 스크린 리더와 함께 사용)가 마커에 추가됩니다. `label`은 현재 최적화되지 않은 마커의 접근성 텍스트에만 사용됩니다.
`map optional`	유형: `Map\|StreetViewPanorama optional` 마커를 표시할 지도입니다. 마커를 표시하려면 지도가 필요하며, 마커 생성 시 제공되지 않은 경우 `Marker.setMap`로 제공할 수 있습니다.
`opacity optional`	유형: `number optional` 기본값: 1.0 0.0(투명)과 1.0(불투명) 사이의 숫자입니다.
`optimized optional`	유형: `boolean optional` 최적화하면 다수의 마커를 단일 정적 요소로 렌더링하므로 성능이 향상됩니다. 이는 많은 수의 마커가 필요한 경우에 유용합니다. 마커 최적화에 대해 자세히 알아보세요. 참고: 이 최적화는 벡터 지도의 마커에는 영향을 미치지 않습니다.
`position optional`	유형: `LatLng\|LatLngLiteral optional` 마커 위치를 설정합니다. 마커는 사용자의 작업이나 선택과 같이 위치가 제공될 때까지 구성되지만 표시되지 않을 수 있습니다. 마커 생성 시 제공되지 않은 경우 `Marker.setPosition`를 사용하여 마커 위치를 제공할 수 있습니다.
`shape optional`	유형: `MarkerShape optional` 드래그 또는 클릭에 사용되는 이미지 지도 영역 정의입니다.
`title optional`	유형: `string optional` 기본값: `undefined` 텍스트를 롤오버합니다. 제공된 경우 접근성 텍스트 (예: 스크린 리더와 함께 사용)가 제공된 값과 함께 마커에 추가됩니다. `title`은 현재 최적화되지 않은 마커의 접근성 텍스트에만 사용됩니다.
`visible optional`	유형: `boolean optional` 기본값: `true` `true`인 경우 마커가 표시됩니다.
`zIndex optional`	유형: `number optional` 모든 마커가 zIndex 순으로 지도에 표시되며, 값이 높은 마커가 값이 낮은 마커 앞에 표시됩니다. 기본적으로 마커는 수직 위치에 따라 화면에 표시되며 화면에서 위치가 낮은 마커가 위에 있는 마커 앞에 표시됩니다.

CollisionBehavior 상수

google.maps.CollisionBehavior 상수

const {CollisionBehavior} = await google.maps.importLibrary("marker")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.

상수
`OPTIONAL_AND_HIDES_LOWER_PRIORITY`	마커가 다른 마커와 겹치지 않는 경우에만 마커를 표시합니다. 이 유형의 마커 두 개가 겹치면 zIndex가 더 높은 마커가 표시됩니다. zIndex가 동일하면 세로 화면 위치가 더 낮은 마커가 표시됩니다.
`REQUIRED`	충돌과 관계없이 항상 마커를 표시합니다. 이것이 기본 동작입니다.
`REQUIRED_AND_HIDES_OPTIONAL`	충돌과 관계없이 항상 마커를 표시하고 마커와 겹치는 OPTIONAL_AND_HIDES_LOWER_PRIORITY 마커 또는 라벨을 숨깁니다.