Establecer una conexión con una API STAC permite buscar activos de datos y utilizarlos directamente en ArcGIS Pro. Uno de los elementos clave a la hora de configurar la conexión a una API STAC es la inclusión de archivos de conexión ArcGIS Cloud Storage (.acs). Cuando los datasets descubiertos a través de una API STAC están protegidos en su ubicación de almacenamiento, estos archivos .acs son necesarios para la autentificación cuando se accede a los datasets en ArcGIS Pro. Algunas API STAC (o colecciones a las que se hace referencia en ellas) presentan datasets que se guardan en almacenamientos de acceso público. Estos no requieren archivos ACS para utilizar los datos en ArcGIS Pro.
Las conexiones a los almacenes en la nube se guardan en el sistema de archivos como archivos con la extensión .acs. Puede crear una conexión de almacenamiento en la nube utilizando el cuadro de diálogo Nueva conexión de almacenamiento en la nube o la herramienta de geoprocesamiento Crear archivo de conexión de almacenamiento en la nube.
Consulte la ayuda de la herramienta Crear archivo de conexión de almacenamiento en la nube para obtener más información sobre cómo crear un archivo .acs. Consulte Conectarse a un almacén en la nube para obtener más información sobre cómo conectarse a los almacenes en la nube.
Nota:
No puede utilizar datos de buckets privados o protegidos si el archivo .acs no especifica las credenciales de autenticación necesarias. En este caso, solo podrá examinar los datos en las pestañas Parámetros y Resultados del panel Explorar STAC.
En muchos casos, el punto final de la API STAC para realizar la búsqueda está abierto al público y no requiere autenticación. Permite buscar y descubrir libremente qué activos están disponibles. Sin embargo, el acceso para leer o descargar los datos de los activos podría estar protegido y requiere autenticación. La creación de archivos .acs requiere determinados parámetros en función del tipo de almacén de datos en el que residan los datasets de la colección. Por ejemplo, el STAC Microsoft Planetary Computer (MPC) requiere tokens de firma de acceso compartido a (SAS) almacenamiento Azure.
Crear un archivo .acs para acceder a la colección 2 de Landsat nivel 2 en el STAC MPC
Siga estos pasos para crear un archivo de conexión de almacenamiento en la nube utilizando la herramienta Crear archivo de conexión de almacenamiento en la nube para acceder a la colección Landsat en el STAC MPC. Para trabajar con colecciones en el STAC MPC, compruebe que dispone de un archivo ACS que contenga los siguientes parámetros:
- Storage Account Name: nombre de la cuenta para acceder al almacenamiento en cuestión.
- Container Name: nombre del depósito o contenedor.
- ARC_TOKEN_SERVICE_API: URL del proveedor de tokens.
- ARC_TOKEN_OPTION_NAME: tipo de token del proveedor de servicios.
- Recupere el Nombre de cuenta y los nombres de Contenedor del sitio MPC.
- Haga clic en el vínculo del Catálogo de datos Microsoft Planetary Computer. Busque y seleccione la colección de datasets a la que desea acceder.
En los siguientes pasos se utiliza la colección Landsat como ejemplo.
- Haga clic en el dataset Landsat Collection.
Se abrirá la página de productos de nivel 2 de la colección 2 de Landsat.
- Haga clic en el vínculo STAC Collection para ver el contenido en su navegador o en un visualizador JSON.
- Busque la información de los metadatos "msft:storage_account" y "msft:container". Para realizar una búsqueda, haga clic en la página y pulse Ctrl + F. Aparecerá un campo de búsqueda en la parte inferior de la página. Escriba (o corte y pegue) uno de los términos de búsqueda de metadatos.
Los valores de estos dos parámetros son Account Name y Container Name para la colección Landsat Collection 2 Level - 2. Para este ejemplo, el texto Storage Account Name es landsateuwest y Container es landsat-c2.
- Haga clic en el vínculo del Catálogo de datos Microsoft Planetary Computer. Busque y seleccione la colección de datasets a la que desea acceder.
- Aplique el nombre de la cuenta y el nombre del contenedor en ARC_TOKEN_SERVICE_API. En la plantilla de URL de solicitud https://planetarycomputer.microsoft.com/api/sas/v1/token/{storage_account}/{container}, reemplace storage_account por landsateuwest y el contenedor por landsat-c2.
Para la colección Landsat Collection 2 Level-2, la URL de solicitud será https://planetarycomputer.microsoft.com/api/sas/v1/token/landsateuwest/landsat-c2.
- Cree el archivo de conexión de almacenamiento en la nube necesario. Abra la herramienta Crear archivo de conexión de almacenamiento en la nube y defina los parámetros con los valores obtenidos en los pasos anteriores.
- Haga clic en Ejecutar.
Se crea el archivo de conexión de almacenamiento en la nube para el dataset Landsat.
El archivo de conexión de almacenamiento en la nube ahora puede utilizarse directamente en ArcGIS Pro para realizar análisis visuales y cuantitativos.