Подключение к API STAC позволяет вам искать ресурсы данных и использовать их непосредственно в ArcGIS Pro. Одним из ключевых элементов при настройке подключения к STAC API является включение файлов подключения ArcGIS Cloud Storage (.acs). Когда наборы данных, обнаруженные через STAC API, надежно защищены в месте хранения, эти файлы .acs необходимы для аутентификации при доступе к наборам данных в ArcGIS Pro. Некоторые API STAC (или коллекции, на которые они ссылаются) отображают наборы данных, которые хранятся в общедоступном хранилище. Им не нужны файлы ACS для использования данных в ArcGIS Pro.
Подключения к облачным хранилищам хранятся в файловой системе в виде файлов с расширением .acs. Вы можете создать подключение к облачному хранилищу, используя диалоговое окно Новое подключение к облачному хранилищу или инструмент геообработки Создать файл подключения к облачному хранилищу.
См. справку инструмента Создание файла подключения к облачному хранилищу для получения подробной информации о создании файла .acs. Дополнительные сведения о подключении к облачному хранилищу см. в разделе Подключение к облачному хранилищу.
Примечание:
Вы не сможете использовать данные из частных или защищенных бакетов, если в файле .acs не будут указаны необходимые для аутентификации учетные данные. В этом случае вы можете только просматривать данные на вкладках Параметры и Результаты на панели Исследовать STAC.
Во многих случаях точка доступа STAC API для выполнения поиска открыта для общественности и не требует аутентификации. Это позволяет вам свободно искать и узнавать, какие активы доступны. Однако доступ для чтения или загрузки данных об активах может быть защищен и требует аутентификации. Для создания файлов .acs требуются определенные параметры - в зависимости от типа хранилища данных, в котором находятся наборы данных коллекций. Например, для Microsoft Planetary Computer (MPC) STAC требуются токены Подписи общего доступа к хранилищу Azure (SAS).
Создайте файл .acs для доступа к коллекции Landsat Collection 2 level-2 на MPC STAC.
Выполните следующие действия для создания файла подключения к облачному хранилищу с помощью инструмента геообработки Создать файл подключения к облачному хранилищу для доступа к коллекции Landsat на MPC STAC. Для работы с коллекциями в 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. В шаблоне https://planetarycomputer.microsoft.com/api/sas/v1/token/{storage_account}/{container} URL-адреса запроса замените 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.