Символ | Маскирование | |
---|---|---|
Амперсанд | & | & |
Одинарные кавычки | ' | ' |
Одинарные кавычки | " | " |
Одинарные кавычки | > | > |
Одинарные кавычки | < | < |
<?xml version='1.0' encoding='UTF-8'?>
Заголовок должен начинаться с первой строки, с нулевого символа.
Документ должен содержать корневой элемент реальности realties.
В корневом элементе обязательно должен присутствовать элемент generation_date, содержащий информацию о дате и времени создания данного файла.
<?xml version="1.0" encoding="UTF-8"?> <realties xmlns="https://dom.ria.com/xml/xsd/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://dom.ria.com/xml/xsd/ https://dom.ria.com/xml/xsd/dom.xsd"> </realties>
+03:00 — указание часового пояса (в данном случае — для Киева).
Корневой элемент realties должен содержать елемент lang_id, где значение 4 - считывается как наполнение фида на украинском языке, а значение 2 - на русском. Без указания данного элемента по умолчанию считаем, что фид прописан на украинском языке. (Пример <lang_id>4</lang_id>)
<?xml version="1.0" encoding="UTF-8"?> <realties xmlns="https://dom.ria.com/xml/xsd/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://dom.ria.com/xml/xsd/ https://dom.ria.com/xml/xsd/dom.xsd"> <generation_date>2023-07-25T11:10:39+03:00</generation_date> <realty> <advert_type>Продаж</advert_type> <realty_type>Квартира</realty_type> </realty> </realties>
Название тэга | Описание | Тип | Правила и допустимые значения |
---|---|---|---|
Базовые параметры | |||
email * | Электронный адрес пользователя, от которого будет размещено объявление | Строка (string) | Для успешного импорта нужно указать один из обязательных параметров: email или phone. На сайте DIM.RIA.com должен быть зарегистрирован пользователь с таким электронным адресом или номером телефона. Этот пользователь должен быть администратором или прикреплённым сотрудником в агентстве, для которого осуществляется импорт |
phone * | Номер телефона пользователя, от которого будет размещено объявление | Строка (string) | В поле phone допускается указание только одного мобильного номера телефона в формате "+38(0XX) XXX-XX-XX" или "(0XX) XXX-XX-XX" или "0XXXXXXXXX" |
local_realty_id * | ID объявления в базе партнера (в вашей базе) | Строка (string) | Не более 10 цифр |
advert_type * | Тип операції | Строка (string) | |
realty_type * | Тип недвижимости | Строка (string) | |
realty_sale_type | Тип объекта недвижемости | Целое (integer) | Содержит значения типа объекта для объявлений. Соответствие значений: 1- Вторичная недвижимость, 2 - Новострой. Значение по умолчанию: 1. Значения допустимы для рубрики "Квартиры", "Комнаты", "Дома", "Коммерческая недвижимость" |
Фото | |||
photos_urls | Контейнер для фото | Контейнер | Минимум 5 фото |
loc | Ссылка на фото | Строка (string) | Может находится только внутри контейнера «photos_urls». В элементе «loc» указан адрес, по которому размещен файл фото. The URL must conform to RFC 2396 (http://www.ietf.org/rfc/rfc2396.txt). Может содержать атрибут «crc», в котором указывается контрольная сумма для файла фотографии. Если этот атрибут будет указан, то при последующих загрузках фида, в случае если значение контрольной суммы не изменилось, не будет происходить обращение к файлу фото. Таким образом снижается нагрузка на ресурс, на котором размещены фото. |
Видео | |||
youtube_link | Ссылка на видео | Строка (string) | Полная ссылка на видео, загруженная на Youtube. Например ("https://www.youtube.com/watch?v=MfEKUnQCypw&list=UU2DjSrXJytSfu-9Fy7A_P0A&index=89") |
Расположение | |||
state * | Название области | Строка (string) | Пример: «Винницкая», «Киевская», «Одесская» |
city * | Название города | Строка (string) | Пример: «Винница», «Киев» |
district | Район города | Строка (string) | Название района из базы DIM.RIA.com |
metro | Станция метро | Строка (string) | Название станции метро из базы DIM.RIA.com |
street | Название улицы | Строка (string) | Название улицы без ее типа |
street_type | Тип улицы | Строка (string) | «аллея», «бульвар», «въезд», «гавань», «дорога», «дуга», «майдан», «массив», «мост», «набережная», «остров», «парк», «переезд», «переулок», «плато», «площадь», «пляж», «поселок», «проезд», «проспект», «сквер», «тупик», «улица», «хутор», «шоссе», «1-й км.», «1-й въезд», «2-й въезд», «3-й въезд», «4-й въезд», «4-й проезд», «5-й проезд», «6-й проезд», «5-й въезд», «1-й тупик», «2-й тупик», «3-й тупик», «4-й тупик», «5-й тупик», «6-й тупик», «7-й тупик», «1-й переулок», «2-й переулок», «3-й переулок», «4-й переулок», «5-й переулок», «6-й переулок», «7-й переулок», «8-й переулок», «9-й переулок», «10-й переулок», «11-й переулок», «12-й переулок», «13-й переулок», «1-й проезд», «2-й проезд», «3-й проезд», «1-й проспект», «2-й проспект», «1-я линия», «2-я линия», «4-я линия», «5-я линия», «1-я улица», «2-я улица», «3-я улица», «4-я улица», «5-я улица», «6-я улица», «7-я улица», «8-я улица», «9-я улица», «10-я улица», «11-я улица», «12-я улица», «13-я улица», «14-я улица», «15-я улица», «16-я улица», «17-я улица», «18-я улица», «19-я улица», «20-я улица», «21-я улица», «22-я улица», «23-я улица», «24-я улица», «25-я улица», «26-я улица», «27-я улица», «28-я улица», «29-я улица», «30-я улица», «31-я улица», «32-я улица», «33-я улица», «34-я улица», «1-й спуск», «2-й спуск» |
longitude | Географические координаты (долгота) | Число с плавающей точкой(float) | |
latitude | Географические координаты (широта) | Число с плавающей точкой(float) | |
radius_location | Показывать зону(область), вместо точных координат | Строка (string) | «да», «нет». По умолчанию: нет |
Описание | |||
description | Описание объекта (рус) | Строка (string) | Длина описания должна быть не более 2000 символов |
description_uk | Описание объекта (укр) | Строка (string) | Длина описания должна быть не более 2000 символов |