Data

Clase Data

Clase google.maps.Data

Es una capa para mostrar datos geoespaciales. Se pueden mostrar puntos, polilíneas y polígonos.

Cada Map tiene un objeto Data de forma predeterminada, por lo que, la mayoría de las veces, no es necesario construir uno. Por ejemplo: 

 var myMap = new google.maps.Map(...);
 myMap.data.addGeoJson(...);
 myMap.data.setStyle(...);
El objeto Data es una colección de Features.

Esta clase extiende MVCObject.

Llama al const {Data} = await google.maps.importLibrary("maps") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Data
Data([options])
Parámetros: 
Crea una colección vacía con el DataOptions especificado.
add
add([feature])
Parámetros: 
Valor de devolución:  Data.Feature
Agrega un componente a la colección y devuelve el componente agregado.

Si la entidad tiene un ID, reemplazará cualquier entidad existente en la colección con el mismo ID. Si no se proporciona ningún elemento, se creará uno nuevo con geometría nula y sin propiedades. Si se proporcionan FeatureOptions, se creará un atributo nuevo con las propiedades especificadas.

Ten en cuenta que los IDs 1234 y '1234' son equivalentes. Agregar una función con el ID 1234 reemplazará una función con el ID '1234', y viceversa.
addGeoJson
addGeoJson(geoJson[, options])
Parámetros: 
Valor de devolución:  Array<Data.Feature>
Agrega funciones de GeoJSON a la colección. Proporciona a este método un JSON analizado. Se devuelven los atributos importados. Arroja una excepción si no se pudo importar el GeoJSON.
contains
contains(feature)
Parámetros: 
Valor de devolución:  boolean
Comprueba si la función determinada está en la colección.
forEach
forEach(callback)
Parámetros: 
Valor de retorno: Ninguno
Invoca repetidamente la función determinada y pasa un elemento de la colección a la función en cada invocación. El orden de iteración a través de las funciones no está definido.
getControlPosition
getControlPosition()
Parámetros: Ninguno
Valor de devolución:  ControlPosition
Devuelve la posición de los controles de dibujo en el mapa.
getControls
getControls()
Parámetros: Ninguno
Valor de devolución:  Array<string>
Devuelve los modos de dibujo disponibles para que el usuario los seleccione, en el orden en que se muestran. Esto no incluye el modo de dibujo null, que se agrega de forma predeterminada. Los modos de dibujo posibles son "Point", "LineString" o "Polygon".
getDrawingMode
getDrawingMode()
Parámetros: Ninguno
Valor de devolución:  string|null
Devuelve el modo de dibujo actual de la capa de datos determinada. Un modo de dibujo de null significa que el usuario puede interactuar con el mapa de forma normal y que los clics no dibujan nada. Los modos de dibujo posibles son null, "Point", "LineString" o "Polygon".
getFeatureById
getFeatureById(id)
Parámetros: 
  • id:  number|string
Valor de devolución:  Data.Feature|undefined
Devuelve el atributo con el ID determinado, si existe en la colección. De lo contrario, devuelve undefined.

Ten en cuenta que los IDs 1234 y '1234' son equivalentes. Cualquiera de los dos se puede usar para buscar la misma función.
getMap
getMap()
Parámetros: Ninguno
Valor de devolución:  Map
Devuelve el mapa en el que se muestran los componentes.
getStyle
getStyle()
Parámetros: Ninguno
Valor de devolución:  Data.StylingFunction|Data.StyleOptions
Obtiene el diseño de todos los elementos de la colección.
loadGeoJson
loadGeoJson(url[, options, callback])
Parámetros: 
Valor de retorno: Ninguno
Carga GeoJSON desde una URL y agrega las entidades a la colección.

NOTA: El GeoJSON se recupera con XHR y es posible que no funcione en varios dominios. Si tienes problemas, te recomendamos que recuperes el GeoJSON con la biblioteca de AJAX que prefieras y, luego, llames a addGeoJson().
overrideStyle
overrideStyle(feature, style)
Parámetros: 
Valor de retorno: Ninguno
Cambia el diseño de un elemento. Estos cambios se aplican sobre el diseño especificado por setStyle(). Las propiedades de diseño establecidas en null vuelven al valor especificado a través de setStyle().
remove
remove(feature)
Parámetros: 
Valor de retorno: Ninguno
Quita un atributo de la colección.
revertStyle
revertStyle([feature])
Parámetros: 
Valor de retorno: Ninguno
Quita el efecto de las llamadas anteriores a overrideStyle(). El diseño del elemento determinado vuelve al diseño especificado por setStyle().

