Проверка веб-карты и элемента ArcGIS

Зачем проверять веб-карту

В ArcGIS веб-карта представляет собой JSON-документ, в котором хранятся не сами слои, а их адреса и настройки отображения. Карта может годами оставаться неизменной, а сервисы за ней тем временем переносят, переименовывают, закрывают или отключают. Карта по-прежнему открывается, но часть слоёв оказывается пустой, и чтобы найти причину, приходится проверять каждый слой вручную. Краткое описание, описание, теги и условия использования на странице элемента тоже со временем устаревают, и элемент становится труднее найти и правильно использовать.

Инструмент читает запись элемента на портале и JSON веб-карты и отвечает сразу на два вопроса: хорошо ли описан элемент и действительно ли доступны слои карты.

Как пользоваться

1. Вставьте адрес элемента. Подходят адреса ArcGIS Online, адреса организаций (…maps.arcgis.com) и порталов ArcGIS Enterprise; идентификатор распознаётся и в адресах Map Viewer и приложений. Если у вас есть только 32-символьный идентификатор элемента Enterprise, укажите также адрес портала.
2. Нажмите Проверить. Сначала появятся сведения об элементе и чек-лист качества описания.
3. Если элемент является веб-картой или веб-сценой, подложка и рабочие слои, включая групповые, выводятся в таблицу. Для каждого слоя указаны видимость, прозрачность, наличие всплывающего окна и адрес; затем на каждый адрес отправляется запрос описания, и заполняется столбец состояния.
4. Таблицу слоёв можно скачать как отчёт CSV, а JSON элемента и данных просмотреть в сворачиваемом виде, скопировать или сохранить в файл.

Что означают состояния слоёв

• Доступен: адрес вернул корректное описание ArcGIS REST или успешный HTTP-ответ.
• Нужен токен / Токен недействителен: сервис защищён (499) или отправленный токен отклонён (498). Если карта открыта для всех, анонимные пользователи этот слой не увидят.
• Не найден / Ошибка: сервис или слой удалён либо переименован, или сервер вернул ошибку.
• Недоступен / Тайм-аут: до сервера не удалось достучаться, или он не ответил вовремя.
• Небезопасный (http): адрес начинается с http. В картографических приложениях, открытых по HTTPS, браузер такие адреса блокирует; инструмент пробует тот же адрес по https и сообщает результат.
• Не прочитан: сервер ответил, но не разрешает браузерные запросы (CORS), поэтому содержимое прочитать не удалось. Слой при этом может работать.
• Встроен в карту: данные хранятся внутри самой веб-карты, а не в отдельном сервисе.

Чек-лист качества описания

Чек-лист проверяет, заполнены ли эскиз, краткое описание, описание, теги, условия использования и авторство, и показывает оценку заполненности, если её рассчитывает портал. Для веб-карт к этому добавляются недоступные слои, слои, требующие токен, адреса http, адреса слоёв со встроенным токеном и слои объектов без настроенного всплывающего окна. Пороги для короткого описания и числа тегов являются рекомендацией инструмента, а не правилом портала.

Для одного элемента такая проверка занимает несколько секунд. На порталах организаций с сотнями и тысячами элементов единообразное описание контента, контроль владельцев и общего доступа, регулярный поиск неработающих ссылок превращаются в отдельную задачу управления. На уровне всего портала её решает Portal Content Manager от Rodosto; подробности на rodostoteknoloji.com.

Данные и метод

Инструмент использует открытые конечные точки ArcGIS REST API: /sharing/rest/content/items/{id}?f=json для сведений об элементе и /sharing/rest/content/items/{id}/data?f=json для описания веб-карты. Для проверки слоёв запрашивается ?f=json у адресов ArcGIS REST, файл стиля у слоёв векторных тайлов, GetCapabilities у слоёв WMS и сам адрес у остальных. Каждый адрес проверяется один раз, одновременно выполняется не более шести запросов. Все запросы идут из вашего браузера напрямую на портал и серверы слоёв и не проходят через серверы Rodosto. Значки взяты из библиотеки Lucide (лицензия ISC); других внешних библиотек инструмент не использует.

Ограничения

• Инструмент рассчитан прежде всего на общедоступные элементы. Элементы с ограниченным доступом читаются только с действующим токеном.
• Доступность слоя ещё не означает, что он правильно отображается; символы, диапазон масштабов и фильтры нужно проверять отдельно.
• Серверы в закрытой сети и серверы, не разрешающие браузерные запросы, с этой страницы полностью проверить нельзя.
• Ради безопасности токен передаётся только на хост портала и, в ArcGIS Online, размещённым сервисам на arcgis.com. Поэтому слои на федеративных серверах с другим адресом могут отображаться как требующие токен.
• Для элементов-приложений проверяются только сведения об элементе; если приложение основано на веб-карте, её можно проверить одним щелчком.

Для организаций

Rodosto, партнёр Esri, работает с ArcGIS Online и ArcGIS Enterprise: от управления контентом портала до сопровождения. Подробнее о нашей работе на rodostoteknoloji.com; связаться с нами можно через страницу контактов.