KML

Classe KmlLayer

Classe google.maps.KmlLayer

Um KmlLayer adiciona marcação geográfica 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.

KmlLayer
KmlLayer([opts])
Parâmetros:
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).
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
Consulte o status da camada, definido após o carregamento do documento solicitado.
getUrl
getUrl()
Parâmetros: nenhum
Valor de retorno:string URL
Recebe o URL do arquivo KML exibido.
getZIndex
getZIndex()
Parâmetros:nenhum
Valor de retorno: number é o Z-index.
Recebe o Z-index da camada KML.
setMap
setMap(map)
Parâmetros:
Valor de retorno:nenhum
Renderiza a camada KML no mapa especificado. Quando o mapa é definido como null, a camada é removida.
setOptions
setOptions(options)
Parâmetros:
Valor de retorno: nenhum
setUrl
setUrl(url)
Parâmetros:
  • urlstring
Valor de retorno:nenhum
Define o URL do arquivo KML a ser exibido.
setZIndex
setZIndex(zIndex)
Parâmetros:
  • zIndexnumber o Z-index a ser definido.
Valor de retorno:nenhum
Define o Z-index da camada KML.
Herdados: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
Argumentos:
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 momento, é seguro ler a propriedade de status para determinar se a camada foi carregada.

Interface KmlLayerOptions

Interface google.maps.KmlLayerOptions

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

clickable optional
Tipo:boolean optional
Se for true, a camada vai receber eventos de mouse. O valor padrão é true.
map optional
Tipo:Map optional
O mapa no qual exibir a camada.
preserveViewport optional
Tipo: boolean optional
Por padrão, o mapa é centralizado e seu nível de zoom é ajustado à caixa delimitadora do conteúdo da camada. Se esta opção for definida como true, a janela de visualização não será alterada, a menos que o centro e o zoom do mapa nunca tenham sido definidos.
screenOverlays optional
Tipo: boolean optional
Indica se as sobreposições de tela serão renderizadas. true padrão.
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 a ser exibido.
zIndex optional
Tipo:number optional
Z-index da camada.

Interface KmlLayerMetadata

Interface google.maps.KmlLayerMetadata

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

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 ou não 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 de 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.

DOCUMENT_NOT_FOUND Não foi possível encontrar o documento. Provavelmente, o 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 arquivo 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 razoável.
UNKNOWN Não foi possível carregar o documento por um motivo desconhecido.

Interface AliasLiveData

Interface google.maps.KmlMouseEvent

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

featureData
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 AliasFeatureData

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.

author
O <atom:author> do recurso, extraído da marcação da camada (se especificado).
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 esse 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 [=Author

Interface google.maps.KmlAuthor

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

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.