Skip To Content

Настройка слоев границ

Esri предоставляет слои, содержащие границы и демографическую информацию в них по различным регионам мира. Эти слои, например, штаты, провинции, округа, почтовые индексы, районы и т.п. содержат локальные сведения, которые участники портала могут использовать в своих картах, приложениях, инструментах анализа и Insights for ArcGIS.

Эти слои должны быть опубликованы на портале, если у вас установлен Insights for ArcGIS или у портала нет доступа к ресурсам Living Atlas of the World из ArcGIS Online.

Администратор портала может загрузить нужные файлы определения сервиса слоя границ (.sd) с My Esri и запустить инструмент publishboundarylayers для публикации на их основе размещенных векторных слоев.

Примечание:

Все инструменты, описанные в этом разделе должны запускаться со встроенной учетной записью администратора портала и с доступом через порт 7443, а не через веб-адаптер или балансировщик нагрузки.

Можно выполнить публикацию из папки, в которой находятся все нужные файлы, опубликовать отдельные файлы или предоставить список файлов в текстовом формате. Убедитесь, что учетная запись, которая использовалась для установки Portal for ArcGIS имеет доступ на чтение к этой папке.

Публикация этих файлов определения сервиса границ (.sd) на портал приведет к следующему:

  • Каждый .sd добавляется на портал как элемент определения сервиса. Эти файлы должны остаться на портале, если нужно обновить слои границ, если они изменились.
  • Для каждого опубликованного файла .sd создается размещенный векторный слой. Каждый размещенный векторный слой состоит из нескольких слоев.
  • И элементы определения сервиса, и размещенные векторные слои принадлежат внутреннему участнику портала с именем esri_boundaries. Не передавайте их другому пользователю.
  • По умолчанию все участники портала имеют доступ к размещенному на нем векторному слою границ.

Публикация слоев границ

Эти слои лицензируются в соответствии с Esri Master License Agreement. Перед публикацией прочтите краткую информацию и условия использования.

Важные требования при использовании

  • Эти слои лицензированы для внутреннего использования в ArcGIS Enterprise, включая Portal for ArcGIS, Insights for ArcGIS и другие связанные приложения ArcGIS.
    • Пользователям не разрешается применять эти слои вне семейства продуктов ArcGIS Enterprise или экспортировать данные для автономного использования в ArcGIS и других приложениях.
    • Пользователям не разрешается публиковать эти слои (ни в публичном, ни в частном доступе) для внешнего использования участниками других организаций или широкой аудиторией, без специального письменного разрешения Esri.
  • Слои лицензированы для использования в течение двух (2) лет после загрузки с Esri. Вы можете загружать самые последние данные каждый год для продления срока действия лицензии.
  • При любой демонстрации этих слоев с каждым из них необходимо публиковать сведения Credits (Attribution).

Для получения файлов границ и их публикации в качестве векторных слоев на портале следуйте инструкциям ниже:

  1. Загрузите архивы, которые содержат файлы определений сервисов (.sd) из My Esri.
    1. Войдите в My Esri.
    2. Перейдите в Мои организации > Загрузки > Данные и ресурсы.
    3. Введите Boundary в поле поиска, чтобы отфильтровать слои границ.
    4. Щелкните Загрузить для выбранных файлов.
  2. Извлеките загруженные файлы в папку на машине с Portal for ArcGIS.

    Имена файлов содержат трехбуквенный код, обозначающий регион, к которому он относится, и год для данных, прикрепленный к окончанию имени. Например, USA_Boundaries_2015 содержит границы США в 2015 году.

    Удалите ненужные файлы. Либо создайте текстовый файл со списком файлов, которые нужно загрузить и опубликовать. Каждая строка в нем должна соответствовать только одному имени файла, например, если нужно загрузить границы США или на весь мир, в текстовом файле должно быть:

    USA_Boundaries_2015
    WOR_Boundaries_2015

  3. Откройте командное окно на машине Portal for ArcGIS.
  4. Измените папки на те, которые доступны инструменту.
  5. Запустите инструмент publishboundarylayers.

    Инструмент установлен в <Portal installation directory>/tools/publishboundarylayers. Синтаксис инструмента выглядит так:publishboundarylayers --folder <location of files> [{--files <file names>|--file <name of text file>}] --url <Portal website URL> --username <portal administrator user name> [--password <portal administrator password>]

    Если не указывать пароль при запуске инструмент, потребуется ввести пароль администратора портала. Пользователь должен иметь роль администратора портала по умолчанию.

    Если используется опция --files, укажите список файлов определения сервисов, разделенных запятыми. Если используется опция --file, укажите имя текстового файла, содержащего список файлов границ для публикации.

    В данном примере все файлы из папки boundaryfiles публикуются на портал:

    ./publishboundarylayers.sh --folder /usr/tmp/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

    В данном примере файлы находятся в той же папке (boundaryfiles), но публикуются только три из них:

    ./publishboundarylayers.sh --folder /usr/tmp/boundaryfiles --files USA_Boundaries,WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

    В данном примере создается текстовый файл (boundarysubset.txt) в папке boundaryfiles. Инструмент прочитает список файлов из текстового файла, чтобы опубликовать избранные слои границ.

    ./publishboundarylayers.sh --folder /usr/tmp/boundaryfiles --file boundarysubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin

После того, как публикация будет завершена, для каждого опубликованного файла .sd появятся элемент определения сервиса и размещенный векторный слой.

Чтобы убедиться, что элементы появились, можно выполнить поиск по всем элементам портала, принадлежащим пользователю esri_boundaries. Введите owner:esri_boundaries в поле поиска портала и затем Поиск по всем ресурсам.

Обновление слоев границ

В большинстве случаев обновления слоя границ являются новым файлом определения сервиса, публикуемым вами на своем портале с использованием утилиты publishboundarylayers. Это позволит вам использовать слои отдельно и анализировать две версии данных. К примеру, могут быть версии файла с границами 2015 и 2017 гг. В редких случаях файлы определения сервисов, предоставленные на My Esri обновляются корректным содержимым. В этих случаях можно загрузить файл обновлений и опубликовать их с помощью инструмента updateboundarylayers. При этом существующие размещенные векторные слои на портале будут замещены.

Как было отмечено в начале, обновить слои границ можно только в том случае, если элемент определения сервиса слоя все еще существует на портале.

Для обновления существующих векторных слоев границ на портале:

  1. Загрузите архивы, которые содержат обновленные файлы определений сервисов (.sd) из My Esri.
  2. Извлеките эти файлы в папку на машине с Portal for ArcGIS.

    Удалите ненужные файлы. Либо создайте текстовый файл со списком файлов, которые нужно загрузить и опубликовать. Каждая строка в нем должна соответствовать только одному имени файла, например, если нужно загрузить границы США и на весь мир, в текстовом файле должно быть:

    USA_Boundaries_2015
    WOR_Boundaries_2015

  3. Откройте командное окно на машине Portal for ArcGIS.
  4. Измените папки на те, которые доступны инструменту.
  5. Запустите инструмент updateboundarylayers.

    Инструмент установлен в <Portal installation directory>/tools/publishboundarylayers. Синтаксис инструмента выглядит так:updateboundarylayers --folder <location of files> [{--files <file names>|--file <name of text file>}] --url <Portal home page URL> --username <portal administrator user name> [--password <portal administrator password>]

    Если не указывать пароль при запуске инструмент, потребуется ввести пароль администратора портала. Пользователь должен иметь роль администратора портала по умолчанию.

    Если используется опция --files, укажите список файлов определения сервисов, разделенных запятыми. Если используется опция --file, укажите имя текстового файла, содержащего список файлов границ для публикации.

    В данном примере все файлы из папки boundaryfiles публикуются на портал, при этом существующие слои будут заменены:

    ./updateboundarylayers.sh --folder /usr/tmp/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

    В данном примере файлы находятся в той же папке (boundaryfiles), но заново будет опубликован только один из них:

    ./updateboundarylayers.sh --folder /usr/tmp/boundaryfiles --files WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

    В данном примере создается текстовый файл (boundaryupdatesubset.txt) в папке boundaryfiles. Инструмент прочитает список файлов из текстового файла, чтобы переопубликовать избранные слои границ.

    ./updateboundarylayers.sh --folder /usr/tmp/boundaryfiles --file boundaryupdatesubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin

После того, как публикация будет завершена, размещенные векторные слои границ будут содержать обновленные данные или метаданные.

Удаление слоев границ

Если окажется, что какой-то слой границ на портале больше не нужен, можно его удалить. Можно искать слои на веб-сайте портала и удалять их там, либо запустить инструмент deleteboundarylayers. Если нужно одновременно удалить несколько слоев границ, используйте инструмент deleteboundarylayers.

Инструмент deleteboundarylayers не будет удалять слои, у которых включена защита от удаления.

Внимание:

Если удалить слой границ, который используется в карте, приложении или сцене, то этот слой больше не будет там появляться. При повторной публикации слой в них не появится, так как в этом случае будет создан новый элемент с новым ID на портале.

Можно ввести список слоев для удаления, разделенных запятыми, для операции --files, либо текстовый файл со списком слоев для удаления для операции --file.

Синтаксис списка слоев, разделенных запятыми, должен быть следующим: deleteboundarylayers {--files <layer_name_list> | --file <location_of_text_file>} --url <portalURL> --username <portal_admin> [--password password]

Например, для удаления слоев USA_Boundaries_2015и WOR_Boundaries_2015 с портала https://portal.domain.com:7443/arcgis администратором портала под именем portaladmin введите следующее:

./deleteboundarylayers.sh --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.domain.com:7443/arcgis --username portaladmin

Синтаксис текстового файла со списком слоев для удаления должен быть следующим: deleteboundarylayers --file <location_of_text_file> --url <portalURL> --username <portal_admin> [--password password]

Например, чтобы удалить те же слои с помощью файла, создайте текстовый файл, в котором каждая строка соответствует одному имени слоя (как показано здесь) и укажите, где находится и как называется этот файл при запуске инструмента:

USA_Boundaries_2015
WOR_Boundaries_2015

В примере ниже файлы boundarylist находятся в /usr/data/boundaries. Он содержит список слоев, которые нужно удалить с портала, https://webadaptorhost.domain.com/webadaptorname.

./deleteboundarylayers.sh --file /usr/data/boundaries/boundarylist --url https://portal.domain.com:7443/arcgis --username portaladmin