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

QuantitativeValue

Тип schema.org ?

Описание:

Точка значения или интервал для характеристик продукта и других целей.

QuantitativeValue — это тип данных в Schema.org, который используется для представления числовых значений или диапазонов значений, связанных с характеристиками продуктов или других объектов. Этот тип может использоваться в различных контекстах, где необходимо указать количественные характеристики, такие как размеры, вес, объем, цена и другие параметры.

Основная цель QuantitativeValue — предоставить структурированную информацию, которая помогает поисковым системам и другим приложениям лучше понимать и интерпретировать данные о продукте. Это улучшает видимость информации в поисковых системах и может повысить качество результатов поиска для пользователей.

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

Использование QuantitativeValue актуально в электронной коммерции, на сайтах с товарами и услугами, в отзывах о продуктах и в других областях, где количественные характеристики имеют значение. Это позволяет создать более информативные и структурированные данные, которые могут быть использованы для улучшения пользовательского опыта и аналитики.

Свойство Ожидаемый тип Описание
Свойство из 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 Вторичное значение, которое предоставляет дополнительную информацию об исходном значении, например, справочная температура или тип измерения.
Свойство из 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 предмета.

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

Свойство Типы Описание
accelerationTime Vehicle Время, необходимое для разгона транспортного средства от заданной начальной скорости до заданной целевой скорости.

Типичный код единицы измерения: SEC для секунд

  • Примечание: К сожалению, нет стандартных кодов единиц измерения для секунд/0..100 км/ч или секунд/0..60 миль/ч. Просто используйте "SEC" для секунд и укажите скорости в name QuantitativeValue, или используйте valueReference с QuantitativeValue от 0..60 миль/ч или 0..100 км/ч для указания эталонных скоростей.
activityDuration ExercisePlan Продолжительность времени, необходимая для участия в деятельности.
activityFrequency ExercisePlan Как часто следует заниматься деятельностью.
advanceBookingRequirement Offer, Demand Количество времени, необходимое между принятием предложения и фактическим использованием ресурса или услуги.
annualPercentageRate FinancialProduct Годовая ставка, взимаемая за заимствование (или получаемая от инвестирования), выраженная в виде одного процентного числа, которое представляет собой фактическую годовую стоимость средств за срок кредита. Это включает любые сборы или дополнительные расходы, связанные с транзакцией.
billingDuration UnitPriceSpecification Указывает, на какой срок будет взиматься эта цена (или компонент цены). Может использоваться, например, для моделирования контрактной продолжительности подписки или платежного плана. Тип может быть либо Duration, либо Number (в этом случае единица измерения, например месяц, указывается с помощью свойства unitCode).
broadcastFrequencyValue BroadcastFrequencySpecification Частота в МГц для конкретной трансляции.
cargoVolume Vehicle Доступный объем для груза или багажа. Для автомобилей это обычно объем багажника.

Типичный код единицы измерения: LTR для литров, FTQ для кубических футов

Примечание: Вы можете использовать minValue и maxValue для указания диапазонов.
deliveryLeadTime Offer, Demand Типичное время задержки между получением заказа и отправкой товара из склада или его подготовкой к самовывозу, если способ доставки — самовывоз.
depth OfferShippingDetails, Product, VisualArtwork Глубина элемента.
durationOfWarranty WarrantyPromise Продолжительность гарантии. Общие значения unitCode: ANN для года, MON для месяцев или DAY для дней.
eligibleDuration Offer, Demand Продолжительность, в течение которой данное предложение действительно.
eligibleQuantity PriceSpecification, Offer, Demand Интервал и единица измерения заказных количеств, для которых предложение или спецификация цены действительны. Это позволяет, например, указать, что определенная плата за груз действительна только для определенного количества.
engineDisplacement EngineSpecification Объем, который проходят все поршни внутри цилиндров внутреннего двигателя сгорания за одно движение.

