Общие требования к передаче данных
# Общие требования к передаче данных
- Формат передачи данныхКодировка
- Заголовок
- Корневой элемент
- Формат даты
- Требования к фиду и объявлениям в немОсновные требования
- Актуальность
- Сроки публикации
- Цена объекта
- Требования к объявлениям по типам недвижимости
Чтобы объявления попали в базу сервиса Яндекс Недвижимость, подготовьте фид с данными по приведенным ниже требованиям.
## Формат передачи данных
Фид с объявлениями для Яндекс Недвижимости составляется на языке YRL (Yandex Realty Language), разработанном в Яндексе. YRL основан на стандарте XML (Extensible Markup Language).
Ограничения:
Нельзя использовать первые 32 ASCII‑символа в текстовых полях.
Исключения: табуляция, перевод строки, возврат каретки.
Необходимо кодировать определенные символы:
Таблица замены символов в YRL‑файле
**Символ, который нужно заменить**
**Код для YRL‑файла**
"
"
&
&
>
<
<
'
'
<br>
<br>
### Кодировка
Кодировка фида — UTF‑8.
### Заголовок
YRL‑документ должен начинаться со стандартного XML‑заголовка — нулевого символа первой строки:
<?xml version="1.0" encoding="utf-8"?>
### Корневой элемент
Корневой элемент YRL‑фида — <realty-feed>. Он должен содержать элементы <offer>, в каждом из которых — информация из одного объявления. Для удобства можно добавить элемент <generation-date> с датой создания фида.
Чтобы указать пространство имен, используйте атрибут xmlns:
<realty-feed xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06">
<generation-date>2010-10-05T16:36:00+04:00</generation-date>
<offer>
...
</offer>
...
</realty-feed>
### Формат даты
Все даты и время указывайте по стандарту ISO 8601 — в формате YYYY-MM-DDTHH:mm:ss+00:00, где:
- YYYY — год;
- MM — месяц;
- DD — день;
- HH — час;
- mm — минута;
- ss — секунда;
- +00:00 — указание часового пояса (для Москвы — +03:00).
## Требования к фиду и объявлениям в нем
### Основные требования
Размещение и доступ:
- фид размещен на вашем домене;
- предоставлен в виде URL‑ссылки;
- доступ к фиду постоянно открыт по протоколу HTTP;
- фид доступен круглосуточно.
Формат и структура:
- структура фида соответствует формату YRL;
- фид содержит только валидные объявления (все поля заполнены согласно формату YRL);
- в фиде передются только те параметры, которые указаны в объявлении;
- для нескольких значений одного параметра (например, фотографий) используется несколько одинаковых тегов.
Содержание:
- каждое объявление посвящено одному объекту недвижимости;
- каждое объявление уникально;
- в объявлениях от агентств недвижимости явно указано агентство.
Оформление текстов:
- для оформления текстов объявлений и характеристик объектов разрешено истользовать только тег <br>, при этом символы < и > следует кодировать соответственно таблице замены символов в YRL‑файле;
- другие HTML-теги не поддерживаются.
Обновление:
- чтобы изменить объявление, обновите текущее — не удаляйте его и не создавайте дубликат;
- обновленное объявление должно иметь тот же internal‑id.
### Актуальность
Фид должен содержать актуальные объявления — с достоверной информацией о реальном объекте, доступном для покупки или аренды.
Минимальные доли актуальных объявлений:
- 80 % — для объявлений о продаже недвижимости;
- 70 % — для объявлений об аренде недвижимости.
Объявление считается неактуальным, если:
- объект уже продан или сдан в аренду;
- по указанному телефонному номеру невозможно дозвониться;
- цена в объявлении существенно отличается от запрашиваемой;
- не совпадает адрес или другие параметры.
### Сроки публикации
Для разных типов объявлений действуют свои ограничения по срокам создания и обновления:
**Тип объявления**
**Min с момента создания**
**Min с момента обновления**
О продаже квартиры на вторичном рынке
90 дней
45 дней
О продаже комнаты
120 дней
45 дней
О длительной аренде квартиры
7 дней
14 дней
О длительной аренде комнаты
25 дней
24 дня
О длительной аренде дома
30 дней
30 дней
О продаже гаража или машиноместа
90 дней
45 дней
О длительной аренде гаража
30 дней
30 дней
О продаже домов, участков и квартир в новостройках, а также о посуточной аренде домов и квартир
Не влияет на валидность объявления
### Цена объекта
- Цена объекта должна быть выше минимальной цены в соответствующем сегменте в регионе.
- Яндекс Недвижимость вычисляет диапазон цен на объекты разной площади:
отдельно для продажи;
- отдельно для аренды.
- Учитываются различные факторы: привлекательность района, транспортная доступность, социальная инфраструктура.
## Требования к объявлениям по типам недвижимости
Подробные описания обязательных и необязательных элементов фида для разных типов недвижимости, особенности значений и их использования описаны отдельно.
См. в разделах:
- Технические требования к XML-фиду для жилой недвижимости
- Технические требования к XML-фиду для коммерческой недвижимости
- Технические требования к XML-фиду для новостроек
### Была ли статья полезна?
ДаНетyandex.ru
Общие требования к передаче данных
Текущая редакция от .