KML

Clase KmlLayer

Clase google.maps.KmlLayer

Un KmlLayer agrega marcas geográficas al mapa desde un archivo KML, KMZ o GeoRSS alojado en un servidor web de acceso público. Cuando se hace clic en cada componente, se proporciona un objeto KmlFeatureData.

Esta clase extiende MVCObject.

Para acceder, llama a const {KmlLayer} = await google.maps.importLibrary("maps"). Consulta Bibliotecas de la API de Maps JavaScript.

KmlLayer
KmlLayer([opts])
Parámetros: 
Crea un KmlLayer que renderiza el contenido del archivo KML/KMZ especificado (https://developers.google.com/kml/documentation/kmlreference) o el archivo GeoRSS (http://www.georss.org).
getDefaultViewport
getDefaultViewport()
Parámetros:  Ninguno
Valor que se muestra:  LatLngBounds
Obtén el viewport predeterminado para la capa que se muestra.
getMap
getMap()
Parámetros:  Ninguno
Valor que se muestra:  Map
Obtén el mapa en el que se renderiza la capa KML.
getMetadata
getMetadata()
Parámetros:  Ninguno
Valor que se muestra:  KmlLayerMetadata
Obtén los metadatos asociados con esta capa, como se especifica en el marcado de la capa.
getStatus
getStatus()
Parámetros:  Ninguno
Valor que se muestra:  KmlLayerStatus
Obtén el estado de la capa, que se establece una vez que se carga el documento solicitado.
getUrl
getUrl()
Parámetros:  Ninguno
Valor que se muestra: URL de string
Obtiene la URL del archivo KML que se muestra.
getZIndex
getZIndex()
Parámetros:  Ninguno
Valor que se muestra:  number El índice z.
Obtiene el índice z de la capa KML.
setMap
setMap(map)
Parámetros: 
Valor que se muestra:  Ninguno
Renderiza la capa KML en el mapa especificado. Si el mapa se establece en null, se quita la capa.
setOptions
setOptions(options)
Parámetros: 
Valor que se muestra:  Ninguno
setUrl
setUrl(url)
Parámetros: 
  • urlstring
Valor que se muestra:  Ninguno
Establece la URL del archivo KML que se mostrará.
setZIndex
setZIndex(zIndex)
Parámetros: 
  • zIndexnumber Es el índice z que se debe establecer.
Valor que se muestra:  Ninguno
Establece el índice z de la capa KML.
Heredado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
Argumentos: 
Este evento se activa cuando se hace clic en un componente de la capa.
defaultviewport_changed
function()
Argumentos:  Ninguno
Este evento se activa cuando cambia el viewport predeterminado de las capas de KML.
status_changed
function()
Argumentos:  Ninguno
Este evento se activa cuando se termina de cargar la capa KML. En este punto, es seguro leer la propiedad de estado para determinar si la capa se cargó correctamente.

Interfaz KmlLayerOptions

Interfaz de google.maps.KmlLayerOptions

Este objeto define las propiedades que se pueden establecer en un objeto KmlLayer.

clickable optional
Tipo:  boolean optional
Predeterminado: true
Si es true, la capa recibe eventos del mouse.
map optional
Tipo:  Map optional
Es el mapa en el que se mostrará la capa.
preserveViewport optional
Tipo:  boolean optional
Predeterminado: false
Si esta opción se establece en true o si nunca se establecieron el centro y el zoom del mapa, el mapa de entrada se centra y se acerca al cuadro delimitador del contenido de la capa.
screenOverlays optional
Tipo:  boolean optional
Predeterminado: true
Indica si se deben renderizar las superposiciones de pantalla.
suppressInfoWindows optional
Tipo:  boolean optional
Suprime la renderización de las ventanas de información cuando se hace clic en los componentes de la capa.
url optional
Tipo:  string optional
Es la URL del documento KML que se mostrará.
zIndex optional
Tipo:  number optional
Es el índice z de la capa.

KmlLayerMetadata

Interfaz de google.maps.KmlLayerMetadata

Metadatos de una sola capa KML, en formato JSON

author
Tipo:  KmlAuthor
El <atom:author> de la capa, extraído del marcado de la capa
description
Tipo:  string
El <description> de la capa, extraído del marcado de la capa
hasScreenOverlays
Tipo:  boolean
Indica si la capa tiene superposiciones de pantalla.
name
Tipo:  string
El <name> de la capa, extraído del marcado de la capa
snippet
Tipo:  string
El <Snippet> de la capa, extraído del marcado de la capa

Constantes de KmlLayerStatus

Constantes de google.maps.KmlLayerStatus

Es el estado que muestra KmlLayer cuando se completa la carga de un documento. Especifica estos valores por valor o con el nombre de la constante. Por ejemplo, 'OK' o google.maps.KmlLayerStatus.OK.

Para acceder, llama a const {KmlLayerStatus} = await google.maps.importLibrary("maps"). Consulta Bibliotecas de la API de Maps JavaScript.

DOCUMENT_NOT_FOUND No se pudo encontrar el documento. Lo más probable es que sea una URL no válida o que el documento no esté disponible públicamente.
DOCUMENT_TOO_LARGE El documento supera los límites de tamaño de archivo de KmlLayer.
FETCH_ERROR No se pudo recuperar el documento.
INVALID_DOCUMENT El documento no es un archivo KML, KMZ o GeoRSS válido.
INVALID_REQUEST El KmlLayer no es válido.
LIMITS_EXCEEDED El documento supera los límites de componentes de KmlLayer.
OK La capa se cargó correctamente.
TIMED_OUT No se pudo cargar el documento en un tiempo razonable.
UNKNOWN No se pudo cargar el documento por un motivo desconocido.

KmlMouseEvent

Interfaz de google.maps.KmlMouseEvent

Las propiedades de un evento de clic en un documento KML/KMZ o GeoRSS

featureData
Un objeto KmlFeatureData que contiene información sobre el componente en el que se hizo clic.
latLng
Tipo:  LatLng
Es la posición en la que se debe fijar una ventana de información en el componente en el que se hizo clic.
pixelOffset
Tipo:  Size
Es el desplazamiento que se aplicará a una ventana de información anclada en el componente en el que se hizo clic.

Interfaz KmlFeatureData

Interfaz de google.maps.KmlFeatureData

Datos de un solo componente KML en formato JSON que se muestran cuando se hace clic en un componente KML. Los datos que contiene este objeto reflejan los asociados con el componente en el marcado KML o GeoRSS en el que se declara.

author
Tipo:  KmlAuthor
El <atom:author> del componente, extraído del marcado de la capa (si se especifica)
description
Tipo:  string
El <description> de la función, extraído del marcado de la capa
id
Tipo:  string
El <id> de la función, extraído del marcado de la capa Si no se especificó ningún <id>, se generará un ID único para esta función.
infoWindowHtml
Tipo:  string
El texto con diseño de globo de la función, si está configurado
name
Tipo:  string
El <name> de la función, extraído del marcado de la capa
snippet
Tipo:  string
El <Snippet> de la función, extraído del marcado de la capa

Interfaz KmlAuthor

Interfaz de google.maps.KmlAuthor

Contiene detalles del autor de un documento o componente KML.

email
Tipo:  string
La dirección de correo electrónico del autor o una cadena vacía si no se especifica.
name
Tipo:  string
El nombre del autor o una cadena vacía si no se especifica.
uri
Tipo:  string
La página principal del autor o una cadena vacía si no se especifica.