ФОРМАТ ФАЙЛА 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 и телефон.

ЦЕНА И ПЛОЩАДЬ

Указываются с валютой и единицей измерения (кв.м), а для земельных участков – в сотках или гектарах. Также можно добавить <floors-total></floors-total> и другие параметры жилой площади.

ОПИСАНИЕ ОБЪЯВЛЕНИЯ

Поле содержит подробное описание недвижимости на украинском языке:<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>