Типичный код единицы измерения: CMQ для кубического сантиметра, LTR для литров, INQ для кубических дюймов * Примечание 1: Вы можете связать информацию о том, как было определено данное значение, используя свойство valueReference. * Примечание 2: Вы можете использовать minValue и maxValue, чтобы указать диапазоны.
enginePower EngineSpecification Мощность двигателя транспортного средства. Типичные коды единиц: KWT для киловатта, BHP для лошадиных сил, N12 для метрических лошадиных сил (PS, где 1 PS = 735,49875 W)

  • Примечание 1: Существует множество различных способов измерения мощности двигателя. Для обзора см. http://en.wikipedia.org/wiki/Horsepower#Engine_power_test_codes.
  • Примечание 2: Вы можете связать информацию о том, как было определено данное значение, используя свойство valueReference.
  • Примечание 3: Вы можете использовать minValue и maxValue, чтобы указать диапазоны.
floorSize Accommodation, FloorPlan Размер помещения, например, в квадратных метрах или квадратных футах. Типичный код единицы измерения: MTK для квадратного метра, FTK для квадратного фута или YDK для квадратного ярда.
fuelCapacity Vehicle Вместимость топливного бака или, в случае электрических автомобилей, аккумулятора. Если есть несколько компонентов для хранения, это должно указывать на общий объем всего хранилища одного типа.

Типичные коды единиц: LTR для литров, GLL для американских галлонов, GLI для британских / имперских галлонов, AMH для ампер-часов (для электрических транспортных средств).
fuelConsumption Vehicle Количество топлива, потребляемого для преодоления определенного расстояния или временного интервала на данном транспортном средстве (например, литры на 100 км).

  • Примечание 1: К сожалению, нет стандартных кодов единиц измерения для литров на 100 км. Используйте unitText, чтобы указать единицу измерения, например, L/100 км.
  • Примечание 2: Существует два способа указания расхода топлива, fuelConsumption (например, 8 литров на 100 км) и fuelEfficiency (например, 30 миль на галлон). Они взаимосвязаны.
  • Примечание 3: Часто абсолютное значение полезно только в связи с скоростью движения ("на 80 км/ч") или режимом использования ("городское движение"). Вы можете использовать valueReference, чтобы связать значение расхода топлива с другим значением.
fuelEfficiency Vehicle Расстояние, пройденное на единицу использованного топлива; чаще всего в милях на галлон (mpg) или километрах на литр (km/L).

  • Примечание 1: К сожалению, нет стандартных кодов единиц для миль на галлон или километров на литр. Используйте unitText, чтобы указать единицу измерения, например, mpg или km/L.
  • Примечание 2: Существует два способа указания расхода топлива, fuelConsumption (например, 8 литров на 100 км) и fuelEfficiency (например, 30 миль на галлон). Они взаимно обратны.
  • Примечание 3: Часто абсолютное значение полезно только в связи с скоростью движения ("на 80 км/ч") или схемой использования ("городское движение"). Вы можете использовать valueReference, чтобы связать значение экономии топлива с другим значением.
