Page tree
Skip to end of metadata
Go to start of metadata

Отраслевой алгоритм "Недвижимость" предназначен для товарных рекомендаций в области недвижимости. Основные отличия:

  1. Учитывает характеристики объектов (площадь, этаж).
  2. Учитывает тип сделки (продажа, аренда).
  3. Учитывает тип недвижимости (жилая, коммерческая).

Передача дополнительных параметров

Для работы алгоритма вам необходимо передавать дополнительные параметры об объектах:

  • площадь;
  • тип;
  • вид сделки.

Данные для алгоритма необходимо передавать в YML-файле с товарами.

Особенность цены <price> объекта

В качестве цены объекта указывается стоимость за 1 квадратный метр.

География

Географические привязки объектов указываются с помощью секции <locations>, описанной в основном документе о YML-файле. В записи <location> не нужно указывать цену объекта.

Секция <realty>

Отличительным признаком объекта недвижимости является наличие секции <realty> внутри секции <offer>.

Площадь объекта (<space>)

Параметр <space> размещается внутри секции <realty> внутри <offer> и включает минимальное, максимальное или точное значение площади объекта. Площадь всегда указывается в квадратных метрах, даже если это земельный участок в 30 га.

 

Пример YML
 ...
<offer ...>
    ...
	<realty>
	    <space>
			<!-- Можно указывать минимальную и максимальную площадь для группы объектов или точную площадь для конкретного объекта -->
			<min>30</min>
			<max>100</max>
			<final>37</final>
		</space>
	</realty>
</offer>
...

Этаж <floor>

Необязательный параметр <floor> указывает этаж и этажность объекта. Размещается внутри секции <realty> внутри <offer>.

Пример YML
 ...
<offer ...>
    ...
	<realty>
	    <floor>
			<!-- Этаж, на котором находится объект -->
			<current>3</current>
			<!-- Всего этажей в здании -->
			<total>12</total>
		</floor>
	</realty>
</offer>
...

Тип сделки <action>

Обязательный параметр <action>.  Размещается внутри секции <realty> внутри <offer>.

Значение параметраРасшифровка
rentОбъект в аренду
sale

Объект на продажу

Если один и тот же объект и продается и сдается в аренду, в YML должно быть два объекта <offer> с разными ID.

Пример YML
 ...
<offer ...>
    ...
	<realty>
	    ...
		<action>sale</action>
	</realty>
</offer>
...

Тип недвижимости <type>

Обязательный параметр <type> размещается внутри секции <realty> внутри <offer> и содержит тип недвижимости:

Значение параметраРасшифровка
livingЖилое помещение
office

Офис

warehouseСкладское помещение
landЗемельный участок
shopМагазин
manufacturingПроизводство
cafeКафе, рестораны
customСвободное назначение

Внутри самого тега может находиться атрибут specific, содержащий строковый код подтипа в системе наименований магазина (например, "coworking" для офиса, "apartment" для квартиры или "cottage" для загородного дома). Названия можно использовать произвольные, но объекты одного подтипа должны должны содержать одинаковое значение типа и подтипа.

Пример YML
 ...
<offer ...>
    ...
	<realty>
	    <type specific="coworking">office</type>
	</realty>
</offer>
...