새로운 지도 스타일이 곧 Google Maps Platform에 제공될 예정입니다. 이 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트와 지도 환경 및 사용성 개선사항이 포함됩니다. 모든 지도 스타일이 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 더 일찍 선택하는 방법에 대한 자세한 내용은 Google Maps Platform용 새로운 지도 스타일을 참고하세요.

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

KML

KmlLayer 클래스

google.maps.KmlLayer 클래스

KmlLayer는 공개적으로 액세스 가능한 웹 서버에 호스팅된 KML, KMZ 또는 GeoRSS 파일의 지도에 지리적 마크업을 추가합니다. 클릭하면 각 지형지물에 KmlFeatureData 객체가 제공됩니다.

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

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

생성자
`KmlLayer`	`KmlLayer([opts])` 매개변수: `opts`: `KmlLayerOptions optional` 레이어의 옵션입니다. 지정된 KML/KMZ 파일 (https://developers.google.com/kml/documentation/kmlreference) 또는 GeoRSS 파일 (http://www.georss.org)의 콘텐츠를 렌더링하는 `KmlLayer`를 만듭니다.

방법
`getDefaultViewport`	`getDefaultViewport()` 매개변수: 없음 반환 값: `LatLngBounds` 표시 중인 레이어의 기본 뷰포트를 가져옵니다.
`getMap`	`getMap()` 매개변수: 없음 반환 값: `Map` KML Layer가 렌더링되는 지도를 가져옵니다.
`getMetadata`	`getMetadata()` 매개변수: 없음 반환 값: `KmlLayerMetadata` 레이어 마크업에 지정된 대로 이 레이어에 연결된 메타데이터를 가져옵니다.
`getStatus`	`getStatus()` 매개변수: 없음 반환 값: `KmlLayerStatus` 레이어의 상태를 가져옵니다. 요청된 문서가 로드되면 설정됩니다.
`getUrl`	`getUrl()` 매개변수: 없음 반환 값: `string` URL 표시 중인 KML 파일의 URL을 가져옵니다.
`getZIndex`	`getZIndex()` 매개변수: 없음 반환 값: `number` Z-색인입니다. KML 레이어의 Z-색인을 가져옵니다.
`setMap`	`setMap(map)` 매개변수: `map`: `Map` 반환 값: 없음 지정된 지도에서 KML Layer를 렌더링합니다. 지도를 `null`로 설정하면 레이어가 삭제됩니다.
`setOptions`	`setOptions(options)` 매개변수: `options`: `KmlLayerOptions` 반환 값: 없음
`setUrl`	`setUrl(url)` 매개변수: `url`: `string` 반환 값: 없음 표시할 KML 파일의 URL을 설정합니다.
`setZIndex`	`setZIndex(zIndex)` 매개변수: `zIndex`: `number` 설정할 Z-색인입니다. 반환 값: 없음 KML 레이어의 Z-색인을 설정합니다.
상속됨: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

이벤트
`click`	`function(kmlClickEvent)` 인수: `kmlClickEvent`: `KmlMouseEvent` 이 이벤트는 레이어의 지형지물을 클릭하면 시작됩니다.
`defaultviewport_changed`	`function()` 인수: 없음 이 이벤트는 KML 레이어의 기본 뷰포트가 변경되면 시작됩니다.
`status_changed`	`function()` 인수: 없음 이 이벤트는 KML 레이어의 로드가 완료되면 시작됩니다. 이 시점에서는 상태 속성을 읽어 레이어가 성공적으로 로드되었는지 확인하는 것이 안전합니다.

KmlLayerOptions 인터페이스

google.maps.KmlLayerOptions 인터페이스

이 객체는 KmlLayer 객체에 설정할 수 있는 속성을 정의합니다.

속성
`clickable optional`	유형: `boolean optional` 기본값: `true` `true`인 경우 레이어가 마우스 이벤트를 수신합니다.
`map optional`	유형: `Map optional` 레이어를 표시할 지도입니다.
`preserveViewport optional`	유형: `boolean optional` 기본값: `false` 이 옵션이 `true`로 설정되거나 지도의 중심과 확대/축소가 설정되지 않은 경우 입력 지도는 중앙에 배치되고 레이어 콘텐츠의 경계 상자로 확대/축소됩니다.
`screenOverlays optional`	유형: `boolean optional` 기본값: `true` 화면 오버레이를 렌더링할지 여부입니다.
`suppressInfoWindows optional`	유형: `boolean optional` 레이어 지형지물을 클릭할 때 정보창의 렌더링을 억제합니다.
`url optional`	유형: `string optional` 표시할 KML 문서의 URL입니다.
`zIndex optional`	유형: `number optional` 레이어의 Z-색인입니다.

KmlLayerMetadata 인터페이스

google.maps.KmlLayerMetadata 인터페이스

단일 KML 레이어에 대한 JSON 형식의 메타데이터입니다.

속성
`author`	유형: `KmlAuthor` 레이어 마크업에서 추출된 레이어의 `<atom:author>`입니다.
`description`	유형: `string` 레이어 마크업에서 추출된 레이어의 `<description>`입니다.
`hasScreenOverlays`	유형: `boolean` 레이어에 화면 오버레이가 있는지 여부입니다.
`name`	유형: `string` 레이어 마크업에서 추출된 레이어의 `<name>`입니다.
`snippet`	유형: `string` 레이어 마크업에서 추출된 레이어의 `<Snippet>`

KmlLayerStatus 상수

google.maps.KmlLayerStatus 상수

문서 로드 완료 시 KmlLayer에서 반환한 상태입니다. 값 또는 상수 이름을 사용하여 지정합니다. 예를 들어 'OK' 또는 google.maps.KmlLayerStatus.OK입니다.

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

상수
`DOCUMENT_NOT_FOUND`	문서를 찾을 수 없습니다. 잘못된 URL이거나 공개적으로 사용할 수 없는 문서일 가능성이 높습니다.
`DOCUMENT_TOO_LARGE`	문서가 KmlLayer의 파일 크기 제한을 초과합니다.
`FETCH_ERROR`	문서를 가져올 수 없습니다.
`INVALID_DOCUMENT`	문서가 유효한 KML, KMZ 또는 GeoRSS 문서가 아닙니다.
`INVALID_REQUEST`	`KmlLayer`가 잘못되었습니다.
`LIMITS_EXCEEDED`	문서가 KmlLayer의 기능 제한을 초과합니다.
`OK`	레이어가 로드되었습니다.
`TIMED_OUT`	문서를 적절한 시간 내에 로드할 수 없습니다.
`UNKNOWN`	알 수 없는 이유로 문서를 로드하지 못했습니다.

KmlMouseEvent 인터페이스

google.maps.KmlMouseEvent 인터페이스

KML/KMZ 또는 GeoRSS 문서의 click 이벤트 속성입니다.

속성
`featureData`	유형: `KmlFeatureData` 클릭된 지형지물에 관한 정보가 포함된 `KmlFeatureData` 객체
`latLng`	유형: `LatLng` 클릭된 지형지물에 정보창을 고정할 위치입니다.
`pixelOffset`	유형: `Size` 클릭된 지형지물에 고정되는 정보창에 적용할 오프셋입니다.

KmlFeatureData 인터페이스

google.maps.KmlFeatureData 인터페이스

단일 KML 지형지물에 대한 JSON 형식의 데이터로, KML 지형지물을 클릭하면 반환됩니다. 선언된 KML 또는 GeoRSS 마크업의 지형지물과 연결된 이 객체 미러에 포함된 데이터입니다.

속성
`author`	유형: `KmlAuthor` 레이어 마크업 (지정된 경우)에서 추출된 지형지물의 `<atom:author>`입니다.
`description`	유형: `string` 레이어 마크업에서 추출된 지형지물의 `<description>`입니다.
`id`	유형: `string` 레이어 마크업에서 추출된 지형지물의 `<id>`입니다. `<id>`를 지정하지 않으면 이 지형지물에 대한 고유 ID가 생성됩니다.
`infoWindowHtml`	유형: `string` 지형지물의 풍선 스타일 텍스트입니다(설정한 경우).
`name`	유형: `string` 레이어 마크업에서 추출된 지형지물의 `<name>`입니다.
`snippet`	유형: `string` 레이어 마크업에서 추출된 지형지물의 `<Snippet>`입니다.

KmlAuthor 인터페이스

google.maps.KmlAuthor 인터페이스

KML 문서 또는 지형지물의 작성자 세부정보를 포함합니다.

속성
`email`	유형: `string` 작성자의 이메일 주소 또는 빈 문자열(지정하지 않은 경우)입니다.
`name`	유형: `string` 작성자의 이름 또는 빈 문자열(지정하지 않은 경우)입니다.
`uri`	유형: `string` 작성자의 홈페이지 또는 빈 문자열(지정하지 않은 경우)입니다.

KML