Описание структуры данных каталога недвижимости в формате XML для загрузки на сайт LuxComfort.com



   Вы можете настроить автоматическую загрузку каталога объектов с Вашего сайта, а также его периодическое обновление. Для этого потребуется скрипт, который будет возвращать данные о Ваших объектах в формате XML.

У нас предусмотрено два вида скриптов:
1. Скрипт загрузки каталога
2. Скрипт обновления статуса объектов и периодов времени, на которые объект забронирован (только для сдаваемых в аренду объектов)


Скрипт загрузки каталога


   Этот скрипт вызывается с заданной периодичностью (например, раз в сутки) и загружает на сайт LuxComfort.com полную базу Ваших объектов. Новые объекты добавляются на сайт LuxComfort; для объектов, информация о которых была загружена ранее, производится проверка на предмет изменения каких-либо параметров и, если что-либо в характеристике объекта изменилось, соответствующие изменения вносятся и в базу сайта LuxComfort.

   Таким образом каталог Ваших объектов на сайте LuxComfort автоматически синхронизируется с основным источником (например, Вашим сайтом или базой объектов).

   Пример минимального набора данных, возвращаемых сайту LuxComfort скриптом загрузки каталога:

Content-type: text/xml;charset=UTF-8

<Properties>
<Property>
<Id>100</Id>
<Price>195000</Price>
</Property>
</Properties>

Более полный пример выдачи скрипта загрузки каталога здесь

   Ниже приведены параметры, содержащиеся внутри элемента Property, которые могут быть переданы на сайт LuxComfort.com с помощью XML, и их краткое описание. Красным цветом выделены обязательные параметры, без указания которых добавление объекта на сайт невозможно. Обратите внимание, что чем больше информации об объекте Вы указываете, тем выше вероятность, что потенциальные клиенты заинтересуются данным предложением. Наиболее информативные страницы объектов обеспечивают наибольшее количество конверсий.

Id Id объекта. Обязательный параметр. Указывается Вами для целей идентификации среди Ваших объектов. Может совпадать с Id объекта на Вашем сайте или отличаться от него.
Допустимые символы: 0-9, A-Z, a-z
Price Обязательный параметр. Целое число.
Currency Валюта, в которой указана цена.
Доступные значения:
EUR - евро
USD - доллары
По умолчанию - EUR.
PropertyType Вид объекта.
Доступные значения:
apartment - квартира
apartments - апартаменты
villa - вилла (дом с участком)
townhouse - таунхаус
attic - пентхаус
studio - студия
condo - кондоминиум
loft - лофт
commercial - коммерческая недвижимость
land - земельный участок
DealType Тип сделки.
Доступные значения:
sale - продажа
rent - аренда
По умолчанию - sale.
DealTerm Указывается только для аренды (если DealType=sale).
Срок аренды, для которого указана цена.
Доступные значения:
day - в день
week - в неделю
month - в месяц
Например, если Price=200, Currency=EUR и DealTerm=week, то это значит, что цена составляет 200 авро в неделю.
По умолчанию - week.
MaxGuests Указывается только для аренды (если DealType=sale).
Максимальное количество проживающих.
Status Статус предложения.
Доступные значения:
active - активно и доступно для поиска
sold - продано
busy - объект занят
suspended - временно приостановлено
delete - удалить объект из каталога на LuxComfort.com
По умолчанию - active
Если не выбрана опция "искать проданные объекты", в поиске участвуют только объекты со статусом active.
Region Регион по-русски или по-испански из списка доступных регионов или код региона.
Предпочтительно указывать код региона (например: CBL - Коста-Бланка). Если регион указан в текстовом виде по-русски или по-испански (например: Costa Blanca), программа попытается самостоятельно подобрать соответствующий код. Если код определить не удалось, значение не заносится в БД. То есть считается что регион не указан.
Province Провинция. Указывается по-русски или по-испански.
City Город (желательно по-русски).
CityOrig Город (только по-испански).
CityArea Район города (желательно по-русски).
CityAreaOrig Район города (только по-испански).
Street Улица.
Edif Номер дома.
Condition Состояние объекта.
Доступные значения:
new - новый
resale - втричный рынок
Year Год постройки.
Size Общая площадь в м2 (целое число)
SizeLand Площадь участка (если применимо). Целое число.
Rooms Кол-во спален (комнат). Целое число.
Baths Кол-во санузлов. Целое число.
Heating Наличие системы отопления.
Доступные значения:
yes - есть
no - нет
Conditioning Наличие системы кондиционирования.
Доступные значения:
yes - есть
no - нет
Furniture Наличие мебели.
Доступные значения:
yes - есть
no - нет
Pool Бассейн.
Доступные значения:
public - общий
private - собственный
no - нет
View Вид.
Доступные значения:
sea - на море
city - на город
panoramic - панорамный
mountains - на горы pool - на бассейн patio - во двор
Parking Гараж/паркинг.
Доступные значения:
yes - есть
no - нет
poptional - есть возможность приобрести отдельно
SeaDistance Расстояние до моря в километрах. Целое или дробное число. Например: 0,2 значит, что до моря 200 метров.
Features Дополнительные параметры (через запятую, 3-4 слова каждый).
Например: магазины рядом, недалеко яхт-клуб, хорошая пляжная инфраструктура, рестораны
На странице объекта это будет выглядеть примерно так:
  • магазины рядом
  • недалеко яхт-клуб
  • хорошая пляжная инфраструктура
  • рестораны
