KML

KmlLayer 클래스

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

const {KmlLayer} = await google.maps.importLibrary("maps");
KmlLayer
KmlLayer([opts])
매개변수:
지정된 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)
매개변수:
반환 값: 없음
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)
인수:
이 이벤트는 레이어의 지형지물을 클릭하면 시작됩니다.
defaultviewport_changed
function()
인수: 없음
이 이벤트는 KML 레이어의 기본 뷰포트가 변경되면 시작됩니다.
status_changed
function()
인수: 없음
이 이벤트는 KML 레이어 로드가 완료되면 실행됩니다. 이 시점에서 상태 속성을 읽어 레이어가 성공적으로 로드되었는지 확인할 수 있습니다.

KmlLayerOptions 인터페이스

인터페이스 google.maps.KmlLayerOptions

이 객체는 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

단일 KML 레이어에 대한 JSON 형식의 메타데이터입니다.
description
유형: string
레이어 마크업에서 추출된 레이어의 <description>입니다.
hasScreenOverlays
유형: boolean
레이어에 화면 오버레이가 있는지 여부입니다.
name
유형: string
레이어 마크업에서 추출된 레이어의 <name>입니다.
snippet
유형: string
레이어 마크업에서 추출한 레이어의 <Snippet>
author
선택사항
유형: KmlAuthor optional
레이어 마크업에서 추출된 레이어의 <atom:author>입니다.

KmlLayerStatus 상수

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

문서 로드가 완료되면 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

KML/KMZ 또는 GeoRSS 문서의 click 이벤트 속성입니다.
featureData
클릭된 지형지물에 관한 정보가 포함된 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
작성자의 홈페이지 또는 빈 문자열(지정하지 않은 경우)입니다.