handlingTime ShippingDeliveryTime Типичное время задержки между получением заказа и отправкой товаров со склада или их подготовкой к самовывозу, если способ доставки — самовывоз. Типичные свойства: minValue, maxValue, unitCode (d для ДНЯ). По общему соглашению это предполагается как рабочие дни (если используется unitCode, закодированный как "d"), т.е. учитываются только дни, когда бизнес обычно работает.
hasMeasurement SizeSpecification, Product, Offer, Certification Измерение предмета. Например, длина внутреннего шва брюк, размер колеса велосипеда, диаметр винта или углеродный след, измеренный для сертификации органом власти. Обычно это точное измерение, но также может быть диапазон измерений для регулируемых продуктов, например, ремней и креплений для лыж.
height Product, MediaObject, OfferShippingDetails, Person, VisualArtwork Высота предмета.
intensity ExercisePlan Количественная мера, оценивающая степень силы, вовлеченной в упражнение, например, количество сердечных сокращений в минуту. Может включать скорость движения.
interestRate FinancialProduct Процентная ставка, взимаемая или выплачиваемая, применимая к финансовому продукту. Примечание: это отличается от рассчитанной годовой процентной ставки.
inventoryLevel SomeProducts, Offer, Demand Текущий приблизительный уровень запасов для товара или товаров.
leaseLength Accommodation, Offer, RealEstateListing Длина аренды для некоторого жилища, либо специфичная для какого-то предложения, либо в некоторых случаях присущая самой собственности.
loanTerm LoanOrCredit Срок кредита или кредитного соглашения.
marginOfError Observation Свойство marginOfError для Observation.
materialExtent CreativeWork Количество описываемых материалов или выражение физического пространства, которое они занимают.
membershipPointsEarned ProgramMembership, PriceSpecification, MemberProgramTier Количество баллов членства, заработанных участником. При необходимости можно использовать unitText для указания единиц, в которых начисляются баллы. (Например, звезды, мили и т.д.)
mileageFromOdometer Vehicle Общее расстояние, пройденное данным транспортным средством с момента его первоначального производства, по показаниям его одометра.

Типичные коды единиц: KMT для километров, SMI для статутных миль.
molecularWeight MolecularEntity Это молекулярный вес описываемой сущности, а не родительского элемента. Единицы должны быть указаны в формате '<Число> <единица>', например '12 amu' или в виде ''.
monoisotopicMolecularWeight MolecularEntity Моноизотопная масса — это сумма масс атомов в молекуле с использованием не связанной, основной, остаточной массы главного (наиболее распространенного) изотопа для каждого элемента вместо изотопного среднего значения. Пожалуйста, указывайте единицы в формате '<Число> <единица>', например '770.230488 г/моль' или как ''.
numAdults LodgingReservation Количество взрослых, проживающих в единице.
numChildren LodgingReservation Количество детей, проживающих в помещении.
numberOfAccommodationUnits FloorPlan, ApartmentComplex Указывает общее (доступное плюс недоступное) количество жилых единиц в ApartmentComplex, или количество жилых единиц для конкретного FloorPlan (в пределах его конкретного ApartmentComplex). См. также numberOfAvailableAccommodationUnits.
numberOfAvailableAccommodationUnits FloorPlan, ApartmentComplex Указывает количество доступных единиц размещения в ApartmentComplex, или количество единиц размещения для конкретного FloorPlan (в рамках его конкретного ApartmentComplex). См. также numberOfAccommodationUnits.
numberOfAxles Vehicle Количество осей.

Типичный код единицы измерения: C62.
numberOfBedrooms FloorPlan, ApartmentComplex, Accommodation Общее целое число спален в каком-либо Accommodation, ApartmentComplex или FloorPlan.
numberOfDoors Vehicle Количество дверей.

Типичный код единицы измерения: C62.
numberOfEmployees Organization, BusinessAudience Количество сотрудников в организации, например, в бизнесе.
numberOfForwardGears Vehicle Общее количество передних передач, доступных для трансмиссионной системы транспортного средства.

Типичный код единицы измерения: C62.
numberOfPlayers VideoGameSeries, Game Укажите, сколько людей могут играть в эту игру (минимум, максимум или диапазон).
numberOfPreviousOwners Vehicle Количество владельцев транспортного средства, включая текущего.

Типичный код единицы измерения: C62.
numberOfRooms Apartment, Accommodation, FloorPlan, House, LodgingBusiness, SingleFamilyResidence, Suite Количество комнат (исключая ванные комнаты и кладовые) в жилье или гостиничном бизнесе. Типичные коды единиц: ROM для комнаты или C62 для отсутствия единицы. Тип комнаты можно указать в свойстве unitText объекта QuantitativeValue.
occupancy Suite, SingleFamilyResidence, HotelRoom, Apartment, Accommodation Разрешенная общая вместимость для размещения в количестве человек (включая младенцев и т. д.). Для отдельных мест размещения это не обязательно законный максимум, но определяет разрешенное использование в соответствии с договорным соглашением (например, двухместный номер, используемый одним человеком). Типичный код единицы: C62 для человека.
partySize TaxiReservation, FoodEstablishmentReservation Количество людей, на которое должна быть сделана резервация.
payload Vehicle Допустимый вес пассажиров и грузов, ИСКЛЮЧАЯ вес пустого транспортного средства.