Description Максимально полное и подробное описание объекта. Сюда можно вставлять видео с сайта Youtube. URL-адреса страниц Youtube автоматически конвертируются в видео на странице объекта.
Также можно вставлять изображения в следующем формате: [img="http://www.example.com/example.jpg"]
DescriptionShort Сокращенное описание объекта (1-2 предложения). Размещается в верхней части страницы и в поле "meta description".
Keywords Ключевые слова (не обязательно)
Lat Широта (координаты для точного отображения на карте). Если не указано, программа постарается установить это значение автоматически на основе других данных о местонахождении объекта (город, улица, дом).
Lng Долгота (координаты для точного отображения на карте). Если не указано, программа постарается установить это значение автоматически на основе других данных о местонахождении объекта (город, улица, дом).


Список доступных регионов


Код регионаРегион
CDSКоста-дель-Соль
CBLКоста-Бланка
IBLБалеарские острова
CBRКоста-Брава
ICRКанарские острова
CDRКоста-Дорада
VALВаленсия
MDRМадрид
BCNБарселона
MURМурсия
ANDАндорра*
CDGКоста-де-Галисия
CVRКоста-Верде
CVSКоста-Баска
CDMКоста-дель-Маресме
CGRКоста-дель-Гарраф
CAZКоста-дель-Асаар
CDVКоста-де-Валенсия
CCLКоста-Калида
CALКоста-Альмерия
CTRКоста-Тропикаль
CDLКоста-де-ла-Лус
* Хотя Андорра и является отдельной страной, мы добавили ее в связи с наличием значительного количества предложений.

   URL фотографий объекта указываются в элементе Photos, который располагается внутри элемента Property:


