Редакторы публичных сайтов могут использовать каналы, доступные для сайта ArcGIS Hub, для интеграции ресурсов общедоступного каталога сайта с внешними каталогами. Каналы каталогов облегчают взаимодействие между каталогами данных и могут повысить эффективность поиска с помощью поисковых систем и сторонних каталогов. Менеджеры и посетители могут подписаться на каналы, чтобы отслеживать изменения в каталогах ресурсов.
Использование каналов каталога
Используйте каналы Hub, чтобы быть в курсе изменений в каталоге сайта, таких как добавление новых ресурсов. Для всех общедоступных сайтов Hub с общедоступными элементами в их каталоге в нижнем колонтитуле сайта и интерфейсе поиска появляется кнопка Изучить каналы. Хотя по умолчанию каналы включены на всех публичных сайтах, редакторы сайтов могут отключить каналы для общедоступных сайтов. Нажмите кнопку Изучить каналы, чтобы отобразить URL-адрес канала сайта и страницы обозревателя API. Hub поддерживает следующие каналы:
- RSS (<siteURL>/api/feed/rss/2.0)
- DCAT US 1.1 (<siteURL>/api/feed/dcat-us/1.1.json)
- DCAT AP 2.1.1 (<siteURL>/api/feed/dcat-ap/2.1.1.json)
- OGC API – Records (<siteURL>/api/search/definition)
Каналы RSS
RSS (Really Simple Syndication) — формат веб-канала, используемый для публикации часто обновляемых ресурсов стандартизированным способом, позволяющий пользователям автоматически подписываться и получать обновления. RSS-каналы содержат метаданные высокого уровня, такие как название, описание и дата публикации всех общедоступных ресурсов, размещенных на сайте. Пользователи могут отслеживать изменения в поисковом каталоге или загружать канал в RSS-ридер (агрегатор), чтобы продемонстрировать ресурс на другом сайте. Hub соответствует спецификации GeoRSS.
Каналы DCAT
На каждом сайте есть каталог ресурсов, содержащий элементы, которыми вы хотите поделиться через сайт. Использование DCAT для описания ресурсов каталога может повысить удобство обнаружения и позволить приложениям получать доступ к метаданным из нескольких каталогов. Это также позволяет осуществлять глобальный поиск наборов данных по каталогам.
Интегрируйте каталог вашего сайта, предоставив общий URL-адрес выходного канала, который автоматически генерируется для каждого публичного сайта Hub. Hub поддерживает два канала DCAT: DCAT US 1.1. и DCAT AP 2.1.1. Этот каталог канала, например www.yourhubsite.gov/api/feed/dcat-us/1.1.json, соответствует DCAT US 1.1. Также вы можете редактировать ресурсы каталога вашего сайта с помощью редактора конфигурации DCAT в Hub.
Подсказка:
Каталог <DCAT type>.json заполняется только общедоступными элементами данных и их слоями. Частные ресурсы из вашей организации в настоящее время не могут быть опубликованы или интегрированы с помощью каталога DCAT.
API OGC - Records
Используйте OGC API - Records для обнаружения геопространственных ресурсов с помощью стандартизированных коллекций и метаданных ресурсов. Вы можете программно запрашивать, фильтровать и выполнять поиск по каталогу сайта Hub, включая общедоступные и частные элементы (если у вас есть действительный токен для частных элементов). Используйте проводник OGC API - Records для тестирования конечных точек API и поиска по каталогу без необходимости использования клиентского интерфейса поиска на сайте. Распространенные варианты использования включают отображение объектов на карте в других инструментах, включая ArcGIS Online Map Viewer, настольные приложения ГИС, OWSLib и многое другое.
Настройка и управление каналами
Каналы доступны для публичных сайтов, в каталоге которых имеются общедоступные ресурсы. Менеджеры сайта могут выбирать, какие атрибуты и значения применяются к выходному каналу сайта для DCAT US 1.1, DCAT AP 2.1.1 и RSS. Вы можете сохранить конфигурацию Hub по умолчанию или настроить определенные поля/атрибуты самостоятельно. В редакторе канала предоставьте действительные ключи, соответствующие метаданным набора данных. Каналы доступны по умолчанию, но их можно отключить в рабочей области сайта.
Чтобы настроить каналы и управлять ими, выполните следующие шаги:
- Откройте сайт в режиме редактирования.
- Нажмите кнопку Управление сайтом
, чтобы открыть рабочую область сайта. - Выберите Настройки и перейдите на панель Канал.
- Чтобы включить каналы, выберите Включить каналы. Для Каналы выберите тип канала.
- В редакторе Конфигурация скопируйте и вставьте свой код в любом месте после запятой и перед последней скобкой.
Примечание:
Некоторые атрибуты редактировать нельзя.
Подсказка:
Шаблон RSS-канала имеет другую структуру, которая не позволяет вам добавлять ключ верхнего уровня.
- Выберите Сохранить.
Конфигурация RSS-канала
Редакторы сайта хаба могут выбирать отображаемые метаданные, т.е. переопределять значения метаданных по умолчанию и предоставлять значения, наиболее важные для пользовательских обновлений. Например, редактор сайта может настроить значения метаданных таким образом, чтобы при обновлении ресурса выделялись краткое описание и связанное с ним географическое местоположение.
Пример схемы DCAT по умолчанию
Hub использует схему в формате JSON, чтобы определить, какие свойства метаданных отображаются для каждой записи в соответствующем канале. Ниже показан пример схема DCAT US 1.1 по умолчанию. Она содержит пары ключ/значение, например, "title”: “{{name}}” и “description”: {{description}}. Для каждой записи канала вы увидите ключ (“title”) и значение шаблона (“<item’s metadata title>”). Дизайн схемы основан на прямом соответствии метаданных элементов ArcGIS стандарту DCAT US 1.1.
Схема DCAT US 1.1 по умолчанию
{
"title": "{{name}}",
"description": "{{description}}",
"keyword": "{{tags}}",
"issued": "{{created:toISO}}",
"modified": "{{modified:toISO}}",
"publisher": {
"name": "{{source}}"
},
"contactPoint": {
"fn": "{{owner}}",
"hasEmail": "{{orgContactEmail}}"
},
"spatial": "{{extent}}"
}Можно отредактировать атрибут "spatial" каналов DCAT US и DCAT AP. Хаб будет использовать в новых шаблонах экстент элемента (по умолчанию). Для элементов без значения экстента пространственный атрибут удаляется. Вы можете заменить значение "spatial" альтернативным - "spatial": "{{extent || 'SPATIAL_FALLBACK'}}" и обновить шаблон по умолчанию.
Примеры пользовательских схем DCAT
Вы можете настроить схему, добавляя, обновляя и удаляя пары ключ/значение. Некоторые ключи, в зависимости от типа канала, редактировать нельзя. Ниже приводится пример пользовательской схемы DCAT US 1.1 с рядом модификаций, в частности:
- Добавление пары ключ-значение
- Обновление пары ключ-значение
- Добавление запасной пары ключ-значение
Подсказка:
Поддержание работоспособности каналов имеет важное значение для взаимодействия и доступности вашего общедоступного ресурса Hub. Перед добавлением или изменением полей ознакомьтесь с соответствующими ресурсами, так как это может привести к недопустимости канала (Hub не проверяет каналы). Недопустимые каналы могут вызвать проблемы с интегрированными ресурсами каталога на таких сайтах, как data.gov, data.europa.eu и в других местах, где используются каналы. Проверяйте свои каналы до и после их настройки с помощью валидатора DCAT US 1.1 и валидатора DCAT AP.
Пользовательская схема DCAT US 1.1
{
"title": "{{name}}",
"description": "{{description}}",
"keyword": "{{tags}}",
"issued": "{{created:toISO}}",
"modified": "{{modified:toISO}}",
"publisher": {
"name": "{{source}}"
},
"contactPoint": {
"fn": "{{owner}}",
"hasEmail": "{{orgContactEmail}}"
},
"culture": "{{culture}}",
"summary": "{{snippet}}",
"platform": "ArcGIS Hub",
"bureauCode": [
"010:86",
"010:04"
],
"programCode": [
"015:001",
"015:002"
]
}Примечание:
В пользовательской схеме DCAT US 1.1 появились пять новых ключей: “culture”, “summary”, “platform”, “bureauCode” и “programCode”. Для ключей “culture” и “summary” есть значения шаблона, полученные из OGC API - Records, последней версии Hub API. Ключи “platform”, “bureauCode” и “programCode” имеют буквенные строковые значения.
Примеры пользовательских значений
Чтобы обеспечить соответствие стандартам метаданных организации, менеджеры сайтов могут решить скорректировать метаданные, отображаемые в канале. Ключом может быть любая символьная строка, такая как “title” или “”, но она, как правило, должна соответствовать целевому стандарту метаданных. Соответствующие значения могут быть строкой символов или шаблоном, который извлекает ключ из OGC API - Records. Для шаблонов вы можете указать любой ключ, возвращаемый из OGC API - Records, как верхнего уровня, так и вложенный.
Например, на сайте dc.esri.com, где используются примеры каналов Hub, есть общедоступный слой под названием “USA Weather Watches and Warnings.” Вы можете изучить метаданные JSON для этого набора данных по ID слоя: c7a223914778420db8bf000b4eb6ec6f, используя OGC API - Records (https://hub.arcgis.com/api/search/v1/collections/all/items/c7a223914778420db8bf000b4eb6ec6f) или https://hub.arcgis.com/api/search/v1/collections/all/items?id=c7a223914778420db8bf000b4eb6ec6f.
Изучив этот пример ответа API вы увидите JSON, начинающийся с чего-то подобного: Пример пользовательского значения DCAT US 1.1"data":
{
"id": "c7a223914778420db8bf000b4eb6ec6f",
"type": "dataset",
"attributes": {
"errors": [],
"access": "public",
"additionalResources": [],
…
}
Если вы прокрутите вниз, вы увидите другие ключи для выбора и использования их в качестве значений шаблона в редакторе, например “created”, содержащий дату создания контента. Чтобы использовать значение из OGC API - Records, в редакторе каналов добавьте шаблонное значение для любого ключа OGC API - Records под “attributes”. Например, если вы хотите включить в записи канала значение “created”, например:
Пример пользовательского значения DCAT US 1.1{
…
"bureauCode": ["010:86","010:04"],
"programCode": ["015:001","015:002"],
"created": 1610151009000,
…
}{
…
"bureauCode": [
"010:86",
"010:04"
],
"programCode": [
"015:001",
"015:002"
],
"created": "{{item.created}}"
…
}
Менеджеры ресурсов могут настраивать каналы для подключения дополнительных пользовательских рассылок. Они добавляются к существующим рассылкам, которые Hub автоматически создает для загружаемых ресурсов элемента содержимого.
Интеграция каталогов через каналы RSS
Редакторы каналов Hub позволяют менеджерам сайта стандартизировать метод описания данных. Менеджеры сайтов могут выбрать, какие значения метаданных будут отображаться для каждого набора данных канала до сбора данных.
Интеграция с Data.gov
В США вы можете изменить свои выходные данные для взаимодействия с крупными центрами обмена данными, такими как национальный каталог Data.gov. Этот тип взаимодействия означает, что вы можете указать этим сторонним агрегаторам на множество дистрибутивов, в которых доступен набор данных. Дистрибутивы - это форматы, предлагаемые для использования в качестве веб-сервиса, загрузки или API.
Редакторы сайта могут выбирать, какие атрибуты и значения применяются к выходному каналу DCAT US 1.1 сайта. В редакторе канала предоставьте действительные ключи, соответствующие метаданным набора данных.
Интеграция с CKAN
Если ваша организация использует программное обеспечение для каталогизации, такое как CKAN, или работает с другими организациями, которые его используют, вы можете интегрировать свой каталог данных сайта внутри хаба. Экземпляр CKAN должен быть правильно настроен для поддержки сбора данных. Во-первых, установите и настройте два расширения, которые разрабатываются и поддерживаются командой CKAN и используются Data.gov и другими каталогами для сбора наборов данных: расширение CKAN Harvesting и расширение CKAN DCAT.
Убедитесь, что эти расширения установлены, а затем - что у вас есть сервисы Harvester Gather_Consumer и Fetch_Consumer, работающие в фоновом режиме. Обратитесь к документации CKAN для получения дополнительных сведений.
Накопление каталога ArcGIS Hub
Чтобы собрать каталог , выполните следующие действия:
- Перейдите на страницу администрирования сбора данных CKAN и войдите в http://yourCKANinstance/harvest.
- Выберите Добавить источник данных и предоставьте сведения о своем сайте Hub:
- Введите URL-адрес с <siteURL>/api/feed/dcat-us/1.1.json.
- Присвойте источнику данных заголовок, похожий на имя вашего сайта. Дополнительно заполните поле описания.
- Выберите DCAT JSON Harvester в качестве типа источника.
- Для частоты обновления выберите Вручную.
- Выберите Сохранить.
- Выберите Admin, затем Reharvest.
- Запустите задачи сбора данных на вашем экземпляре CKAN.
CKAN обрабатывает ваш файл .json и собирает все наборы данных. Источник сбора показывает, что было собрано. Метаданные элементов и слоев, включая описания, теги и дистрибутивы форматов загрузки из Hub, доступны из экземпляра CKAN.
Примечание:
Каналы каталога автоматически используют API загрузки версии 1 (ранее использовавшийся API загрузки устарел).