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) 매개변수:
반환 값: 없음
표시할 KML 파일의 URL을 설정합니다. |
setZIndex |
setZIndex(zIndex) 매개변수:
반환 값: 없음
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> 입니다. |