Типичный код единицы измерения: KGM для килограмма, LBR для фунта

  • Примечание 1: Многие базы данных указывают разрешенный ОБЩИЙ вес, который является суммой веса и полезной нагрузки
  • Примечание 2: Вы можете указать дополнительную информацию в имени узла QuantitativeValue.
  • Примечание 3: Вы также можете связать с узлом QualitativeValue, который предоставляет дополнительную информацию, используя valueReference.
  • Примечание 4: Обратите внимание, что вы можете использовать minValue и maxValue для указания диапазонов.
recipeYield Recipe Количество, производимое рецептом (например, количество порций, количество людей, которых можно накормить и т.д.).
referenceQuantity UnitPriceSpecification Справочное количество, к которому применяется определенная цена, например, 1 EUR за 4 кВтч электроэнергии. Это свойство является заменой unitOfMeasurement для сложных случаев, когда цена не связана со стандартной единицей.
repetitions ExercisePlan Количество раз, которое следует повторить действие.
requiredQuantity HowToItem Необходимое количество товара(ов).
restPeriods ExercisePlan Как часто следует делать перерывы в деятельности.
roofLoad Car, BusOrCoach Разрешенный общий вес грузов и установок (например, багажника на крыше) на верхней части транспортного средства.

Типичные коды единиц: KGM для килограмма, LBR для фунта

  • Примечание 1: Вы можете указать дополнительную информацию в name узла QuantitativeValue.
  • Примечание 2: Вы также можете связать с узлом QualitativeValue, который предоставляет дополнительную информацию, используя valueReference.
  • Примечание 3: Обратите внимание, что вы можете использовать minValue и maxValue для указания диапазонов.
seatingCapacity Vehicle Количество человек, которые могут быть размещены (например, в транспортном средстве), как с точки зрения физического пространства, так и с точки зрения ограничений, установленных законом.

Типичный код единицы: C62 для человек.
size Product, CreativeWork Стандартизированный размер продукта или творческой работы, указанный либо через простую текстовую строку (например, 'XL', '32Wx34L'), либо через QuantitativeValue с unitCode, либо через полное и структурированное SizeSpecification; в других случаях свойства width, height, depth и weight могут быть более применимыми.
speed Vehicle Диапазон скорости транспортного средства. Если транспортное средство приводится в движение двигателем, верхний предел диапазона скорости (указанный с помощью maxValue) должен быть максимальной скоростью, достигаемой в обычных условиях.

Типичные коды единиц: KMH для км/ч, HM для миль в час (0.447 04 м/с), KNT для узла

*Примечание 1: Используйте minValue и maxValue, чтобы указать диапазон. Обычно минимальное значение равно нулю. * Примечание 2: Существует множество различных способов измерения диапазона скорости. Вы можете ссылаться на информацию о том, как было определено данное значение, используя свойство valueReference.
stupidProperty Vehicle Это глупое свойство! - только для тестирования.
suggestedAge SizeSpecification, PeopleAudience Возраст или возрастной диапазон для предполагаемой аудитории или человека, например, 3-12 месяцев для младенцев, 1-5 лет для малышей.
suggestedMeasurement SizeSpecification, PeopleAudience Рекомендуемый диапазон размеров тела для целевой аудитории или человека, например, длина внутреннего шва от 32 до 34 дюймов или рост от 170 до 190 см. Обычно встречается на таблицах размеров для носимых товаров.
tongueWeight Vehicle Допустимая вертикальная нагрузка (TWR) прицепа, прикрепленного к транспортному средству. Также называется рейтингом нагрузки на сцепное устройство (TLR) или рейтингом вертикальной нагрузки (VLR).

