KML

KmlLayer 클래스

class google.maps.KmlLayer extends MVCObject
library "maps"

지원 중단됨: Maps JavaScript API의 KmlLayer 기능은 버전 3.66부터 Maps JavaScript API에서 더 이상 사용할 수 없습니다. 자세한 내용은 https://developers.google.com/maps/deprecations를 참고하세요.

const {KmlLayer} = await google.maps.importLibrary("maps");

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

메서드
getDefaultViewport	getDefaultViewport() 매개변수: 없음 반환 값: LatLngBounds|null 표시 중인 레이어의 기본 뷰포트를 가져옵니다.
getMap	getMap() 매개변수: 없음 반환 값: Map|null KML Layer가 렌더링되는 지도를 가져옵니다.
getMetadata	getMetadata() 매개변수: 없음 반환 값: KmlLayerMetadata|null 레이어 마크업에 지정된 대로 이 레이어에 연결된 메타데이터를 가져옵니다.
getStatus	getStatus() 매개변수: 없음 반환 값: KmlLayerStatus|null 요청된 문서가 로드되면 설정되는 레이어의 상태를 가져옵니다.
getUrl	getUrl() 매개변수: 없음 반환 값: string URL 표시되는 KML 파일의 URL을 가져옵니다.
getZIndex	getZIndex() 매개변수: 없음 반환 값: number Z-색인 KML 레이어의 z-색인을 가져옵니다.
setMap	setMap(map) 매개변수: map: Map optional 반환 값: 없음 지정된 지도에서 KML Layer를 렌더링합니다. 지도가 null로 설정되면 레이어가 삭제됩니다.
setOptions	setOptions(options) 매개변수: options: KmlLayerOptions optional 반환 값: 없음
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

지원 중단됨: Maps JavaScript API의 KmlLayer 기능은 버전 3.66부터 Maps JavaScript API에서 더 이상 사용할 수 없습니다. 자세한 내용은 https://developers.google.com/maps/deprecations를 참고하세요.

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

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

KmlLayerMetadata 인터페이스

인터페이스 google.maps.KmlLayerMetadata

지원 중단됨: Maps JavaScript API의 KmlLayer 기능은 버전 3.66부터 Maps JavaScript API에서 더 이상 사용할 수 없습니다. 자세한 내용은 https://developers.google.com/maps/deprecations를 참고하세요.

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

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

KmlLayerStatus 상수

상수 google.maps.KmlLayerStatus
라이브러리 "maps"

지원 중단됨: Maps JavaScript API의 KmlLayer 기능은 버전 3.66부터 Maps JavaScript API에서 더 이상 사용할 수 없습니다. 자세한 내용은 https://developers.google.com/maps/deprecations를 참고하세요.

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

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 KmlLayerStatusString 유형으로 정의됩니다.

const {KmlLayerStatus} = await google.maps.importLibrary("maps");

상수
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

지원 중단됨: Maps JavaScript API의 KmlLayer 기능은 버전 3.66부터 Maps JavaScript API에서 더 이상 사용할 수 없습니다. 자세한 내용은 https://developers.google.com/maps/deprecations를 참고하세요.

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

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

KmlFeatureData 인터페이스

인터페이스 google.maps.KmlFeatureData

지원 중단됨: Maps JavaScript API의 KmlLayer 기능은 버전 3.66부터 Maps JavaScript API에서 더 이상 사용할 수 없습니다. 자세한 내용은 https://developers.google.com/maps/deprecations를 참고하세요.

단일 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

지원 중단됨: Maps JavaScript API의 KmlLayer 기능은 버전 3.66부터 Maps JavaScript API에서 더 이상 사용할 수 없습니다. 자세한 내용은 https://developers.google.com/maps/deprecations를 참고하세요.

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

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