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.
Constructor | |
|---|---|
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). |
Métodos | |
|---|---|
getDefaultViewport |
getDefaultViewport()Parámetros: Ninguno
Valor que se muestra:
LatLngBoundsObtén el viewport predeterminado para la capa que se muestra. |
getMap |
getMap()Parámetros: Ninguno
Valor que se muestra:
MapObtén el mapa en el que se renderiza la capa KML. |
getMetadata |
getMetadata()Parámetros: Ninguno
Valor que se muestra:
KmlLayerMetadataObté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:
KmlLayerStatusObté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
stringObtiene 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:
Valor que se muestra: Ninguno
Establece la URL del archivo KML que se mostrará. |
setZIndex |
setZIndex(zIndex)Parámetros:
Valor que se muestra: Ninguno
Establece el índice z de la capa KML. |
Heredado:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Eventos | |
|---|---|
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.
Propiedades | |
|---|---|
clickable optional |
Tipo:
boolean optionalPredeterminado:
trueSi es true, la capa recibe eventos del mouse. |
map optional |
Tipo:
Map optionalEs el mapa en el que se mostrará la capa. |
preserveViewport optional |
Tipo:
boolean optionalPredeterminado:
falseSi 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 optionalPredeterminado:
trueIndica si se deben renderizar las superposiciones de pantalla. |
suppressInfoWindows optional |
Tipo:
boolean optionalSuprime la renderización de las ventanas de información cuando se hace clic en los componentes de la capa. |
url optional |
Tipo:
string optionalEs la URL del documento KML que se mostrará. |
zIndex optional |
Tipo:
number optionalEs el índice z de la capa. |
KmlLayerMetadata
Interfaz de google.maps.KmlLayerMetadata
Metadatos de una sola capa KML, en formato JSON
Propiedades | |
|---|---|
description |
Tipo:
stringEl <description> de la capa, extraído del marcado de la capa |
hasScreenOverlays |
Tipo:
booleanIndica si la capa tiene superposiciones de pantalla. |
name |
Tipo:
stringEl <name> de la capa, extraído del marcado de la capa |
snippet |
Tipo:
stringEl <Snippet> de la capa, extraído del marcado de la capa |
author optional |
Tipo:
KmlAuthor optionalEl <atom:author> 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.
Constantes | |
|---|---|
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
Propiedades | |
|---|---|
featureData |
Tipo:
KmlFeatureDataUn objeto KmlFeatureData que contiene información sobre el componente en el que se hizo clic. |
latLng |
Tipo:
LatLngEs 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:
SizeEs 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.
Propiedades | |
|---|---|
author |
Tipo:
KmlAuthorEl <atom:author> del componente, extraído del marcado de la capa (si se especifica) |
description |
Tipo:
stringEl <description> de la función, extraído del marcado de la capa |
id |
Tipo:
stringEl <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:
stringEl texto con diseño de globo de la función, si está configurado |
name |
Tipo:
stringEl <name> de la función, extraído del marcado de la capa |
snippet |
Tipo:
stringEl <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.
Propiedades | |
|---|---|
email |
Tipo:
stringLa dirección de correo electrónico del autor o una cadena vacía si no se especifica. |
name |
Tipo:
stringEl nombre del autor o una cadena vacía si no se especifica. |
uri |
Tipo:
stringLa página principal del autor o una cadena vacía si no se especifica. |