Em breve, a Plataforma Google Maps usará a nova estilização de mapas. Essa atualização inclui uma nova paleta de cores padrão e melhorias nas experiências de mapa e na usabilidade. Todos os estilos de mapa serão atualizados automaticamente em março de 2025. Para mais informações sobre a disponibilidade e como ativar logo, consulte Novo estilo de mapa para a Plataforma Google Maps.

Esta página foi traduzida pela API Cloud Translation.

KML

Classe KmlLayer

Classe google.maps.KmlLayer

Um KmlLayer adiciona marcações geográficas ao mapa de um arquivo KML, KMZ ou GeoRSS hospedado em um servidor da Web acessível publicamente. Um objeto KmlFeatureData é fornecido para cada recurso quando clicado.

Essa classe estende MVCObject.

Acesse chamando const {KmlLayer} = await google.maps.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
`KmlLayer`	`KmlLayer([opts])` Parâmetros: `opts`: `KmlLayerOptions optional` opções para essa camada. Cria um `KmlLayer` que renderiza o conteúdo do arquivo KML/KMZ especificado (https://developers.google.com/kml/documentation/kmlreference) ou arquivo GeoRSS (http://www.georss.org).

Métodos
`getDefaultViewport`	`getDefaultViewport()` Parâmetros: nenhum Valor de retorno: `LatLngBounds` Obtenha a janela de visualização padrão da camada sendo exibida.
`getMap`	`getMap()` Parâmetros: nenhum Valor de retorno: `Map` Obtém o mapa no qual a camada KML está sendo renderizada.
`getMetadata`	`getMetadata()` Parâmetros: nenhum Valor de retorno: `KmlLayerMetadata` Obtém os metadados associados a esta camada, como especificado na marcação da camada.
`getStatus`	`getStatus()` Parâmetros: nenhum Valor de retorno: `KmlLayerStatus` Acessa o status da camada, definido quando o documento solicitado é carregado.
`getUrl`	`getUrl()` Parâmetros: nenhum Valor de retorno: URL `string` Extrai o URL do arquivo KML que está sendo exibido.
`getZIndex`	`getZIndex()` Parâmetros: nenhum Valor de retorno: `number` é o Z-index. Recupera o Z-index da camada KML.
`setMap`	`setMap(map)` Parâmetros: `map`: `Map` Valor de retorno: nenhum Renderiza a camada KML no mapa especificado. Se o mapa for definido como `null`, a camada será removida.
`setOptions`	`setOptions(options)` Parâmetros: `options`: `KmlLayerOptions` Valor de retorno: nenhum
`setUrl`	`setUrl(url)` Parâmetros: `url`: `string` Valor de retorno: nenhum Define o URL do arquivo KML a ser exibido.
`setZIndex`	`setZIndex(zIndex)` Parâmetros: `zIndex`: `number` o Z-index a ser definido. Valor de retorno: nenhum Define o Z-index da camada KML.
Herdado: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Eventos
`click`	`function(kmlClickEvent)` Argumentos: `kmlClickEvent`: `KmlMouseEvent` Este evento é disparado quando um elemento na camada é clicado.
`defaultviewport_changed`	`function()` Argumentos: nenhum Este evento é disparado quando a janela de visualização padrão de camadas KML é alterada.
`status_changed`	`function()` Argumentos: nenhum Este evento é disparado quando a camada KML termina de carregar. Neste ponto, é seguro ler a propriedade de status para determinar se a camada foi carregada.

Interface KmlLayerOptions

Interface google.maps.KmlLayerOptions

Esse objeto define as propriedades que podem ser definidas em um objeto KmlLayer.

Propriedades
`clickable optional`	Tipo: `boolean optional` Padrão:`true` Se for `true`, a camada receberá eventos de mouse.
`map optional`	Tipo: `Map optional` O mapa no qual exibir a camada.
`preserveViewport optional`	Tipo: `boolean optional` Padrão:`false` Se essa opção for definida como `true` ou se o centro e o zoom do mapa nunca tiverem sido definidos, o mapa de entrada será centralizado e ampliado para a caixa delimitadora do conteúdo da camada.
`screenOverlays optional`	Tipo: `boolean optional` Padrão:`true` Define se as sobreposições de tela devem ser renderizadas.
`suppressInfoWindows optional`	Tipo: `boolean optional` Remove a renderização de janelas de informações quando elementos da camada são clicados.
`url optional`	Tipo: `string optional` O URL do documento KML que será exibido.
`zIndex optional`	Tipo: `number optional` O Z-index da camada.

Interface KmlLayerMetadata.

Interface google.maps.KmlLayerMetadata

Metadados para uma única camada KML, no formato JSON.

Propriedades
`author`	Tipo: `KmlAuthor` O `<atom:author>` da camada, extraído da marcação da camada.
`description`	Tipo: `string` O `<description>` da camada, extraído da marcação da camada.
`hasScreenOverlays`	Tipo: `boolean` Indica se a camada tem sobreposições de tela.
`name`	Tipo: `string` O `<name>` da camada, extraído da marcação da camada.
`snippet`	Tipo: `string` O `<Snippet>` da camada, extraído da marcação da camada.

Constantes KmlLayerStatus

Constantes google.maps.KmlLayerStatus

O status retornado por KmlLayer na conclusão do carregamento de um documento. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'OK' ou google.maps.KmlLayerStatus.OK.

Acesse chamando const {KmlLayerStatus} = await google.maps.importLibrary("maps"). Consulte Bibliotecas na API Maps JavaScript.

Constantes
`DOCUMENT_NOT_FOUND`	Não foi possível encontrar o documento. O mais provável é que seja um URL inválido ou o documento não está disponível publicamente.
`DOCUMENT_TOO_LARGE`	O documento excede os limites de tamanho de arquivo do KMLLayer.
`FETCH_ERROR`	Não foi possível buscar o documento.
`INVALID_DOCUMENT`	O documento não é um documento KML, KMZ ou GeoRSS válido.
`INVALID_REQUEST`	O `KmlLayer` é inválido.
`LIMITS_EXCEEDED`	O documento excede os limites de recursos do KMLLayer.
`OK`	A camada foi carregada.
`TIMED_OUT`	Não foi possível carregar o documento em um período de tempo razoável.
`UNKNOWN`	Falha ao carregar o documento por um motivo desconhecido.

Interface KmlMouseEvent

Interface google.maps.KmlMouseEvent

As propriedades de um evento de clique em um documento KML/KMZ ou GeoRSS.

Propriedades
`featureData`	Tipo: `KmlFeatureData` Um objeto `KmlFeatureData` que contém informações sobre o recurso clicado.
`latLng`	Tipo: `LatLng` A posição à qual ancorar uma janela de informações no elemento clicado.
`pixelOffset`	Tipo: `Size` O deslocamento a ser aplicado a uma janela de informações ancorada ao elemento clicado.

Interface KmlFeatureData

Interface google.maps.KmlFeatureData

Dados para um único elemento KML no formato JSON, retornados quando um elemento KML é clicado. Os dados contidos neste objeto refletem os dados associados ao elemento na marcação KML ou GeoRSS na qual o objeto é declarado.

Propriedades
`author`	Tipo: `KmlAuthor` O `<atom:author>` do recurso, extraído da marcação da camada (se especificada).
`description`	Tipo: `string` O `<description>` do recurso, extraído da marcação da camada.
`id`	Tipo: `string` O `<id>` do recurso, extraído da marcação da camada. Se nenhum `<id>` tiver sido especificado, um ID exclusivo será gerado para o recurso.
`infoWindowHtml`	Tipo: `string` O texto do elemento no estilo de balão, se estiver definido.
`name`	Tipo: `string` O `<name>` do recurso, extraído da marcação da camada.
`snippet`	Tipo: `string` O `<Snippet>` do recurso, extraído da marcação da camada.

Interface KmlAuthor

Interface google.maps.KmlAuthor

Contém detalhes do autor de um documento ou elemento KML.

Propriedades
`email`	Tipo: `string` O endereço de e-mail do autor ou uma string vazia se o endereço não tiver sido especificado.
`name`	Tipo: `string` O nome do autor ou uma string vazia se o nome não tiver sido especificado.
`uri`	Tipo: `string` A página inicial do autor ou uma string vazia se a página inicial não tiver sido especificada.

KML

Classe KmlLayer

Construtor

Métodos

Eventos

Interface KmlLayerOptions

Propriedades

Interface KmlLayerMetadata.

Propriedades

Constantes KmlLayerStatus

Constantes

Interface KmlMouseEvent

Propriedades

Interface KmlFeatureData

Propriedades

Interface KmlAuthor

Propriedades