Un Feature en Earth Engine se define como un objeto GeoJSON. Específicamente, un Feature es un objeto con una propiedad geometry que almacena un objeto Geometry (o nulo) y una propiedad properties que almacena un diccionario de otras propiedades.
Crea objetos Feature
Para crear un Feature, proporciona al constructor un Geometry
y, de manera opcional, un diccionario de otras propiedades. Por ejemplo:
Editor de código (JavaScript)
// Create an ee.Geometry. var polygon = ee.Geometry.Polygon([ [[-35, -10], [35, -10], [35, 10], [-35, 10], [-35, -10]] ]); // Create a Feature from the Geometry. var polyFeature = ee.Feature(polygon, {foo: 42, bar: 'tart'});
import ee import geemap.core as geemap
Colab (Python)
# Create an ee.Geometry. polygon = ee.Geometry.Polygon( [[[-35, -10], [35, -10], [35, 10], [-35, 10], [-35, -10]]] ) # Create a Feature from the Geometry. poly_feature = ee.Feature(polygon, {'foo': 42, 'bar': 'tart'})
Al igual que con un Geometry, se puede imprimir un Feature o agregarlo al mapa para su inspección y visualización:
Editor de código (JavaScript)
print(polyFeature); Map.addLayer(polyFeature, {}, 'feature');
import ee import geemap.core as geemap
Colab (Python)
display(poly_feature) m = geemap.Map() m.add_layer(poly_feature, {}, 'feature') display(m)
No es necesario que un Feature tenga un Geometry y puede simplemente unir un
diccionario de propiedades. Por ejemplo:
Editor de código (JavaScript)
// Create a dictionary of properties, some of which may be computed values. var dict = {foo: ee.Number(8).add(88), bar: 'nihao'}; // Create a null geometry feature with the dictionary of properties. var nowhereFeature = ee.Feature(null, dict);
import ee import geemap.core as geemap
Colab (Python)
# Create a dictionary of properties, some of which may be computed values. dic = {'foo': ee.Number(8).add(88), 'bar': 'nihao'} # Create a null geometry feature with the dictionary of properties. nowhere_feature = ee.Feature(None, dic)
En este ejemplo, observa que el diccionario proporcionado a Feature contiene un
valor calculado. Crear objetos de este modo es útil para exportar cálculos de larga duración
con un resultado Dictionary (p.ej., image.reduceRegion()).
Consulta las guías de FeatureCollections,
Importación de datos de tablas o Exportación para
obtener más detalles.
Cada Feature tiene un Geometry principal almacenado en la
propiedad geometry. Es posible que se almacenen geometrías adicionales en otras propiedades.
Los métodos Geometry, como la intersección y el búfer, también existen en
Feature como una forma conveniente de obtener el Geometry principal,
aplicar la operación y establecer el resultado como el nuevo Geometry principal.
El resultado conservará todas las demás propiedades del Feature en el que
se llama al método. También hay métodos para obtener y establecer las propiedades no geométricas de Feature. Por ejemplo:
Editor de código (JavaScript)
// Make a feature and set some properties. var feature = ee.Feature(ee.Geometry.Point([-122.22599, 37.17605])) .set('genus', 'Sequoia').set('species', 'sempervirens'); // Get a property from the feature. var species = feature.get('species'); print(species); // Set a new property. feature = feature.set('presence', 1); // Overwrite the old properties with a new dictionary. var newDict = {genus: 'Brachyramphus', species: 'marmoratus'}; var feature = feature.set(newDict); // Check the result. print(feature);
import ee import geemap.core as geemap
Colab (Python)
# Make a feature and set some properties. feature = ( ee.Feature(ee.Geometry.Point([-122.22599, 37.17605])) .set('genus', 'Sequoia') .set('species', 'sempervirens') ) # Get a property from the feature. species = feature.get('species') display(species) # Set a new property. feature = feature.set('presence', 1) # Overwrite the old properties with a new dictionary. new_dic = {'genus': 'Brachyramphus', 'species': 'marmoratus'} feature = feature.set(new_dic) # Check the result. display(feature)
En el ejemplo anterior, observa que las propiedades se pueden establecer con un par clave-valor o con un diccionario. Ten en cuenta que feature.set()
reemplaza las propiedades existentes.