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

TravelAction

Тип schema.org ?

Описание:

Акт путешествия от места отправления до пункта назначения с использованием определенного способа транспорта, возможно, с участниками.

Что такое TravelAction и зачем он нужен?

Тип TravelAction из словаря Schema.org — это удобный инструмент для описания процесса путешествия. Если вы работаете с данными о перемещениях, будь то сайты туристических агентств, транспортные компании или платформы для бронирования, этот тип поможет сделать информацию более структурированной и понятной.

Для чего используется TravelAction?

Проще говоря, TravelAction описывает, как кто-то (или что-то) перемещается из одного места в другое. Это может быть полёт на самолёте, поездка на автомобиле или даже прогулка пешком. Основная задача — предоставить чёткую информацию о маршруте, расстоянии и других деталях путешествия.

Пример использования:

{
  "@context": "https://schema.org",
  "@type": "TravelAction",
  "agent": {
    "@type": "Person",
    "name": "Анна"
  },
  "fromLocation": {
    "@type": "Place",
    "name": "Москва"
  },
  "toLocation": {
    "@type": "Place",
    "name": "Санкт-Петербург"
  },
  "distance": {
    "@type": "Distance",
    "name": "650 км"
  }
}

В этом примере мы видим, что Анна едет из Москвы в Санкт-Петербург, преодолевая расстояние в 650 км. Если нужно указать способ передвижения, его можно добавить через свойство description или связать с типом Vehicle.

Почему это важно?

  1. Для пользователей
    Люди, планирующие путешествие, хотят знать все детали заранее: откуда, куда, как и сколько времени займёт дорога. TravelAction помогает собрать эту информацию в одном месте и сделать её доступной.

  2. Для бизнеса
    Туристические агентства, авиакомпании и сервисы бронирования могут использовать этот тип, чтобы улучшить видимость своих предложений в интернете. Поисковики, такие как Google, умеют "читать" эту разметку и показывать её пользователям в результатах поиска.

  3. Для аналитики
    Системы, работающие с большими данными, могут использовать TravelAction для анализа маршрутов, популярных направлений и даже предпочтений пользователей.

Какие свойства можно указать?

TravelAction предлагает несколько ключевых параметров:

  • fromLocation: Место отправления.
  • toLocation: Место назначения.
  • distance: Расстояние между точками (например, "650 км").
  • agent: Участник путешествия (человек или организация).
  • description: Дополнительное описание, где можно указать способ передвижения (например, "поезд").

Эти свойства позволяют создать подробное описание перемещения, которое будет полезно как людям, так и машинам.

Когда использовать TravelAction?

Если ваш сайт или платформа связана с путешествиями, обязательно используйте TravelAction, если:

  • Вы предоставляете информацию о маршрутах.
  • Хотите улучшить SEO для контента о путешествиях.
  • Работаете с данными о транспорте или логистике.

Например:

  • Туристический портал с описанием маршрутов.
  • Сервис для бронирования билетов.
  • Приложение для планирования поездок.

Зачем это нужно бизнесу?

Представьте, что вы владелец туристического агентства. Если вы добавите разметку TravelAction на страницы с описанием туров, поисковые системы смогут лучше понять и показывать ваш контент. Это привлечёт больше клиентов и сделает вашу информацию более доступной.

Заключение

Тип TravelAction — это мощный инструмент для описания путешествий. Он помогает сделать данные о маршрутах и расстояниях более структурированными и понятными. Если вы хотите, чтобы ваш контент был легко найден и правильно интерпретирован, не игнорируйте этот тип. Ведь даже маленькие детали могут сделать ваше предложение более привлекательным для клиентов!

Свойство Ожидаемый тип Описание
Свойство из TravelAction
distance Distance Дистанция, пройденная, например, во время тренировки или путешествия.
Свойство из MoveAction
fromLocation Place Субсвойство местоположения. Исходное местоположение объекта или агента до действия.
toLocation Place Субсвойство местоположения. Конечное местоположение объекта или агента после действия.
Свойство из Action
actionStatus ActionStatusType Указывает текущее состояние Действия.
agent Organization, Person Непосредственный исполнитель или движущая сила действия (живое или неживое). Например, Джон написал книгу.
endTime DateTime, Time Время окончания чего-либо. Для зарезервированного события или услуги (например, FoodEstablishmentReservation) — время, когда ожидается его завершение. Для действий, которые занимают определенный период времени, это время выполнения действия. Например, Джон писал книгу с января по декабрь. Для медиа, включая аудио и видео, это временной смещение конца клипа в рамках более крупного файла.

Обратите внимание, что событие использует startDate/endDate вместо startTime/endTime, даже когда описываются даты с указанием времени. Эта ситуация может быть уточнена в будущих редакциях.
error Thing Для неудачных действий, дополнительная информация о причине неудачи.
instrument Thing Объект, который помог агенту выполнить действие. Например, Джон написал книгу с помощью ручки.
location VirtualLocation, Text, PostalAddress, Place Место, например, где проходит событие, где расположена организация или где происходит действие.
object Thing Объект, над которым выполняется действие, состояние которого остается неизменным или изменяется. Также известен как семантические роли пациент, затронутый или подвергающийся (которые изменяют свое состояние) или тема (которая не изменяет своего состояния). Например, Джон прочитал книгу.
participant Organization, Person Другие соучастники, которые косвенно участвовали в действии. Например, Джон написал книгу с Стивом.
provider Organization, Person Поставщик услуг, оператор услуг или исполнитель услуг; производитель товаров. Другая сторона (продавец) может предлагать эти услуги или товары от имени поставщика. Поставщик также может выступать в качестве продавца.
result Thing Результат, полученный в результате действия. Например, Джон написал книгу.
startTime DateTime, Time Время начала чего-либо. Для зарезервированного события или услуги (например, FoodEstablishmentReservation) это время, когда ожидается его начало. Для действий, которые занимают определенный период времени, это время, когда действие было выполнено. Например, Джон писал книгу с января по декабрь. Для медиа, включая аудио и видео, это временной смещение начала клипа в рамках большего файла.

Обратите внимание, что событие использует startDate/endDate вместо startTime/endTime, даже при описании дат с указанием времени. Эта ситуация может быть уточнена в будущих редакциях.
target EntryPoint, URL Указывает целевую точку входа (EntryPoint) или URL для действия (Action).
Свойство из 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 предмета.

Примеры

Пример 1

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


John travel to Brazil.

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


<!--  John travel to Brazil. -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TravelAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "toLocation": {
    "@type": "Country",
    "name": "Brazil"
  }
}
</script>

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

@context
https://schema.org
@type
TravelAction
agent
@type
Person
name
John
toLocation
@type
Country
name
Brazil

Пример 2

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


John travel from the US to Brazil with Steve.

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


<!--  John travel from the US to Brazil with Steve.-->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TravelAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "fromLocation": {
    "@type": "Country",
    "name": "USA"
  },
  "toLocation": {
    "@type": "Country",
    "name": "Brazil"
  },
  "participant": {
    "@type": "Person",
    "name": "Steve"
  }
}
</script>

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

@context
https://schema.org
@type
TravelAction
agent
@type
Person
name
John
fromLocation
@type
Country
name
USA
toLocation
@type
Country
name
Brazil
participant
@type
Person
name
Steve
Автор: Семён Авдосов [schema.su]
Дата публикации: 16.11.2024
Дата обновления: 02.04.2025
Комментарии
Новые материалы на сайте