<Photos>
<url><![CDATA[http://www.example.com/image1.jpg]]></url>
<url><![CDATA[http://www.example.com/image2.jpg]]></url>
</Photos>

   Фотографии, указанные в этой секции, скачиваются на сайт LuxComfort и храняться в каталоге Ваших объектов.



   Даты начала и окончания периодов, на которые данный объект забронирован (в случае с арендой) указываются с помощью элемента Booked, расположенного внутри элемента Property.
Формат дат: ДД-ММ-ГГГГ:ДД-ММ-ГГГГ (СТРОГО)


<Booked>
<Dates>29-04-2013:10-05-2013</Dates>
<Dates>30-12-2013:08-01-2014</Dates>
</Booked>

   Обратите внимание, что в разделе Booked должны быть перечислены ВСЕ ПЕРИОДЫ ВРЕМЕНИ, на который объект забронирован. При обработке раздела Booked LuxComfort удаляет из каталога всю информацию о ранее установленных датах бронирования данного объекта и заменяет ее информацией, заданной в разделе Booked.



Пример набора данных, возвращаемых сайту LuxComfort скриптом загрузки каталога


Content-type: text/xml;charset=UTF-8

<Properties>
<Property>
<Id>100</Id>
<Price>70</Price><!-- Обязательный параметр. Целое число. -->
<Currency>EUR</Currency> <!-- Валюта, в которой указана цена: EUR, USD -->
<PropertyType>Townhouse</PropertyType> <!-- Вид объекта: apartment, villa, townhouse, condo, loft, commercial, land -->
<DealType>rent</DealType> <!-- Тип сделки: sale, rent -->
<DealTerm>day</DealTerm> <!-- Срок аренды, для которого указана цена (только для аренды): day, week, month -->
<MaxGuests>3</MaxGuests> <!-- Максимальное количество проживающих (только для аренды) -->
<Status>active</Status> <!-- Статус предложения: active, sold, busy, suspended. По умолчанию - active -->
<Region>CBL</Region> <!-- Регион по-русски или по-испански из списка доступных регионов или код региона. Если регион не указан или указан неверно, значение не заносится в БД -->
<Province></Province>
<City>Кальпе</City> <!-- Город (желательно по-русски) -->
<CityOrig>Calpe</CityOrig> <!-- Город по-испански -->
<CityArea></CityArea> <!-- Район города (желательно по-русски) -->
<CityAreaOrig></CityAreaOrig> <!-- Район города по-испански -->
<Street></Street> <!-- Улица, почтовый индекс (если известно) -->
<Edif></Edif> <!-- Номер дома -->
<Condition>resale</Condition> <!-- Состояние объекта: new, resale -->
<Year>1985</Year> <!-- Год постройки -->
<Size>92</Size> <!-- Площадь в кв.м. (только число) -->
<SizeLand>120</SizeLand> <!-- Площадь участка (если применимо) -->
<Rooms>3</Rooms> <!-- Количество спален (комнат) -->
<Baths>2</Baths> <!-- Количество санузлов -->
<Heating>yes</Heating> <!-- Наличие системы отопления: yes, no -->
<Conditioning>yes</Conditioning> <!-- Наличие системы кондиционирования: yes, no -->
<Furniture>no</Furniture> <!-- Наличие мебели: yes, no -->
<Pool>public</Pool> <!-- Бассейн: public, private, no -->
<View>sea</View> <!-- Вид: sea, city, panoramic, mountains -->
<Parking>yes</Parking> <!-- Гараж/паркинг: yes, no, optional. "optional" значит, что можно приобрести отдельно. -->
<SeaDistance>0,2</SeaDistance> <!-- Расстояние до моря в км. Может быть дробным: 0,5. -->
<Features>магазины рядом, яхт-клуб, рестораны</Features> <!-- Дополнительные параметры (через запятую, 3-4 слова каждый). -->
<Description></Description> <!-- Описание объекта -->
<DescriptionShort>Прекрасный дом с участком с видом на море на первой линии города Кальпе</DescriptionShort> <!-- Сокращенное описание объекта (1-2 предложения). Размещается в верхней части страницы и в поле "meta description". -->
<Keywords></Keywords> <!-- Ключевые слова (не обязательно). Только имеющие отношение к данному объекту. -->
<Lat></Lat> <!-- Широта. Если не указано, вычисляется автоматически на основе адреса объекта. -->
<Lng></Lng> <!-- Долгота. Если не указано, вычисляется автоматически на основе адреса объекта. -->

<Photos> <!-- Раздел фотографий объекта. Максимальное кол-во - 200 шт. -->
<main></main> <!-- Основное фото (будет отображаться первым на странице объекта) -->
<url></url> <!-- Фотография объекта -->
<url></url> <!-- Фотография объекта -->
</Photos>

<!-- RENT Этот раздел касается только аренды (если в DealType указано rent). Если указано sale, то данный блок игнорируется. -->
<Booked> <!-- Список дат, на которые объект уже забронирован и, следовательно, недоступен для заказа -->
<Dates>29-04-2013:10-05-2013</Dates> <!-- Даты начала и окончания бронирования в формате: ДД-ММ-ГГГГ:ДД-ММ-ГГГГ (СТРОГО) -->
<Dates>30-12-2013:08-01-2014</Dates>
</Booked>
<!-- /RENT -->

</Property>
</Properties>

Скрипт обновления статуса объектов и дат их бронирования


   Данный скрипт не является обязательным. Он может запускаться чаще, чем скрипт загрузки всего каталога (например, раз в 10 минут) и, как правило, используется для обновления сведений о датах бронирования объектов, а также чтобы изменить статус объекта, например, с "active" на "sold". Также с помощью этого скрипта можно удалить определенные Ваши объект(ы) из каталога LuxComfort (установив статус объекта "delete").

В принципе, эту же информацию можно передать сайту LuxComfort и через скрипт загрузки каталога, однако он выполняется реже (раз в сутки), а данный скрипт - несколько раз в час. Таким образом производится более оперативная синхронизация наиболее важной информации об объектах.

   Пример выдачи скрипта обновления статуса объектов и дат бронирования:

Content-type: text/xml;charset=UTF-8

<Properties>

<Property>
<Id>100</Id>
<Status>delete</Status>
</Property>


<Property>
<Id>105</Id>
<Booked> <!-- Список дат, на которые объект уже забронирован и, следовательно, недоступен для заказа -->
<Dates>29-04-2013:10-05-2013</Dates> <!-- Даты начала и окончания бронирования в формате: ДД-ММ-ГГГГ:ДД-ММ-ГГГГ (СТРОГО) -->
<Dates>30-12-2013:08-01-2014</Dates>
</Booked>
</Property>

</Properties>

   В данном примере сайту LuxComfort дается инструкция удалить объект с Id 100, а для объекта с Id 105 (сдающегося в аренду) установить даты, на которые он недоступен, так как уже забронирован.

   Обратите внимание, что в разделе Booked должны быть перечислены ВСЕ ПЕРИОДЫ ВРЕМЕНИ, на который объект забронирован. При обработке раздела Booked LuxComfort удаляет из каталога всю информацию о ранее установленных датах бронирования данного объекта и заменяет ее информацией, заданной в разделе Booked.


Если Вам требуется помощь в настройке автоматической загрузки Ваших каталогов на LuxComfort или имеются какие-либо вопросы технического характера, пожалуйста, напишите нам сюда.