Si no se proporciona ningún componente, se revierte el diseño de todos los componentes.
setControlPosition
setControlPosition(controlPosition)
Parámetros: 
Valor de retorno: Ninguno
Establece la posición de los controles de dibujo en el mapa.
setControls
setControls(controls)
Parámetros: 
  • controls:  Array<string>
Valor de retorno: Ninguno
Establece qué modos de dibujo están disponibles para que el usuario los seleccione, en el orden en que se muestran. No debe incluir el modo de dibujo null, que se agrega de forma predeterminada. Si es null, los controles de dibujo están inhabilitados y no se muestran. Los modos de dibujo posibles son "Point", "LineString" o "Polygon".
setDrawingMode
setDrawingMode(drawingMode)
Parámetros: 
  • drawingMode:  string optional
Valor de retorno: Ninguno
Establece el modo de dibujo actual de la capa de datos determinada. Un modo de dibujo de null significa que el usuario puede interactuar con el mapa de forma normal y que los clics no dibujan nada. Los modos de dibujo posibles son null, "Point", "LineString" o "Polygon".
setMap
setMap(map)
Parámetros: 
Valor de retorno: Ninguno
Renderiza los atributos en el mapa especificado. Si el mapa está configurado como null, se quitarán los elementos del mapa.
setStyle
setStyle(style)
Parámetros: 
Valor de retorno: Ninguno
Establece el diseño para todos los elementos de la colección. Se seguirán aplicando los diseños especificados por elemento a través de overrideStyle().

Pasa un objeto con las opciones de diseño deseadas o una función que calcule el diseño de cada elemento. Se llamará a la función cada vez que se actualicen las propiedades de un elemento.
toGeoJson
toGeoJson(callback)
Parámetros: 
  • callback:  function(Object): void
Valor de retorno: Ninguno
Exporta las entidades de la colección a un objeto GeoJSON.
Heredado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
addfeature
function(event)
Argumentos: 
Este evento se activa cuando se agrega una función a la colección.
click
function(event)
Argumentos: 
Este evento se activa cuando se hace clic en la geometría.
contextmenu
function(event)
Argumentos: 
Este evento se activa cuando se activa el evento contextmenu del DOM en la geometría.
dblclick
function(event)
Argumentos: 
Este evento se activa cuando se hace doble clic en la geometría.
mousedown
function(event)
Argumentos: 
Este evento se activa cuando se presiona el botón del mouse sobre la geometría.
mouseout
function(event)
Argumentos: 
Este evento se activa cuando el mouse sale del área de la geometría.
mouseover
function(event)
Argumentos: 
Este evento se activa cuando el mouse ingresa al área de la geometría.
mouseup
function(event)
Argumentos: 
Este evento se activa cuando se suelta el botón del mouse sobre la geometría.
removefeature
function(event)
Argumentos: 
Este evento se activa cuando se quita una función de la colección.
removeproperty
function(event)
Argumentos: 
Este evento se activa cuando se quita la propiedad de una entidad.
setgeometry
function(event)
Argumentos: 
Este evento se activa cuando se establece la geometría de una entidad.
setproperty
function(event)
Argumentos: 
Este evento se activa cuando se establece la propiedad de una entidad.
rightclick
function(event)
Argumentos: 
Este evento se activa cuando se hace clic con el botón derecho en la geometría.

Interfaz Data.DataOptions

Interfaz de google.maps.Data.DataOptions

