Обозреватель ArcGIS REST сервисов

Что такое каталог ArcGIS REST сервисов

ArcGIS Server и ArcGIS Enterprise публикуют каждый картографический сервис, сервис объектов и сервис изображений через REST-интерфейс. Его корень обычно выглядит как …/arcgis/rest/services, а ниже находятся папки, сервисы (MapServer, FeatureServer, ImageServer и другие), слои и таблицы каждого сервиса. Слои объектов, размещённые в ArcGIS Online, устроены так же. Если добавить к адресу любого из этих ресурсов ?f=json, он опишет себя в машиночитаемом виде: имя, тип геометрии, систему координат, поля и поддерживаемые операции.

Обозреватель читает эти JSON-описания и собирает из них аккуратное дерево и сводные таблицы. Чтобы узнать, из каких слоёв состоит сервис, проверить тип поля или его кодированные значения, выяснить число объектов и быстро посмотреть слой на карте, больше не нужно переходить по страницам REST одна за другой.

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

1. Вставьте адрес каталога сервисов, папки, сервиса или отдельного слоя, например …/rest/services, …/rest/services/Folder/Service/MapServer или …/FeatureServer/0. Окончания вроде ?f=pjson не мешают.
2. Нажмите Прочитать сервис. Папки и сервисы появятся в дереве; щелчок по папке или сервису загружает его содержимое. Групповые слои показываются вместе с дочерними.
3. Выберите слой или таблицу. На панели сведений будут имя, тип, тип геометрии, система координат (wkid и latestWkid), экстент, maxRecordCount, возможности, версия и число объектов, ниже таблица полей. Карта приблизится к экстенту слоя, показанному пунктиром.
4. При необходимости задайте условие where и отметьте только нужные поля. Кнопка Показать на карте загружает объекты постранично, индикатор показывает, сколько уже получено. Щелчок по объекту на карте открывает его атрибуты.
5. Скачайте загруженные записи в GeoJSON, CSV или KML.

Фильтр, постраничная выборка и лимит записей

Поле where передаётся в операцию query сервиса как SQL-подобное условие. Числа пишутся как POP2000 > 100000, текст в одинарных кавычках: STATE_NAME = 'Texas'. Имена полей должны совпадать с именами в таблице полей. После изменения условия кнопка # обновляет число объектов.

За один запрос сервис возвращает не больше maxRecordCount объектов. Чтобы обойти это ограничение, инструмент загружает данные по страницам: если сервис поддерживает постраничную выборку, он идёт по объектам в порядке ObjectID с помощью resultOffset и resultRecordCount, если нет, сначала получает список ObjectID, а затем запрашивает объекты пакетами. По умолчанию загружается до 2 000 объектов, лимит можно поднять до 10 000. Большие слои бережнее для браузера и сервиса выгружать частями, разделив их условием where.

Форматы экспорта

• GeoJSON: координаты в WGS84 (EPSG:4326), порядок долгота, широта. Если сервис умеет отдавать GeoJSON, используется этот вывод; иначе ответ в формате Esri JSON преобразуется в GeoJSON прямо в браузере, а внешние кольца и дыры полигонов разделяются по направлению обхода.
• CSV: выбранные поля становятся столбцами. Геометрия записывается в один столбец WKT; для точечных слоёв вместо него можно выбрать столбцы X (долгота) и Y (широта). Поля дат переводятся в ISO 8601. Файл сохраняется в UTF-8 с BOM, чтобы кириллица правильно отображалась в табличных редакторах.
• KML: каждый объект становится меткой Placemark с именем из поля отображения слоя, атрибуты записываются в ExtendedData.

Защищённые сервисы и токены

Закрытые сервисы отвечают кодом 499 (Token Required). Если у вас есть доступ, введите в необязательное поле токен, полученный на вашем портале или сервере. Он хранится в памяти, передаётся в теле запроса только на указанный сервер и не появляется в адресах на экране. В организациях вопрос о том, кому, на какой срок и через какие приложения открывать защищённые сервисы, а также как выпускать и обновлять токены, становится отдельной задачей управления. На уровне прокси и токенов её решает Proxy Token Manager от Rodosto; подробности на rodostoteknoloji.com.

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

Инструмент использует стандартные конечные точки ArcGIS REST API: f=json для описаний каталога, сервиса и слоя, returnCountOnly для числа объектов, returnExtentOnly для экстента и операцию query с outSR=4326 для просмотра. Все запросы идут из вашего браузера напрямую на указанный сервер и не проходят через серверы Rodosto, поэтому сервер должен разрешать браузерные запросы (CORS). Значки взяты из библиотеки Lucide (лицензия ISC). Подложки принадлежат Esri и участникам OpenStreetMap. Используемые библиотеки с открытым исходным кодом и их лицензии: Источники данных.

Ограничения

• CORS и внутренние сети: серверы, закрытые для браузерных запросов или доступные только из внутренней сети, с этой страницы прочитать нельзя. Инструмент сообщает об этом отдельно.
• Адреса HTTP: страница открыта по HTTPS, поэтому адреса с http сначала пробуются по https. Если у сервера нет HTTPS, браузер заблокирует запрос.
• Сервисы изображений: для ImageServer и кэшированных картографических сервисов показываются сведения и экстент; пиксельные данные не скачиваются.
• Право на использование: открытый доступ к сервису ещё не означает, что данные можно использовать для любых целей. Скачивайте данные только из сервисов, которыми вы вправе пользоваться; действуют условия использования владельца сервиса.

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

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