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:
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:
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 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
Propiedades | |
---|---|
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 |
author optional |
Tipo:
KmlAuthor optional El <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:
KmlFeatureData 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.
Propiedades | |
---|---|
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.
Propiedades | |
---|---|
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. |