Descripción general de FeatureView

Un FeatureView es una representación acelerada de solo lectura de un FeatureCollection. A diferencia de un FeatureCollection, cuyas tarjetas de mapa de trama se generan sobre la marcha, las tarjetas de trama de FeatureView se calculan previamente para proporcionar una renderización rápida. Además de renderizarse más rápido, los recursos FeatureView implementan la reducción de elementos dependientes del nivel de zoom. El efecto es que los conjuntos de datos densos pueden parecer incompletos cuando se aleja el mapa (no se dibujan los componentes pequeños), pero se vuelven visibles más datos a medida que se acerca el mapa, lo que puede mejorar la estética del mapa en niveles de zoom más bajos. El comportamiento de reducción de un conjunto de datos se controla mediante varios parámetros de optimización que se establecen durante la exportación de un recurso FeatureCollection a un recurso FeatureView.

Como recurso de solo lectura, los objetos FeatureView no se pueden incluir en cálculos ni expresiones, pero se pueden visualizar y, además, inspeccionar en el editor de código de JavaScript y en las apps de Earth Engine como un FeatureViewLayer. También se pueden integrar en las aplicaciones de la API de Google Maps.

Crea una FeatureView

Para crear un FeatureView, debes preparar un FeatureCollection con tus datos, llamar a la función Export.table.toFeatureView y comenzar la tarea de exportación. En el siguiente ejemplo, se muestra cómo exportar vistas del conjunto de datos de polígonos de la WDPA. En tu propia aplicación, usa cualquier conjunto de datos de FeatureCollection archivado en el catálogo de datos de Earth Engine o crea el tuyo subiendo un conjunto de datos vectoriales como un recurso de Earth Engine.

Se puede personalizar un FeatureView con varios parámetros en la función Export.table.toFeatureView.

  • maxFeaturesPerTile: Define la cantidad máxima de componentes que se muestran en un mosaico de mapa con un nivel de zoom determinado. Usa este parámetro para optimizar la velocidad o la densidad de los elementos.
  • thinningStrategy: Controla si la reducción de elementos para una determinada tarjeta y un nivel de zoom se debe optimizar para obtener una mayor densidad o coherencia en la densidad en todas las tarjetas. Ten en cuenta que la optimización para una densidad más alta puede hacer que los límites de los mosaicos se vuelvan distintos, ya que la densidad de los componentes por mosaico es independiente.
  • thinningRanking: Define la prioridad de reducción de elementos. Por ejemplo, puedes optimizar la reducción para orientarla a la retención de una propiedad de un elemento en particular con valores altos; es decir, a medida que alejas el mapa, los elementos que tienen un valor bajo para la propiedad seleccionada se reducirán primero, lo que dejará visibles los elementos más importantes (según tus reglas).
  • zOrderRanking: Define el orden Z (orden de apilamiento) de los componentes que se muestran en el mapa. Este parámetro controla cómo se muestran los elementos superpuestos, ya que te permite establecer reglas de prioridad según las propiedades de los elementos, el tipo de geometría y el nivel de zoom. Por ejemplo, puedes priorizar los elementos con valores altos de una propiedad en particular para que se superpongan sobre los elementos que se cruzan con valores bajos.

Consulta la página de optimización de FeatureView para obtener más detalles sobre estos parámetros y sus argumentos aceptados.

En el siguiente ejemplo, los argumentos especificados para estos parámetros producen un FeatureView en el que la cantidad máxima de elementos por mosaico en un nivel de zoom determinado es de 1,500, la densidad de elementos por mosaico es independiente y puede alcanzar el máximo de 1,500, los polígonos más pequeños se reducen primero y los polígonos más pequeños se colocan sobre los más grandes.

Editor de código (JavaScript)

// Import the WDPA feature collection.
var wdpa = ee.FeatureCollection('WCMC/WDPA/current/polygons');

// Export the WDPA FeatureCollection as a FeatureView asset.
Export.table.toFeatureView({
  collection: wdpa,
  assetId: 'wdpa-featureview-demo',
  description: 'wdpa-featureview-demo',
  maxFeaturesPerTile: 1500,
  thinningStrategy: 'HIGHER_DENSITY',
  thinningRanking: ['REP_AREA DESC'],
  zOrderRanking: ['REP_AREA DESC'],
});

Si ejecutas el fragmento de código anterior en el editor de código, se generará una tarea de exportación. Ejecuta la tarea para iniciar la exportación.

Ubicaciones de recursos de FeatureView