Objeto DataOptions que se usa para definir las propiedades que un desarrollador puede establecer en un objeto Data.
map
Tipo:  Map
Mapa en el que se mostrarán los atributos de la colección.
controlPosition optional
Tipo:  ControlPosition optional
Predeterminado: ControlPosition.TOP_LEFT
Posición de los controles de dibujo en el mapa.
controls optional
Tipo:  Array<string> optional
Predeterminado: null
Describe qué modos de dibujo están disponibles para que el usuario los seleccione, en el orden en que se muestran. No debe incluir el modo de dibujo null, que se agrega de forma predeterminada. Si es null, los controles de dibujo están inhabilitados y no se muestran. Los modos de dibujo posibles son "Point", "LineString" o "Polygon".
drawingMode optional
Tipo:  string optional
Predeterminado: null
Es el modo de dibujo actual de la capa de datos determinada. Un modo de dibujo de null significa que el usuario puede interactuar con el mapa de forma normal y que los clics no dibujan nada. Los modos de dibujo posibles son null, "Point", "LineString" o "Polygon".
featureFactory optional
Tipo:  function(Data.Geometry): Data.Feature optional
Cuando se habilita el dibujo y un usuario dibuja una geometría (un punto, una cadena lineal o un polígono), se llama a esta función con esa geometría y debe devolver un objeto Feature que se agregará a la capa de datos. Si no se proporciona un featureFactory, se creará un objeto Feature sin ID ni propiedades a partir de esa geometría. La configuración predeterminada es null.
style optional
Es el diseño de todos los elementos de la colección. Para obtener más detalles, consulta el método setStyle() anterior.

Interfaz Data.GeoJsonOptions

Interfaz de google.maps.Data.GeoJsonOptions

Son parámetros opcionales para importar GeoJSON.
idPropertyName optional
Tipo:  string optional
Nombre de la propiedad de Feature que se usará como ID de la función. Si no se especifica, se usará el ID de Feature de GeoJSON.

Interfaz Data.StyleOptions

Interfaz de google.maps.Data.StyleOptions

Estas opciones especifican la forma en que debe aparecer un objeto Feature cuando se muestra en un mapa.
animation optional
Tipo:  Animation optional
Animación que se reproduce cuando se agrega un marcador a un mapa. Solo se aplica a las geometrías de puntos.
clickable optional
Tipo:  boolean optional
Predeterminado: true
Si es true, el marcador recibe eventos táctiles y del mouse.
cursor optional
Tipo:  string optional
cursor del mouse que se mostrará al posar el puntero. Solo se aplica a las geometrías de puntos.
draggable optional
Tipo:  boolean optional
Predeterminado: false
Si es true, el objeto se puede arrastrar por el mapa y se actualizará la geometría del elemento subyacente.
editable optional
Tipo:  boolean optional
Predeterminado: false
Si es true, el objeto se puede editar arrastrando los puntos de control, y se actualizará la geometría de la entidad subyacente. Solo se aplica a las geometrías LineString y Polygon.
fillColor optional
Tipo:  string optional
color de relleno. Se admiten todos los colores CSS3, salvo aquellos con nombres extendidos. Solo se aplica a las geometrías de polígonos.
fillOpacity optional
Tipo:  number optional
Opacidad de relleno entre 0.0 y 1.0. Solo se aplica a las geometrías de polígonos.
icon optional
Tipo:  string|Icon|Symbol optional
Ícono para el primer plano. Si se proporciona una cadena, se trata como si fuera un Icon con la cadena como url. Solo se aplica a las geometrías de puntos.
icons optional
Tipo:  Array<IconSequence> optional
Son los íconos que se renderizarán a lo largo de una polilínea. Solo se aplica a las geometrías de líneas.
label optional
Tipo:  string|MarkerLabel optional
Agrega una etiqueta al marcador. La etiqueta puede ser una cadena o un objeto MarkerLabel. Solo se aplica a las geometrías de puntos.
opacity optional
Tipo:  number optional
Opacidad del marcador entre 0.0 y 1.0. Solo se aplica a las geometrías de puntos.
shape optional
Tipo:  MarkerShape optional
define el mapa de imagen usado para la detección de aciertos. Solo se aplica a las geometrías de puntos.
strokeColor optional
Tipo:  string optional
color del trazo. Se admiten todos los colores CSS3, salvo aquellos con nombres extendidos. Solo se aplica a las geometrías de línea y polígono.
strokeOpacity optional
Tipo:  number optional
opacidad de trazo entre 0,0 y 1,0. Solo se aplica a las geometrías de línea y polígono.
strokeWeight optional
Tipo:  number optional
ancho de trazo en píxeles. Solo se aplica a las geometrías de línea y polígono.
title optional
Tipo:  string optional
texto de sustitución. Solo se aplica a las geometrías de puntos.
visible optional
Tipo:  boolean optional
Predeterminado: true
Indica si la función es visible.
zIndex optional
Tipo:  number optional
Todos los elementos se muestran en el mapa en el orden de su zIndex, y los valores más altos se muestran delante de los elementos con valores más bajos. Siempre se muestran marcadores frente a cadenas de líneas y polígonos.

