ФОРМАТ ФАЙЛА YML | Допомога qip.ua

ВИМОГИ ДО ФАЙЛУ YML

Фід має містити тільки актуальні оголошення. URL фіда повинен бути постійним та доступним по протоколу HTTP.

МАСКУВАННЯ СИМВОЛІВ

Всі значення даних (включно з URL) повинні бути замасковані за допомогою XML-сутностей. Це забезпечує коректне відображення спеціальних символів у системі. Кодування файлу повинне залишатися UTF-8.

СТРУКТУРА YML-ФАЙЛУ

Файл складається з кореневого елементу <realty-feed> з вкладеними. Кожне оголошення містить такі блоки:</realty-feed>

ОГОЛОШЕННЯ (OFFER)

Кожне оголошення має атрибут internal-id для внутрішнього обліку та може містити external-id для оновлення даних із зовнішньої системи. Також можна вказати для публікації або зняття оголошення з публікації.

ТИП НЕРУХОМОСТІ

Вказується (продаж або оренда), (квартира, будинок, комерційна нерухомість тощо) та додаткові підкатегорії (наприклад, <property-type> для житлової або комерційної).</property-type>

ЛОКАЦІЯ (LOCATION)

Всі географічні дані мають бути українською мовою:

країна
область
район
населений пункт
вулиця

За бажанням можна додати координати (latitude та longitude) для точного розташування об’єкта.

АГЕНТ (SALES-AGENT)

Вказуються контактні дані агента або агентства, але для прикладу дані можуть бути умовними. Наприклад: ім’я, категорія (агентство), організація, email та телефон.

ЦІНА ТА ПЛОЩА

Вказуються з валютою та з одиницею виміру (кв.м), а для земельних ділянок – у сотках або гектарах. Також можна додати та інші параметри житлової площі.

ОПИС ОГОЛОШЕННЯ

Поле містить докладний опис нерухомості українською мовою:<description> ОПИС УКРАЇНСЬКОЮ МОВОЮ</description>.

ФОТОГРАФІЇ (IMAGE)

Кожне оголошення може містити декілька з посиланнями на фотографії об’єкта. Рекомендується використовувати прямі посилання на файли зображень у високій якості.

ПРИКЛАД YML

Ось приклад структури оголошення у стандартному YML форматі:

<offer internal-id="1">
    <type>продаж</type>
    <category>будинок</category>
    <property-type>жила</property-type>
    <url>http://example.com/estate-1.html</url>
    <location>
        <country>Україна</country>
        <region>Львівська область</region>
        <district>Галицький район</district>
        <locality-name>Львів</locality-name><address>Вулиця Січових Стрільців, 10</address>
    </location>
    <sales-agent>
        <name>Ім’я агента</name>
        <category>агентство</category>
        <organization>Назва агентства</organization>
        <email>example@email.com</email>
        <phone>0000000000</phone>
    </sales-agent>
    <price>
        <value>150000</value>
        <currency>USD</currency>
    </price>
    <area>
        <value>120</value>
        <unit>кв.м</unit>
    </area>
    <description>ОПИС УКРАЇНСЬКОЮ МОВОЮ</description>
    <img>http://example.com/images/estate1.jpg</img>
</offer>