Los recursos de FeatureView se pueden encontrar en el Data Catalog público y entre tus recursos personales en la pestaña Recursos del Code Editor. Todos los recursos FeatureCollection relevantes en Data Catalog tienen un recurso FeatureView complementario con parámetros de configuración de transferencia aplicables de forma general. Tu archivo de recursos personales incluirá todos los recursos de FeatureView que crees.

Importa recursos de FeatureView a las secuencias de comandos

Los activos de FeatureView se pueden importar a los scripts del Code Editor con los botones de los diálogos de activos del Code Editor y las entradas de activos personales, y proporcionando un ID del activo de FeatureView como entrada para el constructor ui.Map.FeatureViewLayer.

Diálogo de recursos de Data Catalog

Los diálogos de recursos de tablas del Data Catalog, a los que se accede desde la barra de búsqueda del Code Editor, tienen un botón Importar en la parte inferior derecha con un menú desplegable. En el menú desplegable, selecciona "Importar FeatureView". El recurso se incluirá en la sección Imports, en la parte superior de la secuencia de comandos.

Diálogo de recursos personales

Los diálogos de recursos personales de FeatureView, a los que se accede seleccionando un recurso en la pestaña Recursos del editor de código, tienen un botón Importar en la esquina superior derecha. Si activas el botón, el recurso se incluirá en la sección Imports en la parte superior de la secuencia de comandos. También puedes usar el botón de acceso directo de importación (ícono de flecha que apunta hacia la derecha) que aparece cuando colocas el cursor sobre un recurso en la pestaña Recursos.

ID del recurso

Los recursos de FeatureView tienen un ID que se puede proporcionar como entrada al constructor ui.Map.FeatureViewLayer, lo que te brinda acceso al recurso en tu secuencia de comandos. Los fragmentos de importación preconstruidos se pueden encontrar en las páginas de recursos de Data Catalog y en los diálogos de recursos del editor de código.

Figura 1: Diálogo de recursos de Data Catalog en el que se destacan los métodos de importación de FeatureView.

Metadatos de FeatureView

La información y los metadatos de FeatureView están disponibles en los diálogos de recursos mencionados en la sección Ubicaciones de recursos de FeatureView anterior. Además de la descripción y las propiedades que se pueden compartir con el recurso FeatureCollection, hay cinco propiedades exclusivas de FeatureView. Incluyen la configuración de los parámetros de transferencia descritos en la sección Crea una FeatureView y sourceVersion, que es la marca de tiempo de la "última modificación" del recurso de tabla a partir del cual se creó la FeatureView. En la figura 1 anterior, se muestran las propiedades específicas de FeatureView en un diálogo de recursos de Data Catalog. Al igual que con otros recursos, también puedes recuperar propiedades de manera programática desde el diccionario que muestra ee.data.getAsset.

Visualiza un FeatureView

Un objeto FeatureView se puede visualizar en el editor de código, las apps de Earth Engine y Google Maps.

Editor de código

El editor de código incluye el componente ui.Map.FeatureViewLayer para visualizar los recursos de FeatureView en un mapa. En el siguiente ejemplo, se define un ID de activo de FeatureView, se importa el activo como un FeatureViewLayer y se muestra en el mapa.

Editor de código (JavaScript)

// Define the FeatureView asset ID.
var assetId = 'WCMC/WDPA/current/polygons_FeatureView';

// Import the FeatureView asset as a FeatureViewLayer.
var layer = ui.Map.FeatureViewLayer(assetId);

// Add the FeatureViewLayer to the map.
Map.add(layer);

Estilo

Puedes definir el diseño de FeatureViewLayer pasando un diccionario de diseño a la función ui.Map.FeatureViewLayer o agregándolos a una capa con el método setVisParams. A continuación, se muestra un ejemplo que aplica diseño a los siguientes elementos:

  • colores de contorno según la propiedad "MARINE" (si el área protegida se encuentra total o parcialmente dentro del entorno marino)
  • color de relleno según la propiedad "IUCN_CAT" (categoría de la Unión Internacional para la Conservación de la Naturaleza [UICN])
  • opacidad de relleno según el tamaño del área protegida que define la propiedad "REP_AREA".

Visita la página de diseño de FeatureView para obtener más detalles sobre las opciones de diseño disponibles.

Editor de código (JavaScript)

// Set visualization properties for the defined layer.
layer.setVisParams({
  color: {
    property: 'MARINE',
    categories: [
      ['0', 'purple'],
      ['1', 'green'],
      ['2', 'blue'],
    ]
  },
  fillColor: {
    property: 'IUCN_CAT',
    defaultValue: 'd3d3d3',
    categories: [
      ['Ia', 'a6cee3'],
      ['Ib', '1f78b4'],
      ['II', 'b2df8a'],
      ['III', '33a02c'],
      ['IV', 'fb9a99'],
      ['V', 'e31a1c'],
      ['VI', 'fdbf6f'],
    ]
  },
  fillOpacity: {
    property: 'REP_AREA',
    mode: 'interval',
    palette: [
      [0, 0.5],
      [80, 0.35],
      [2000, 0.22],
      [5000, 0.15],
    ],
  },
  width: 1.0,
  pointSize: 6.0,
});

