Security notice:We have become aware of a security issue that may be affecting websites using specific third-party libraries (including polyfill.io). This issue can sometimes redirect visitors away from the intended website without website owner knowledge or permission. Many of our JavaScript samples previously included apolyfill.ioscript declaration. We have removed this from our samples. If you have used our JavaScript samples that contain this declaration, we recommend removing the declaration.

KML

KmlLayer class

google.maps.KmlLayer class

AKmlLayeradds geographic markup to the map from a KML, KMZ or GeoRSS file that is hosted on a publicly accessible web server. AKmlFeatureDataobject is provided for each feature when clicked.

This class extends MVCObject.

Access by callingconst {KmlLayer} = await google.maps.importLibrary( "maps" ).SeeLibraries in the Maps JavaScript API.

Constructor
`KmlLayer`	`KmlLayer([opts])` Parameters: `opts`:`KmlLayerOptionsoptional`Options for this layer. Creates a`KmlLayer`which renders the contents of the specified KML/KMZ file (https://developers.google /kml/documentation/kmlreference) or GeoRSS file (http:// georss.org).

Methods
`getDefaultViewport`	`getDefaultViewport()` Parameters:None Return Value:`LatLngBounds` Get the default viewport for the layer being displayed.
`getMap`	`getMap()` Parameters:None Return Value:`Map` Get the map on which the KML Layer is being rendered.
`getMetadata`	`getMetadata()` Parameters:None Return Value:`KmlLayerMetadata` Get the metadata associated with this layer, as specified in the layer markup.
`getStatus`	`getStatus()` Parameters:None Return Value:`KmlLayerStatus` Get the status of the layer, set once the requested document has loaded.
`getUrl`	`getUrl()` Parameters:None Return Value:`string`URL Gets the URL of the KML file being displayed.
`getZIndex`	`getZIndex()` Parameters:None Return Value:`number`The z-index. Gets the z-index of the KML Layer.
`setMap`	`setMap(map)` Parameters: `map`:`Map` Return Value:None Renders the KML Layer on the specified map. If map is set to`null`,the layer is removed.
`setOptions`	`setOptions(options)` Parameters: `options`:`KmlLayerOptions` Return Value:None
`setUrl`	`setUrl(url)` Parameters: `url`:`string` Return Value:None Sets the URL of the KML file to display.
`setZIndex`	`setZIndex(zIndex)` Parameters: `zIndex`:`number`The z-index to set. Return Value:None Sets the z-index of the KML Layer.
Inherited: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Events
`click`	`function(kmlClickEvent)` Arguments: `kmlClickEvent`:`KmlMouseEvent` This event is fired when a feature in the layer is clicked.
`defaultviewport_changed`	`function()` Arguments:None This event is fired when the KML layers default viewport has changed.
`status_changed`	`function()` Arguments:None This event is fired when the KML layer has finished loading. At this point it is safe to read the status property to determine if the layer loaded successfully.

KmlLayerOptions interface

google.maps.KmlLayerOptions interface

This object defines the properties that can be set on aKmlLayerobject.

Properties
`clickableoptional`	Type:`booleanoptional` Default:`true` If`true`,the layer receives mouse events.
`mapoptional`	Type:`Mapoptional` The map on which to display the layer.
`preserveViewportoptional`	Type:`booleanoptional` Default:`false` If this option is set to`true`or if the map's center and zoom were never set, the input map is centered and zoomed to the bounding box of the contents of the layer.
`screenOverlaysoptional`	Type:`booleanoptional` Default:`true` Whether to render the screen overlays.
`suppressInfoWindowsoptional`	Type:`booleanoptional` Suppress the rendering of info windows when layer features are clicked.
`urloptional`	Type:`stringoptional` The URL of the KML document to display.
`zIndexoptional`	Type:`numberoptional` The z-index of the layer.

KmlLayerMetadata interface

google.maps.KmlLayerMetadata interface

Metadata for a single KML layer, in JSON format.

Properties
`author`	Type:`KmlAuthor` The layer's`<atom:author>`,extracted from the layer markup.
`description`	Type:`string` The layer's`<description>`,extracted from the layer markup.
`hasScreenOverlays`	Type:`boolean` Whether the layer has any screen overlays.
`name`	Type:`string` The layer's`<name>`,extracted from the layer markup.
`snippet`	Type:`string` The layer's`<Snippet>`,extracted from the layer markup

KmlLayerStatus constants

google.maps.KmlLayerStatus constants

The status returned byKmlLayeron the completion of loading a document. Specify these by value, or by using the constant's name. For example,'OK'orgoogle.maps.KmlLayerStatus.OK.

Access by callingconst {KmlLayerStatus} = await google.maps.importLibrary( "maps" ).SeeLibraries in the Maps JavaScript API.

Constants
`DOCUMENT_NOT_FOUND`	The document could not be found. Most likely it is an invalid URL, or the document is not publicly available.
`DOCUMENT_TOO_LARGE`	The document exceeds the file size limits of KmlLayer.
`FETCH_ERROR`	The document could not be fetched.
`INVALID_DOCUMENT`	The document is not a valid KML, KMZ or GeoRSS document.
`INVALID_REQUEST`	The`KmlLayer`is invalid.
`LIMITS_EXCEEDED`	The document exceeds the feature limits of KmlLayer.
`OK`	The layer loaded successfully.
`TIMED_OUT`	The document could not be loaded within a reasonable amount of time.
`UNKNOWN`	The document failed to load for an unknown reason.

KmlMouseEvent interface

google.maps.KmlMouseEvent interface

The properties of a click event on a KML/KMZ or GeoRSS document.

Properties
`featureData`	Type:`KmlFeatureData` A`KmlFeatureData`object, containing information about the clicked feature.
`latLng`	Type:`LatLng` The position at which to anchor an infowindow on the clicked feature.
`pixelOffset`	Type:`Size` The offset to apply to an infowindow anchored on the clicked feature.

KmlFeatureData interface

google.maps.KmlFeatureData interface

Data for a single KML feature in JSON format, returned when a KML feature is clicked. The data contained in this object mirrors that associated with the feature in the KML or GeoRSS markup in which it is declared.

Properties
`author`	Type:`KmlAuthor` The feature's`<atom:author>`,extracted from the layer markup (if specified).
`description`	Type:`string` The feature's`<description>`,extracted from the layer markup.
`id`	Type:`string` The feature's`<id>`,extracted from the layer markup. If no`<id>`has been specified, a unique ID will be generated for this feature.
`infoWindowHtml`	Type:`string` The feature's balloon styled text, if set.
`name`	Type:`string` The feature's`<name>`,extracted from the layer markup.
`snippet`	Type:`string` The feature's`<Snippet>`,extracted from the layer markup.

KmlAuthor interface

google.maps.KmlAuthor interface

Contains details of the author of a KML document or feature.

Properties
`email`	Type:`string` The author's e-mail address, or an empty string if not specified.
`name`	Type:`string` The author's name, or an empty string if not specified.
`uri`	Type:`string` The author's home page, or an empty string if not specified.

KML

KmlLayer class

Constructor

Methods

Events

KmlLayerOptions interface

Properties

KmlLayerMetadata interface

Properties

KmlLayerStatus constants

Constants

KmlMouseEvent interface

Properties

KmlFeatureData interface

Properties

KmlAuthor interface

Properties