Data.StylingFunction typedef

google.maps.Data.StylingFunction typedef

Es una función que calcula la apariencia de un elemento.

El método Data.setStyle() puede aceptar una función de diseño. Úsalo cuando las entidades deban aparecer de forma diferente según sus propiedades. Puedes encontrar más información sobre el diseño de elementos en la guía para desarrolladores.

function(Data.Feature): Data.StyleOptions

Clase Data.Feature

Clase google.maps.Data.Feature

Un componente tiene una geometría, un ID y un conjunto de propiedades.

Llama al const {Data} = await google.maps.importLibrary("maps") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Data.Feature
Data.Feature([options])
Parámetros: 
Construye un objeto Feature con las opciones proporcionadas.
forEachProperty
forEachProperty(callback)
Parámetros: 
  • callback:  function(*, string): void
Valor de retorno: Ninguno
Invoca repetidamente la función determinada y pasa un valor y un nombre de propiedad en cada invocación. El orden de iteración a través de las propiedades no está definido.
getGeometry
getGeometry()
Parámetros: Ninguno
Valor de devolución:  Data.Geometry
Devuelve la geometría del elemento.
getId
getId()
Parámetros: Ninguno
Valor de devolución:  number|string|undefined
Devuelve el ID de la función.
getProperty
getProperty(name)
Parámetros: 
  • name:  string
Valor de devolución:  *
Devuelve el valor de la propiedad solicitada o undefined si la propiedad no existe.
removeProperty
removeProperty(name)
Parámetros: 
  • name:  string
Valor de retorno: Ninguno
Quita la propiedad con el nombre determinado.
setGeometry
setGeometry(newGeometry)
Parámetros: 
Valor de retorno: Ninguno
Establece la geometría del elemento.
setProperty
setProperty(name, newValue)
Parámetros: 
  • name:  string
  • newValue:  *
Valor de retorno: Ninguno
Establece el valor de la propiedad especificada. Si newValue es undefined, esto equivale a llamar a removeProperty.
toGeoJson
toGeoJson(callback)
Parámetros: 
  • callback:  function(Object): void
Valor de retorno: Ninguno
Exporta el elemento a un objeto GeoJSON.
removeproperty
function(event)
Argumentos: 
Este evento se activa cuando se quita la propiedad de una función.
setgeometry
function(event)
Argumentos: 
Este evento se activa cuando se establece la geometría de una entidad.
setproperty
function(event)
Argumentos: 
Este evento se activa cuando se establece la propiedad de una función.

Interfaz Data.FeatureOptions

Interfaz de google.maps.Data.FeatureOptions

Son parámetros opcionales para crear objetos Data.Feature.
geometry optional
Es la geometría del atributo. Si no se especifica ninguna cuando se construye un elemento, la geometría del elemento será null. Si se proporciona un objeto LatLng o LatLngLiteral, se convertirá en una geometría Data.Point.
id optional
Tipo:  number|string optional
El ID de la función es opcional. Si se proporciona, se puede usar para buscar el elemento en un objeto Data con el método getFeatureById(). Ten en cuenta que el ID de un elemento no se puede cambiar posteriormente.
properties optional
Tipo:  Object optional
Son las propiedades de la función. Es una asignación arbitraria de nombres de propiedades a valores.

Interfaz Data.Geometry

Interfaz de google.maps.Data.Geometry

Es una superclase para los distintos objetos de geometría.
forEachLatLng
forEachLatLng(callback)
Parámetros: 
  • callback:  function(LatLng): void
Valor de retorno: Ninguno
Invoca repetidamente la función determinada y pasa un punto de la geometría a la función en cada invocación.