Filtro

Las reglas de filtro se pueden aplicar para ocultar o aplicar diseño de forma selectiva a los elementos según sus propiedades. Por ejemplo, para filtrar las áreas protegidas más pequeñas que un área determinada por un widget de control deslizante, puedes usar el siguiente código. Consulta la sección Reglas específicas de la página de diseño de FeatureView para obtener más información sobre el campo rules.

Editor de código (JavaScript)

// Define the FeatureView asset ID.
var assetId = 'WCMC/WDPA/current/polygons_FeatureView';

// Import the FeatureView asset as a FeatureViewLayer.
var layer = ui.Map.FeatureViewLayer(assetId, null, 'WDPA FeatureViewLayer');

// Callback function to update FeatureViewLayer style.
var updateVisParams = function() {
  layer.setVisParams({
    color: {
      property: 'MARINE',
      categories: [
        ['0', 'purple'],
        ['1', 'green'],
        ['2', 'blue'],
      ]
    },
    fillColor: {
      property: 'IUCN_CAT',
      defaultValue: 'd3d3d3',
      categories: [
        ['Ia', 'a6cee3'],
        ['Ib', '1f78b4'],
        ['II', 'b2df8a'],
        ['III', '33a02c'],
        ['IV', 'fb9a99'],
        ['V', 'e31a1c'],
        ['VI', 'fdbf6f'],
      ]
    },
    fillOpacity: {
      property: 'REP_AREA',
      mode: 'interval',
      palette: [
        [0, 0.5],
        [80, 0.35],
        [2000, 0.22],
        [5000, 0.15],
      ],
    },
    width: 1.0,
    pointSize: 6.0,
    rules: [
      {
        filter: ee.Filter.lt('REP_AREA', filterSlider.getValue()),
        isVisible: false,
      },
    ],
  });
};

// Slider widget that calls the updateVisParams function on change.
var filterSlider = ui.Slider({
  min: 0,
  max: 10000,
  step: 10,
  value: 0,
  style: { stretch: 'horizontal'},
  onChange: updateVisParams,
});
var filterSliderLabel = ui.Label(
  'Adjust slider to hide features less than the specified area (km²)');

// Add the slider to the map.
Map.add(ui.Panel([filterSliderLabel, filterSlider]));

// Initialize the FeatureViewLayer style.
updateVisParams();

// Add the FeatureViewLayer to the map.
Map.add(layer);

Figura 2: Visualización de FeatureViewLayer con un widget de control deslizante para ocultar los objetos geográficos más pequeños que el área especificada.

API de Google Maps

El proceso para visualizar un recurso de FeatureView con la API de Google Maps consta de cuatro partes: obtener una clave de mosaicos con ee.data.getFeatureViewTilesKey, pasarla a una instancia de FeatureViewTileSource, construir un ee.layer.ImageOverlay y, luego, agregar la superposición a tu instancia de google.maps.Map. A continuación, se muestra un código de muestra para construir el ImageOverlay en JavaScript.

var tilesKey = ee.data.getFeatureViewTilesKey({
  assetId: 'WCMC/WDPA/current/polygons_FeatureView',
  visParams: { … },
});

var tileSource = new ee.layers.FeatureViewTileSource(tilesKey);
var overlay = new ee.layers.ImageOverlay(tileSource);

Una vez que lo hagas, podrás agregar la superposición a tu instancia de google.maps.Map, como se muestra a continuación.

// embeddedMap is your google.maps.Map instance.
embeddedMap.overlayMapTypes.setAt(0, overlay);

Inspecciona una FeatureView

Una capa FeatureViewLayer que se agrega al mapa predeterminado del Editor de código se puede inspeccionar con la herramienta Inspector. La funcionalidad es la misma que la de un FeatureCollection. Ten en cuenta que los resultados que se devuelven para la ubicación en la que se hizo clic solo incluyen los componentes que son visibles en el nivel de zoom actual. No se muestran las geometrías de los elementos inspeccionados, ya que se simplifican como parte del proceso de exportación de FeatureView.

Figura 3: Inspeccionar un FeatureViewLayer. El inspector muestra la capa, los atributos, el ID del activo y los parámetros de visualización.