Типичный код единиц: KGM для килограмма, LBR для фунта

  • Примечание 1: Вы можете указать дополнительную информацию в name узла QuantitativeValue.
  • Примечание 2: Вы также можете связать узел QualitativeValue, который предоставляет дополнительную информацию, используя valueReference.
  • Примечание 3: Обратите внимание, что вы можете использовать minValue и maxValue для указания диапазонов.
torque EngineSpecification Крутящий момент (вращающая сила) двигателя автомобиля.

Типичный код единицы измерения: NU для ньютон-метра (N m), F17 для фунт-силы на фут, или F48 для фунт-силы на дюйм

  • Примечание 1: Вы можете ссылаться на информацию о том, как было определено данное значение (например, ссылка на об/мин), используя свойство valueReference.
  • Примечание 2: Вы можете использовать minValue и maxValue, чтобы указать диапазоны.
trailerWeight Vehicle Допустимый вес прицепа, прикрепленного к транспортному средству.

Типичный код единицы измерения: KGM для килограмма, LBR для фунта * Примечание 1: Вы можете указать дополнительную информацию в name узла QuantitativeValue. * Примечание 2: Вы также можете связать с узлом QualitativeValue, который предоставляет дополнительную информацию, используя valueReference. * Примечание 3: Обратите внимание, что вы можете использовать minValue и maxValue для указания диапазонов.
transitTime ShippingDeliveryTime Типичное время задержки между отправкой заказа на доставку и его достижением конечного клиента. Типичные свойства: minValue, maxValue, unitCode (d для ДЕНЬ).
valueReference QuantitativeValue, QualitativeValue, PropertyValue Вторичное значение, которое предоставляет дополнительную информацию об исходном значении, например, справочная температура или тип измерения.
vehicleSeatingCapacity Vehicle Количество пассажиров, которые могут быть размещены в транспортном средстве, как с точки зрения доступного физического пространства, так и с точки зрения ограничений, установленных законом.

Типичный код единицы: C62 для лиц.
weight Product, Person, OfferShippingDetails Вес продукта или человека.
weightTotal Vehicle Разрешенный общий вес загруженного транспортного средства, включая пассажиров и груз, а также вес пустого транспортного средства.

Типичный код единицы: KGM для килограмма, LBR для фунта

  • Примечание 1: Вы можете указать дополнительную информацию в name узла QuantitativeValue.
  • Примечание 2: Вы также можете связать узел QualitativeValue, который предоставляет дополнительную информацию, используя valueReference.
  • Примечание 3: Обратите внимание, что вы можете использовать minValue и maxValue для указания диапазонов.
wheelbase Vehicle Расстояние между центрами передних и задних колес.

Типичные коды единиц измерения: CMT для сантиметров, MTR для метров, INH для дюймов, FOT для футов.
width VisualArtwork, Product, OfferShippingDetails, MediaObject Ширина элемента.
workload ExercisePlan Количественная мера физиологического выхода от физической нагрузки; также известна как энергетические затраты.
yearlyRevenue BusinessAudience Размер бизнеса по годовому доходу.
yearsInOperation BusinessAudience Возраст бизнеса.
yield HowTo Количество, которое получается в результате выполнения инструкций. Например, бумажный самолетик, 10 персонализированных свечей.

Более специфичные типы

Благодарности

Классы словаря GoodRelations

Этот класс основан на словаре GoodRelations для электронной коммерции, созданном Мартином Хеппом. GoodRelations — это модель данных для обмена данными электронной коммерции в Интернете, которая может быть выражена в различных синтаксисах, включая RDFa и HTML5 Microdata. Более подробную информацию о GoodRelations можно найти по адресу http://purl.org/goodrelations/.
Автор: Семён Авдосов [schema.su]
Дата публикации: 16.11.2024
Дата обновления: 20.11.2024
Комментарии
Новые материалы на сайте