El bucket de GCS gs://alphaearth_foundations_custom contiene conjuntos de datos de muestra de
incorporaciones satelitales personalizadas que se componen de archivos COG (GeoTIFF optimizado para la nube)
generados por AlphaEarth Foundations.
Licencia
Esta colección de conjuntos de datos tiene licencia de CC-BY 4.0 y requiere el siguiente texto de atribución: "Custom Satellite Embeddings de AlphaEarth Foundations son producidos por Google y Google DeepMind". El uso de estos conjuntos de datos públicos está sujeto a la Política de Uso Aceptable de Google Cloud.
Conjuntos de datos disponibles
La siguiente es una lista de conjuntos de datos de este bucket. Contiene el nombre, la descripción y el área general que abarca el conjunto de datos. Ten en cuenta que los intervalos de tiempo aquí usan una hora de inicio inclusiva y una hora de finalización exclusiva.
name: corcoran_city_2026_agricultural_change
area: Corcoran and surrounding agricultural region, California, USA
description: Winter bare soil (Dec 15, 2025 - Feb 15, 2026) and spring peak greenness (Mar 15 - May 15, 2026) embeddings capturing agricultural crop dynamics over two seasonal windows.name: futaleufu_argentina_2026_fire_scar
area: Parque Nacional Los Alerces y región circundante, departamento de Futaleufú, provincia de Chubut, Argentina
description: Incorporaciones previas al incendio (del 1 al 31 de diciembre de 2025) y posteriores al incendio (del 1 al 31 de marzo de 2026) que capturan la extensión de la cicatriz de quemadura del incendio forestal y la perturbación del dosel forestal del incendio forestal de Los Alerces de 2026.name: king_county_2025_monthly
area: King County, Washington, USA
description: Calendar-month embeddings for the King County administrative area for the first six months of 2025, covering diverse urban city infrastructure and forested land.name: meloland_california_2026_crop_cycles
area: Meloland y los campos agrícolas circundantes, Imperial Valley, California, EE.UU.
description: Seis pasos de tiempo de incorporación mensuales secuenciales (del 15 al 15) (desde mediados de noviembre de 2025 hasta mediados de mayo de 2026) que hacen un seguimiento de los ciclos de rotación de varios cultivos.name: pacific_palisades_2025_fire
area: Pacific Palisades and surrounding coastal hills, Los Angeles, California, USA
description: Pre-fire (Dec 7, 2024 - Jan 7, 2025) and post-fire (Jan 7 - Feb 7, 2025) 31-day embeddings capturing Palisades Fire wildfire impact and land cover change.name: theewaterskloof_dam_2026_water_change
area: Theewaterskloof Dam, Theewaterskloof Local Municipality, South Africa
description: Dry-season (Jan 1-31, 2026) and wet-season recharge (Apr 15 - May 15, 2026) embeddings capturing reservoir water surface area changes.
Estructura del directorio
Todos los conjuntos de datos de muestra se organizan con el
prefijo gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/
└── {dataset_name}/
├── aef_index.parquet
├── manifest.txt
└── {start_date}_{end_date}/
└── {image_id}/
├── data.tiff
└── image_manifest.json
Cada conjunto de datos tiene su propio directorio que contiene un archivo de índice GeoParquet aef_index.parquet a nivel del conjunto de datos, un archivo manifest.txt a nivel del conjunto de datos y uno o más subdirectorios de intervalos de tiempo.
Estos subdirectorios de intervalos de tiempo se nombran con el patrón
{start_date}_{end_date}, en el que se incluye la fecha de inicio y se excluye la fecha de
finalización. Ambas fechas tienen el formato yyyyMMdd y están en la zona horaria UTC.
Por ejemplo, un subdirectorio para el mes de junio de 2025 se llamaría
20250601_20250701, que corresponde a un intervalo de tiempo desde
2025-06-01T00:00:00Z (inclusive) hasta 2025-07-01T00:00:00Z (excluido).
Cada directorio de intervalo de tiempo contiene un subdirectorio para cada incorporación de imagen
dentro de ese intervalo de tiempo, con un identificador de imagen ({image_id}) que
identifica de forma única la imagen dentro del conjunto de datos. Cada subdirectorio {image_id}
contiene un archivo COG data.tiff de los datos de píxeles y un archivo
image_manifest.json complementario que se usa para registrar los datos en Earth Engine.
Estructura de archivos
La estructura interna de cada archivo COG, incluidas sus dimensiones de 8192 x 8192 píxeles,
64 canales (de A00 a A63), pirámides de descripción general normalizadas,
cuantización de números enteros de 8 bits con signo y valor de máscara -128 NoData, es idéntica
a los COG de incorporaciones satelitales anuales. A diferencia de los COG anuales, los píxeles válidos en
cada mosaico de muestra suelen abarcar solo un subconjunto de la cuadrícula de 8192 x 8192
correspondiente a la región de interés, y todos los píxeles restantes se enmascaran como
-128 (NoData). Para obtener detalles completos sobre el diseño de los COG, consulta la
sección Estructura de archivos
de la guía de datos de GCS de AlphaEarth Foundations.
La ruta de acceso de cada archivo COG también contiene información. Por ejemplo, considera
el archivo en
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff.
Como se puede ver en la ruta de acceso, este archivo forma parte de los embeddings del incendio de Palisades de 2025
en el condado de Los Ángeles. Este archivo en particular contiene incorporaciones
que resumen un período que va desde el 7 de enero de 2025 (inclusive) hasta el 7 de febrero de
2025 (excluido). El nombre del subdirectorio x1evicvaet1mupt13-0000008192-0000000000
identifica de forma única el COG data.tiff en el
conjunto de datos pacific_palisades_2025_fire. Este identificador es un UUID opaco.
Como alternativa, estos metadatos de archivo y más se pueden extraer del archivo image_manifest.json del COG que se encuentra en gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json.
Este archivo es una representación JSON de un manifiesto de imagen de Earth Engine. La estructura JSON
de un manifiesto de imagen se define en la
guía de manifiesto de imagen. Para obtener una descripción completa del contenido de un archivo image_manifest.json determinado, consulta la sección Manifiesto de imagen.
Descuantización
Los valores de píxeles sin procesar de cada canal son números enteros de 8 bits con signo en el rango [-127, 127] (con -128 reservado como el valor "sin datos") y se deben descuantizar para producir valores de punto flotante listos para el análisis en el rango [-1, 1]. Para obtener información sobre la asignación de descuantización y las instrucciones para crear pirámides con reducción de muestreo, consulta las secciones Descuantización y Crea pirámides con reducción de muestreo de la guía de datos de GCS de AlphaEarth Foundations.
Manifiestos e índices
Para facilitar el descubrimiento, la iteración y el registro de las tarjetas de incorporaciones, cada
conjunto de datos proporciona dos tipos de manifiestos: una lista de archivos COG a nivel del conjunto de datos
(manifest.txt) y un manifiesto de metadatos por imagen (image_manifest.json), junto
con un índice espacial de GeoParquet a nivel del conjunto de datos (aef_index.parquet).
Manifiesto del conjunto de datos
Cada conjunto de datos incluye un archivo manifest.txt ubicado en la raíz de su directorio:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt
Este es un archivo de texto sin formato que contiene el URI completo de Google Cloud Storage para cada
archivo data.tiff del conjunto de datos, separado por saltos de línea.
Manifiesto de imagen
Junto a cada archivo data.tiff, hay un archivo image_manifest.json complementario:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/{start_date}_{end_date}/{image_id}/image_manifest.json
Este archivo JSON sigue la especificación del manifiesto de imágenes de Earth Engine y describe los archivos de origen, la estructura de bandas, los límites temporales y la cobertura espacial de la tarjeta.
Si bien los campos de manifiesto estándar (como tilesets y bands) siguen las convenciones estándar de Earth Engine, hay varios detalles clave que debes tener en cuenta:
name: Se deja vacío ("") en GCS. Cuando se usa este manifiesto para registrar una imagen en una colección de activos de Earth Engine, el cliente debe proporcionar el ID del activo de destino (p.ej.,projects/{project}/assets/{collection}/{image_id}). Consulta Carga un conjunto de datos en Earth Engine para obtener más detalles.start_timeyend_time: Especifica las marcas de tiempo de inicio (inclusive) y finalización (exclusiva) para el período compuesto en UTC con formato ISO 8601 (p.ej.,2026-03-15T00:00:00+00:00).footprint: Es un polígono cerrado en coordenadas de píxeles que describe una región que contiene píxeles válidos. Ten en cuenta que los píxeles faltantes aún pueden existir dentro del polígono, como es el caso de las geometrías de incorporación complejas, como la deking_county_2025_monthly.properties: Son metadatos de par clave-valor específicos de la incorporación, incluidos los siguientes:IMAGE_ID: Es el identificador único de la imagen dentro del conjunto de datos.DATASET: Es el nombre del conjunto de datos.DATASET_VERSION: Es la versión del conjunto de datos.START_DATEyEND_DATE: Son las fechas de inicio (inclusive) y finalización (exclusiva) del intervalo de tiempo que abarca la imagen, con el formatoYYYY-MM-DD.MODEL_VERSION: Es la cadena de versión que identifica de forma única la versión del modelo que se usó para producir la imagen.PROCESSING_SOFTWARE_VERSION: Es la cadena de versión que identifica de forma única el software de procesamiento de datos del modelo que se usó para producir la imagen.UTM_ZONE: Es la zona UTM del sistema de referencia de coordenadas que se usó para producir la imagen.
Índice de GeoParquet
Cada conjunto de datos incluye un archivo de índice espacial de GeoParquet ubicado en la raíz de
su directorio:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet
Este índice contiene una entrada para cada archivo data.tiff del conjunto de datos y
proporciona metadatos espaciales y temporales para ayudar a determinar qué archivos abarcan un
área y un período determinados:
geometry: Es la geometría del archivo como un polígono WGS84 (EPSG:4326). Para obtener detalles sobre cómo se calcula este polígono a partir del cuadro delimitador de UTM del array de píxeles y se recorta a los límites de la zona de UTM, consulta la sección Procesamiento de geometría de la guía de datos de GCS de AlphaEarth Foundations. Ten en cuenta que este polígono refleja los límites de todo el array de píxeles de 8192 x 8192 y no tiene en cuenta la validez de los píxeles individuales.crs: Es el CRS de la zona UTM a la que pertenece la imagen como un código EPSG, comoEPSG:32610.path: Es el URI de Google Cloud Storage (gs://...) del archivo COGdata.tiff.dataset: Es el nombre del conjunto de datos.start_dateyend_date: Son las fechas de inicio (inclusive) y finalización (exclusiva) del intervalo de tiempo que abarca la imagen, con el formatoYYYY-MM-DD.image_id: Es el identificador único de la imagen dentro del conjunto de datos.utm_zone: Es la zona UTM de la imagen, como10N.utm_west,utm_south,utm_east,utm_north: Son los límites de UTM del array de píxeles sin procesar. Esto no refleja ningún procesamiento de geometría e incluye todos los píxeles, independientemente de si son válidos o no.wgs84_west,wgs84_south,wgs84_east,wgs84_north: La longitud y latitud mínima y máxima del WGS84geometry.
Carga un conjunto de datos en Earth Engine
NOTA: Para mayor comodidad, todos los conjuntos de datos de muestra de Custom Satellite Embeddings se agregarán a Google Earth Engine como ImageCollections públicas con el método descrito en la guía de notebooks vinculada y ya se des-cuantificarán. Los usuarios que registren conjuntos de datos de Embedding de satélite personalizado recién entregados como ImageCollections de Google Earth Engine pueden usar la guía vinculada.
Los COG se pueden cargar en Earth Engine registrándolos como recursos respaldados por COG o cargándolos directamente. Consulta el cuaderno Acceso a datos de incorporaciones satelitales personalizadas en GitHub para obtener una guía completa de ambos métodos. Para obtener una descripción general y una comparación de ambos métodos, consulta GeoTIFF optimizados para la nube (COG) en Earth Engine.