通过连接到 STAC API,可以搜索数据资产并在 ArcGIS Pro 中直接使用。 设置与 STAC API 的连接时的关键要素之一是包含 ArcGIS Cloud Storage (.acs) 连接文件。 如果通过 STAC API 发现的数据集在其存储位置受到保护,则在访问 ArcGIS Pro 中的数据集时需要这些 .acs 文件进行身份验证。 一些 STAC API(或其中引用的集合)可提供相应数据集,这些数据集存储在可公开访问的存储中。 这些 API 不需要 ACS 文件,即可使用 ArcGIS Pro 中的数据。
与云存储的连接将作为扩展名为 .acs 的文件存储在文件系统中。 您可以使用新建云存储连接对话框或创建云存储连接文件地理处理工具创建云存储连接。
有关如何创建 .acs 文件的详细信息,请参阅创建云存储连接文件工具帮助文档。 有关如何连接到云存储的详细信息,请参阅连接到云存储。
注:
如果未在 .acs 文件中指定所需的身份验证凭据,则无法通过私有存储段或受保护存储段使用数据。 在这种情况下,您只能浏览探索 STAC 窗格的参数和结果选项卡中的数据。
在许多情况下,用于进行搜索的 STAC API 端点向公众开放,无需身份验证。 由此可以自由搜索和发现可用的资产。 但是,读取或下载资产数据的访问可能受保护,并且需要身份验证。 创建 .acs 文件需要特定参数,具体取决于集合数据集所在的数据存储的类型。 例如,Microsoft Planetary Computer (MPC) STAC 需要 Azure Storage 共享访问签名 (SAS) 令牌。
创建 .acs 文件以访问 MPC STAC 上的 Landsat Collection 2 Level-2 集合
完成以下步骤,使用创建云存储连接文件工具创建云存储连接文件,访问 MPC STAC 上的 Landsat 集合。 要使用 MPC STAC 中的集合,请确认您拥有包含以下参数的 ACS 文件:
- 存储账户名称 - 用于访问此存储的账户的名称
- 容器名称 - 存储段或容器的名称
- ARC_TOKEN_SERVICE_API - 令牌供应商的 URL
- ARC_TOKEN_OPTION_NAME - 来自服务提供商的令牌类型
- 从 MPC 站点检索账户名称和容器名称。
- 单击 Microsoft Planetary Computer 数据目录的链接。 搜索并选择要访问的数据集集合。
以下步骤以 Landsat 集合为例。
- 单击 Landsat Collection 数据集。
随即打开 Landsat Collection 2 Level-2 产品页面。
- 单击 STAC 集合链接并在浏览器或 JSON 查看器上查看内容。
- 搜索元数据 "msft:storage_account" 和 "msft:container" 信息。 单击页面并按 Ctrl + F 可进行搜索,页面底部会显示搜索字段。 键入(或者剪切并粘贴)元数据搜索词之一。
这两个参数的值是 Landsat Collection 2 Level - 2 集合的账户名称和容器名称值。 对于本示例,存储账户名称文本为 landsateuwest,容器为 landsat-c2。
- 单击 Microsoft Planetary Computer 数据目录的链接。 搜索并选择要访问的数据集集合。
- 在 ARC_TOKEN_SERVICE_API 中应用账户名称和容器名称。 在请求 URL 模板 https://planetarycomputer.microsoft.com/api/sas/v1/token/{storage_account}/{container} 中,将 storage_account 替换为 landsateuwest,将容器替换为 landsat-c2。
对于 Landsat Collection 2 Level-2 集合,请求 URL 将为 https://planetarycomputer.microsoft.com/api/sas/v1/token/landsateuwest/landsat-c2。
- 创建所需云存储连接文件 打开创建云存储连接文件工具并使用之前步骤中获取的值设置参数。
- 单击运行。
随即为 Landsat 数据集创建云存储连接文件。
现在可以直接在 ArcGIS Pro 中使用云存储连接文件进行可视化和定量分析。