Описание элементов, обрабатываемых Яндексом

Обязательные элементы

Чтобы карточка организации корректно обрабатывалась Яндексом, она должна строго соответствовать формату hCard. В частности, корневым элементом карточки должен быть элемент класса vcard. Остальные элементы (называемые свойствами) располагаются внутри корневого.

Подробные сведения о том, какие фрагменты HTML-кода рассматриваются как значения свойств, приведены в разделе Правила обработки разметки.

Кроме того, чтобы карточка могла быть загружена в базу данных Яндекс Бизнеса, она обязательно должна содержать следующие свойства:

fn и org

adr

tel

fn и org

Название организации.

Согласно стандарту hCard, для карточек, описывающих организации, значения свойств fn и org должны совпадать между собой. Рекомендуется пометить название организации сразу двумя этими классами в одном элементе:

<span class="fn org">...</span>

adr

Адрес организации.

Адрес должен быть достаточно подробным, чтобы его можно было найти на карте. Обратите внимание, что карточки обрабатываются только для четырех стран: Россия, Украина, Беларусь, Казахстан

Для элемента класса adr будут обработаны следующие вложенные свойства (каждое из них может быть указано не более одного раза):

  • country-name — страна;

  • region — субъект федерации + район;

  • locality — населенный пункт;

  • street-address — улица, дом, корпус, строение и т. п. (то есть адрес с точностью до здания);

  • extended-address — здесь можно указать подъезд, этаж, офис и т. п. (то есть сведения о местонахождении внутри здания), название торгового или бизнес-центра, а также любое описание, не являющееся точным адресом;

  • postal-code — почтовый индекс.

Для правильного распознавания адреса необходимо указание населенного пункта (свойство locality). Если название не определяет населенный пункт однозначно (например, деревня Дубки), требуется также указание региона (свойство region).

Примечание

Мы рекомендуем размечать только фактические (как вас найти), а не юридические адреса.

Карточка может содержать несколько адресов. Это возможно в случае, если организация имеет несколько отделений или филиалов, которые называются одинаково и имеют идентичные контактные данные (общий сайт, единый call-центр и т.п.). Если же филиалы имеют различные названия, телефоны, email-адреса, мы рекомендуем создать отдельную карточку (элемент класса vcard) для каждого филиала.

tel

Номер телефона (с кодом города).

Предпочтительный формат: +{код страны} ({код города}) {номер}, например: +7 (890) 123-45-67, +375 (12) 345-67-89. Если для пользователей необходимо отображать номер телефона в другом формате, можно использовать элемент <abbr>.

В одной карточке можно указать несколько телефонных номеров.

Пример:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div class="tel">Телефон: 
    <abbr class="value" title="+ 7 (890) 123-45-67">123-45-67</abbr>
  </div>
  <div class="tel">
    <abbr class="type" title="fax">Факс:</abbr> 
    <abbr class="value" title="+ 7 (890) 123-45-89">123-45-89</abbr>
  </div>
</div>

Примеры карточек, содержащих минимально необходимую информацию

<div class="vcard">
  <div>Кафе <span class="fn org">Ромашка</span></div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div class="tel">Телефон: 
    <abbr class="value" title="+ 7 (890) 123-45-67">123-45-67</abbr>
  </div>
</div>

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="postal-code">111222</span>,
    <span class="country-name">Россия</span>,
    <span class="region">Абрикосовский край</span>,
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>,
    <span class="extended-address">эт. 7, оф. 701</span>
    <div class="tel">Телефон: 
      <abbr class="value" title="+ 7 (890) 123-45-67">123-45-67</abbr>
    </div>
  </div>
</div>

Поддерживаемые элементы

Кроме обязательных свойств fn и org, adr, tel, Яндекс обрабатывает следующие свойства:

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

category

email

geo

url

workhours

category

Род деятельности организации.

Наличие этого свойства облегчает отнесение организации к той или иной рубрике Яндекс Бизнеса и тем самым помогает ускорить обработку карточки сервисом. Поэтому, если в блоке с контактной информацией допустимо указать род деятельности вашей организации, оформите его с помощью свойства category.

В одной карточке можно указать несколько категорий, например:

<div class="vcard">
  <div>
    <span class="category">Кафе</span>-<span class="category">кулинария</span>
    <span class="fn org">Ромашка</span>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <span class="url">
    <span class="value-title" title="http://www.cafe.com"> </span>
  </span>
</div>

Вы также можете добавить в карточку свойство category, невидимое для посетителей сайта, например c помощью вложенного элемента класса value-title с атрибутом title:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <span class="category">
    <span class="value-title" title="кафе"> </span>
  </span>
</div>

Подробные сведения о том, какие фрагменты HTML-кода рассматриваются как значения свойств, приведены в разделе Правила обработки разметки.

email

Электронный адрес.

В одной карточке можно указать несколько электронных адресов.

Электронный адрес можно отображать как простой текст или как ссылку.

Примеры:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div class="email">cafe@cafe.com</div>
</div>

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.romashka-cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div>Электронная почта:
    <a class="email" href="mailto:cafe@cafe.com">
      romashka@romashka-cafe.ru
    </a>
  </div>
  <div>По вопросам трудоустройства:
    <a class="email" href="mailto:hr@cafe.com">
      hr@romashka-cafe.ru
    </a>
  </div>
  <div>По вопросам закупок:
    <a class="email" href="mailto:buy@cafe.com">
      buy@romashka-cafe.ru
    </a>
  </div>
