KML

KmlLayer 类

google.maps.KmlLayer 类

KmlLayer 会从托管在可公开访问的 Web 服务器上的 KML、KMZ 或 GeoRSS 文件中向地图添加地理标记。点击每个地图项时，系统都会为其提供一个 KmlFeatureData 对象。

此类扩展了 MVCObject。

通过调用 const {KmlLayer} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。

构造函数
KmlLayer	KmlLayer([opts]) 参数：  opts：此图层的 KmlLayerOptions optional 选项。 创建一个 KmlLayer，用于渲染指定 KML/KMZ 文件 (https://developers.google.com/kml/documentation/kmlreference) 或 GeoRSS 文件 (http://www.georss.org) 的内容。

方法
getDefaultViewport	getDefaultViewport() 参数：无 返回值：  LatLngBounds 获取适用于所显示图层的默认视口。
getMap	getMap() 参数：无 返回值：  Map 获取在其上渲染 KML 图层的地图。
getMetadata	getMetadata() 参数：无 返回值：  KmlLayerMetadata 获取与此图层相关联的元数据，如图层标记中所指定。
getStatus	getStatus() 参数：无 返回值：  KmlLayerStatus 获取图层的状态，在请求的文件加载后设置。
getUrl	getUrl() 参数：无 返回值：  string 网址 获取正在显示的 KML 文件的网址。
getZIndex	getZIndex() 参数：无 返回值：  number Z 轴顺序。 获取 KML 图层的 z 轴顺序。
setMap	setMap(map) 参数：  map：Map 返回值：None 在指定地图上渲染该 KML 图层。如果将 map 设置为 null，系统会移除该图层。
setOptions	setOptions(options) 参数：  options：KmlLayerOptions 返回值：None
setUrl	setUrl(url) 参数：  url：string 返回值：None 设置要显示的 KML 文件的网址。
setZIndex	setZIndex(zIndex) 参数：  zIndex：number 要设置的 z-index。 返回值：None 设置 KML 图层的 z 轴顺序。
继承： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

事件
click	function(kmlClickEvent) 参数：  kmlClickEvent：KmlMouseEvent 点击图层中的特征时将会触发此事件。
defaultviewport_changed	function() 参数：None 当 KML 图层默认可视区域改变时会触发此事件。
status_changed	function() 参数：None 当 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 文档的网址。
zIndex optional	类型：  number optional 图层的 z-index。

KmlLayerMetadata 接口

google.maps.KmlLayerMetadata 接口

一个 KML 图层的元数据（采用 JSON 格式）。

属性
description	类型：  string 从图层标记中提取的图层 <description>。
hasScreenOverlays	类型：  boolean 图层是否有任何屏幕叠加层。
name	类型：  string 从图层标记中提取的图层 <name>。
snippet	类型：  string 从图层标记中提取的图层 <Snippet>
author optional	类型：  KmlAuthor optional 从图层标记中提取的图层 <atom:author>。

KmlLayerStatus 常量

google.maps.KmlLayerStatus 常量

KmlLayer 在加载文档完成后返回的状态。您可以按值指定这些参数，也可以使用常量的名称指定这些参数。例如 'OK' 或 google.maps.KmlLayerStatus.OK。

通过调用 const {KmlLayerStatus} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。

常量
DOCUMENT_NOT_FOUND	找不到该文档。网址很可能是无效的，或者相应文件未公开发布。
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 接口

一个 JSON 格式的 KML 特征数据，当点击 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 作者的主页，或空字符串（如果未指定）。