KML

KmlLayer 클래스

google.maps.KmlLayer 클래스

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

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

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

KmlLayer
KmlLayer([opts])
매개변수: 
지정된 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)
매개변수: 
반환 값: 없음
지정된 지도에서 KML Layer를 렌더링합니다. 지도를 null로 설정하면 레이어가 삭제됩니다.
setOptions
setOptions(options)
매개변수: 
반환 값: 없음
setUrl
setUrl(url)
매개변수: 
  • urlstring
반환 값: 없음
표시할 KML 파일의 URL을 설정합니다.
setZIndex
setZIndex(zIndex)
매개변수: 
  • zIndexnumber 설정할 Z-색인입니다.
반환 값: 없음
KML 레이어의 Z-색인을 설정합니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
인수: 
이 이벤트는 레이어의 지형지물을 클릭하면 시작됩니다.
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
작성자의 홈페이지 또는 빈 문자열(지정하지 않은 경우)입니다.