</div>

Подробные сведения о том, какие фрагменты HTML-кода рассматриваются как значения свойств, приведены в разделе Правила обработки разметки.

geo

Географические координаты, соответствующие адресу. Указываются в градусах.

Если у вас есть эта информация, рекомендуем включить ее в карточку, поскольку она облегчает геокодирование вашего местоположения.

В карточке может быть не более одного элемента класса geo.

Для данного свойства необходимо задать вложенные свойства:

  • latitude — широта;

  • longitude — долгота.

Координаты обычно делают невидимыми для посетителей сайта, например с помощью вложенного элемента класса value-title с атрибутом title:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <span class="geo">
    <span class="latitude">
      <span class="value-title" title="55.792188"> </span>
    </span>
    <span class="longitude">
      <span class="value-title" title="37.764956"> </span>
    </span>
  </span>
</div>

Если же необходимо показывать координаты на странице, их целесообразно указать в градусах, минутах и секундах:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div class="geo">
   <abbr class="latitude" title="55.792188">Широта: 55°47&#8242;31.88&#8243; с. ш.</abbr> 
   <abbr class="longitude" title="37.764956">Долгота: 37°45&#8242;53.84&#8243; в. д.</abbr>
  </div>
</div>

Подробные сведения о том, какие фрагменты HTML-кода рассматриваются как значения свойств, приведены в разделе Правила обработки разметки.

url

Ссылка на официальный сайт организации.

Предпочтительно, ссылка должна вести на главную страницу сайта (или на страницу филиала, если карточка содержит информацию о филиале). Например, карточка находится на странице http://www.romashka-cafe.ru/contacts.html, а значение свойства url — http://www.romashka-cafe.ru.

Стандарт hCard допускает наличие нескольких элементов класса url, однако при добавлении карточки в Яндекс Бизнесе будет выбран только один из них, наиболее подходящий.

Если вы отображаете адрес сайта в блоке с контактной информацией, то класс url можно присвоить элементу <a>:

<a class="url" href="...">...</a>

Если же ваша контактная информация не содержит URL, вы можете сделать свойство url невидимым для посетителей сайта с помощью следующей конструкции:

<span class="url"><span class="value-title" title="..."> </span></span>

Подробные сведения о том, какие фрагменты HTML-кода рассматриваются как значения свойств, приведены в разделе Правила обработки разметки.

workhours

Время работы организации.

Свойство не предусмотрено стандартом hCard, оно добавлено Яндексом в качестве расширения.

Для указания времени работы мы рекомендуем формат, используемый в Яндекс Бизнесе, например:

  • пн. — пт. 9:00–18:00

  • пн. — пт. 9:00–18:00, обед 13:00–14:00, сб — вс 10:00–17:00, обед 13:30–14:00

  • пн. — сб. 11:00–20:00, вс 12:00–24:00

  • ежедн. 10:00–24:00

  • круглосуточно

Допустимо указывать время работы в произвольном формате.

Пример:

<div class="vcard">
  <div>
    <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  </div>
  <div class="adr">
    <span class="locality">г. Солнечный</span>,
    <span class="street-address">просп. Романтиков, д. 21</span>
  </div>
  <div>
    Мы работаем <span class="workhours">ежедневно с 11:00 до 24:00</span>
  </div>
</div>

Прочие элементы

Остальные свойства, предусмотренные форматом hCard, в настоящее время игнорируются Яндексом. Однако вы можете включить их в карточку организации, если хотите сделать эти данные доступными другим сервисам. Например, если ваша контактная информация содержит логотип организации, используйте свойство logo.

Полный список свойств представлен в официальной спецификации формата, в разделе Property List.

Задайте вопрос Нейровебмастеру — в правом нижнем углу нажмите кнопку .

Если у вас остались вопросы:

  • Напишите в чат службы поддержки — в правом нижнем углу нажмите значок . Чат доступен ежедневно с 8:00 до 20:00 по московскому времени.

  • Заполните форму обратной связи ниже.

Написать в службу поддержки

Чтобы ваш вопрос быстрее попал к нужному специалисту, уточните тему:

Ошибка в валидаторе микроразметки

Подробное описание возможных ошибок см. в разделе Валидатор микроразметки.

Как часто формируется разметка

Разметка формируется в течение двух недель. Если Яндекс не поддерживает какой-то из видов разметки на странице или в разметке ошибки, то просто пропускает ее.

Не нашлось подходящей разметки

Робот Яндекса сможет проиндексировать информацию с сайта и без разметки, на показ страниц в поиске это не повлияет. Чтобы задать желаемое описание страницы в результатах поиска, используйте метатег description.

Ошибка в валидаторе микроразметки

Подробное описание возможных ошибок см. в разделе Валидатор микроразметки.

Не удалось исправить ошибку
Другой вопрос о партнерской программе или разметке



Также вы можете перейти на сервис

Предыдущая
Микроформат hCard
Следующая
Правила обработки разметки