⚠️ Важно: данный сайт не имеет отношения к владельцам schema.org, это всего лишь любительский (неофициальный) перевод. Сайт сделан для тех, кто плохо воспринимает технический английский. Оригинал текста можно найти тут: schema.org/Observation.

Observation

Тип schema.org ?

Этот термин находится в "новой" области — обратная связь по реализации и использование в приложениях и на веб-сайтах могут помочь улучшить определения.

Описание:

Экземпляры класса Observation используются для указания наблюдений о сущности в определенное время. Основные свойства Observation включают observationAbout, measuredProperty, statType, [[value] и observationDate и measuredProperty. Некоторые, но не все наблюдения представляют собой QuantitativeValue. Количественные наблюдения могут касаться StatisticalVariable, который является абстрактной спецификацией, о которой мы можем делать наблюдения, основанные на конкретном месте и времени.

Наблюдения также могут кодировать подмножество простых утверждений в стиле RDF (его observationAbout, StatisticalVariable, определяющий measuredProperty; его свойство observationAbout указывает на сущность, о которой идет речь, и value)

В контексте количественной графовой базы знаний типичные свойства могут включать measuredProperty, observationAbout, observationDate, value, unitCode, unitText, measurementMethod.

Тип Schema.org "Observation" используется для описания наблюдений за определённой сущностью в конкретный момент времени. Он позволяет структурировать и передавать информацию о том, что было замечено или измерено, а также придавать этому процессу определённый контекст.

Основные свойства этого типа включают такие элементы, как "observationAbout", который указывает на сущность, о которой сделано наблюдение, и "measuredProperty", определяющий, какое свойство или характеристика измеряется. Также важным является "observationDate", который фиксирует дату и время наблюдения, и "value", который представляет собой результат измерения или наблюдения. Эти свойства помогают создать полное представление о наблюдении, связывая его с конкретной сущностью и характеристиками.

Тип "Observation" может использоваться в различных областях, таких как наука, медицина, экология и статистика, где важно фиксировать и анализировать данные о наблюдаемых явлениях. Он позволяет организовать данные в структурированном виде, что облегчает их обработку и анализ в рамках более сложных систем, таких как базы данных или графы знаний.

В контексте количественных данных, "Observation" может также включать дополнительные элементы, такие как "unitCode" и "unitText", чтобы уточнить единицы измерения, а также "measurementMethod", который описывает методику, использованную для получения данных. Это делает тип "Observation" универсальным инструментом для систематизации и обмена информацией о наблюдениях и измерениях.

Свойство Ожидаемый тип Описание
Свойство из QuantitativeValue
additionalProperty PropertyValue Свойство-значение, представляющее дополнительную характеристику сущности, например, характеристику продукта или другую характеристику, для которой нет соответствующего свойства в schema.org.

Примечание: Издатели должны учитывать, что приложения, предназначенные для использования конкретных свойств schema.org (например, https://schema.org/width, https://schema.org/color, https://schema.org/gtin13, ...), как правило, ожидают, что такие данные будут предоставлены с использованием этих свойств, а не с использованием механизма свойство/значение общего назначения.
maxValue Number Верхнее значение некоторой характеристики или свойства.
minValue Number Нижнее значение некоторой характеристики или свойства.
unitCode Text, URL Единица измерения, указанная с использованием Общего кода ООН/ЮНКТАД (3 символа) или URL. Другие коды, кроме Общего кода ООН/ЮНКТАД, могут использоваться с префиксом, за которым следует двоеточие.
unitText Text Строка или текст, указывающий единицу измерения. Полезно, если вы не можете предоставить стандартный код единицы для unitCode.
value Text, StructuredValue, Number, Boolean Значение QuantitativeValue (включая Observation) или узел значения свойства.

  • Для QuantitativeValue и MonetaryAmount рекомендуемый тип значений - 'Число'.
  • Для PropertyValue это может быть 'Текст', 'Число', 'Булево' или 'Структурированное значение'.
  • Используйте значения из 0123456789 (Юникод 'DIGIT ZERO' (U+0030) до 'DIGIT NINE' (U+0039)), а не поверхностно похожие символы Юникода.
  • Используйте '.' (Юникод 'FULL STOP' (U+002E)), а не ',', чтобы указать десятичную точку. Избегайте использования этих символов в качестве разделителей для читаемости.
valueReference DefinedTerm, Enumeration, MeasurementTypeEnumeration, PropertyValue, QualitativeValue, QuantitativeValue, StructuredValue, Text Вторичное значение, которое предоставляет дополнительную информацию об исходном значении, например, справочная температура или тип измерения.
Свойство из Observation
marginOfError QuantitativeValue Свойство marginOfError для Observation.
measuredProperty Property Измеряемое свойство Observation, обычно через его StatisticalVariable. Существуют различные виды применимых Property: свойство schema.org, свойство из других совместимых с RDF систем, например, W3C RDF Data Cube, Data Commons, Wikidata или расширения schema.org, такие как GS1's.
measurementDenominator StatisticalVariable Определяет переменную знаменателя, когда наблюдение представляет собой отношение или процент.
measurementMethod DefinedTerm, MeasurementMethodEnum, Text, URL Субсвойство measurementTechnique, которое может использоваться для указания конкретных методов, в частности через MeasurementMethodEnum.
measurementQualifier Enumeration Предоставляет дополнительную квалификацию для наблюдения. Например, наблюдение за ВВП измеряет номинальную стоимость.
measurementTechnique Text, URL, MeasurementMethodEnum, DefinedTerm Техника, метод или технология, используемая в Наблюдении, Статистической переменной или Наборе данных (или Загрузке данных, Каталоге данных), соответствующая методу, использованному для измерения соответствующей переменной (для наборов данных, описанных с использованием измеряемой переменной; для НаблюденияСтатистической переменной). Часто, но не обязательно, каждая измеряемая переменная будет иметь явное представление (или отображение) как свойство, такое как те, что определены в Schema.org, или в других RDF словарях и "графах знаний". В этом случае применима под proprietà измеряемой переменной, называемая измеренной собственностью.

Свойство measurementTechnique помогает, когда требуется дополнительное разъяснение о том, как была измерена измеренная собственность. Это ориентировано на публикацию научных и академических наборов данных, но может иметь более широкую применимость; оно не предназначено для полного представления измерения, но часто может служить высокоуровневым резюме для обнаружения наборов данных.

Например, если измеряемая переменная — это: концентрация молекул, measurementTechnique может быть: "массовая спектрометрия" или "ЯМР спектроскопия" или "колориметрия" или "иммуннофлуоресценция". Если измеряемая переменная — "оценка депрессии", то measurementTechnique может быть "Шкала Цунга" или "HAM-D" или "Инвентаризация депрессии Бека".

Если для данного объекта данных записано несколько свойств измеряемой переменной, используйте значение свойства для каждой измеряемой переменной и прикрепите соответствующую measurementTechnique. Значение также может быть из перечисления, организованного как MeasurementMetholdEnumeration.
observationAbout Place, Thing Свойство observationAbout идентифицирует сущность, часто Место, связанную с Наблюдением.
observationDate DateTime Дата наблюдения Наблюдения.
observationPeriod Text Длительность времени, в течение которого происходило Наблюдение. Формат соответствует P[0-9]*[Y|M|D|h|m|s]. Например, P1Y — это Период 1 год, P3M — это Период 3 месяца, P3h — это Период 3 часа.
variableMeasured Property, PropertyValue, StatisticalVariable, Text Свойство variableMeasured может указывать (при необходимости, повторяя) переменные, которые измеряются в некотором наборе данных, либо описанные в текстовом виде, либо в виде пар идентификатора и описания с использованием PropertyValue, либо более явно как StatisticalVariable.
Свойство из Thing
additionalType URL, Text Дополнительный тип для элемента, обычно используемый для добавления более специфичных типов из внешних словарей в синтаксисе микроданных. Это отношение между чем-то и классом, к которому это что-то относится. Обычно значение является URI-идентифицированным классом RDF, и в этом случае соответствует использованию rdf:type в RDF. Текстовые значения могут использоваться экономно, в случаях, когда полезная информация может быть добавлена без наличия соответствующей схемы для ссылки. В случае текстовых значений, метка класса должна следовать руководству по стилю schema.org.
alternateName Text Псевдоним для элемента.
description Text, TextObject Описание предмета.
disambiguatingDescription Text Субсвойство описания. Краткое описание элемента, используемое для различения его от других, похожих элементов. Информация из других свойств (в частности, имени) может быть необходима для того, чтобы описание было полезным для различения.
identifier PropertyValue, Text, URL Свойство identifier представляет собой любой вид идентификатора для любого рода Thing, такого как ISBN, коды GTIN, UUID и т.д. Schema.org предоставляет специальные свойства для представления многих из них, как в виде текстовых строк, так и в виде ссылок URL (URI). См. фоновую информацию для получения дополнительных деталей.
image ImageObject, URL Изображение предмета. Это может быть URL или полностью описанный ImageObject.
mainEntityOfPage CreativeWork, URL Указывает на страницу (или другое творческое произведение), для которой этот объект является основным описываемым объектом. См. фоновую информацию для получения деталей.
name Text Название элемента.
potentialAction Action Указывает на потенциальное действие, которое описывает идеализированное действие, в котором этот объект будет играть роль 'объекта'.
sameAs URL URL страницы в Интернете, которая однозначно указывает на идентичность элемента. Например, URL страницы элемента в Википедии, запись в Викиданных или официальный сайт.
subjectOf CreativeWork, Event Творческое произведение или событие, связанное с этой вещью.
url URL URL предмета.

Экземпляры Observation могут использоваться в качестве значения для следующих свойств.

Свойство Типы Описание
diseaseSpreadStatistics SpecialAnnouncement Статистическая информация о распространении заболевания, либо в виде WebContent, либо описанная непосредственно как Dataset, либо конкретные Observation в наборе данных. Когда предоставлен URL WebContent, указанная страница может также содержать больше такого разметки.

Примеры

Пример 1

Пример заметки или HTML разметки.


As an example, the statement "According to the US Census ACS 5 Year Estimates,
the median age of women in San Antonio, Texas in 2014 was 34.4 years." can be
represented in JSON-LD.

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
[
 {
  "@context": "https://schema.org/",
  "@type": "StatisticalVariable",
  "@id": "Median_Height_Person_Female",
  "name": "Median height of women",
  "populationType": {"@id": "Person"},
  "measuredProperty": {"@id": "height"},
  "statType": {"@id": "median"},
  "gender": {"@id": "Female"},
  "numConstraints": 1,
  "constrainingProperty": {"@id": "gender"}
 },
  {
  "@context": "https://schema.org/",
  "@id": "Observation_Median_Age_Person_Female_SanAntonio_TX_2014",
  "@type": "Observation",
  "name": "Median height of women in San Antonio, Texas in 2014",
  "description": "An Observation of the StatisticalVariable Median_Height_Person_Female in location: San Antonio, Texas, for time period: 2014",
  "variableMeasured": { "@id": "Median_Height_Person_Female" },
  "observationAbout": { "@id": "https://www.wikidata.org/entity/Q975" },
  "observationDate": 2014,
  "value": 160,
  "unitCode": "CMT"
  }
]
</script>

Структурированное представление примера JSON-LD.

0
@context
https://schema.org/
@type
StatisticalVariable
@id
Median_Height_Person_Female
name
Median height of women
populationType
@id
Person
measuredProperty
@id
height
statType
@id
median
gender
@id
Female
numConstraints
1
constrainingProperty
@id
gender
1
@context
https://schema.org/
@id
Observation_Median_Age_Person_Female_SanAntonio_TX_2014
@type
Observation
name
Median height of women in San Antonio, Texas in 2014
description
An Observation of the StatisticalVariable Median_Height_Person_Female in location: San Antonio, Texas, for time period: 2014
variableMeasured
@id
Median_Height_Person_Female
observationAbout
@id
https://www.wikidata.org/entity/Q975
observationDate
2014
value
160
unitCode
CMT
Автор: Семён Авдосов [schema.su]
Дата публикации: 16.11.2024
Дата обновления: 20.11.2024
Комментарии
Новые материалы на сайте