технические требования v2

ТЕХНИЧЕСКИЕ ТРЕБОВАНИЯ V2
Экспорт Данных для размещения в базе объектов сайта realtyadv.ru осуществляется в
XML (http://www.w3.org/TR/REC-xml) формате. Ниже содержится описание используемых
для экспорта
Данных элементов, необходимые комментарии и пример экспортного файла.
1. Описание элементов, используемых для экспорта Данных
Корневым элементом XML-файла является <root>.
В <root> может содержаться любое количество элементов <object>. Каждый <object>
описывает один объект и должен содержать следующие элементы, необходимые для
экспорта данных:
<objectid> - идентификатор объекта в базе данных клиента (целое неотрицательное число).
Обязательный элемент. Используется для последующего обновления информации об
объекте. При переходе на новые требования к xml обратите внимание на сохранение
objectid у ваших объектов.
<title> - название объекта (до 60 символов). Обязательный элемент.
Пример: <title>Здание в Elsterwerda</title>
<type> - тип объявления. Может принимать значения: 'sale' – объявление о продаже, 'rent' –
объявление о сдаче в аренду. Обязательный элемент.
Пример: <type>sale</type>
<market> - первичный или вторичный рынок. Может принимать значения: 'primary' –
первичный рынок, 'secondary' – вторичный, 'mortgage' – залоговый. Необязательный
элемент.
Пример: <market>primary</market>
<annotation> - краткое описание объекта (до 150 символов). Необязательный элемент.
Пример: <annotation>Жилое и коммерческое здание расположено в городке Elsterwerda, в
федеральной земле Бранденбург.</annotation>
<description> - полное описание объекта. Текст не должен содержать текст из краткого
описания, т.к. на странице объекта краткое и полное описание расположены друг над
другом. Необязательный элемент. Возможны html теги в контейнере <![CDATA[ текст ]]>
Разрешенные теги. <br> <strong> <b> <ul> <li> <i> <u> <sup>
Пример: <description>Год постройки: 1900
Общая площадь: 261
Состояние объекта: произведена частичная санация
Сдан в аренду: Да
Число жилых единиц: 5
Число коммерческих единиц: 1
Доход в год текущий: 15965
Доход в год полный: 17789
Доход при текущей сдаче в аренду: 8.87%
Доход при полной сдаче в аренду: 9.88%</description>
<price> - Если тип объявления sale в поле указывается стоимость объекта (целое
неотрицательное число). Если значение поля 0, на сайте будет отображаться «Цена по
запросу». Обязательный элемент.
Пример: <price>180000</price>
Если тип объявления rent – стоимость за период (целое неотрицательное число). Хотя бы
одна цена должна быть указана.
<price_rent_d> - Стоимость аренды в день
<price_rent_w> - Стоимость аренды в неделю
<price_rent_m> - Стоимость аренды в месяц.
<price_rent_y> - Стоимость аренды в год
Пример:
<price_rent_d>100</price_rent_d >
<price_rent_w>600</price_rent_w>
<price_rent_m>2000</price_rent_m>
<price_rent_y>20000</price_rent_y>
<currency> - валюта цены Возможные значения: eur (Евро), usd (Американский доллар),
chf (Швейцарский франк), gbp (Британский фунт), rur (Российский рубль). Обязательный
элемент.
Пример: <currency>eur</currency>
<region> - id региона объекта (см. справочник
http://www.homesoverseas.ru/import/countries.php). Обязательный элемент.
Пример: <region>42</region>
<realty_type> - тип недвижимости. Обязательный элемент. Может принимать значения:
14 - Коммерческая недвижимость
15 - Земельные участки
16 - Квартиры (апартаменты)
17 - Дома (виллы)
18 - Таунхаусы
Подтипы коммерческой недвижимости
20 - Отель (гостиница)
21 - Ресторан (кафе)
22 - Магазин
23 - Офис
24 - Склад
25 - Производство
26 - Другое
Пример: <realty_type>16</realty_type>
<bedrooms> - количество спален (целое неотрицательное число). Необязательный элемент.
Пример: <bedrooms>5</bedrooms>
<rooms> - количество комнат (целое неотрицательное число). Необязательный элемент.
Пример: <bedrooms>5</bedrooms>
Должен быть указан параметр bedrooms или rooms.
<size_house> - жилая площадь в кв.м.(только для апартаментов, вилл, таунхаусов)
Необязательный элемент.
Пример: <size_house>5</size_house>
<size_land> - площадь участка в кв.м.(только для продажи таунхаусов, вилл и земельных
участков) Необязательный элемент.
Пример: <size_land>5</size_land>
<year> - год постройки (кроме земельных участков). Необязательный элемент.
Пример: <year>1995</year>
<not_ready_year> - год завершения постройки, если не указан год постройки.
Необязательный элемент.
Пример: <not_ready_year>5</not_ready_year>
<not_ready_quarter> - квартал завершения постройки, если не указан год постройки.
Необязательный элемент. (1,2,3,4)
Пример: <not_ready_quarter>4</not_ready_quarter>
<level> - этаж (только для квартир (апартаментов)). Необязательный элемент.
Пример: <level>3</level>
<levels> - этажность здания (кроме земельных участков). Необязательный элемент.
Пример: <levels>5</levels>
<distance_aero> - Расстояние до аэропорта в км.. Необязательный элемент.
Пример: <distance_aero>120</distance_aero>
<distance_ sea> - Расстояние до моря в км.. Необязательный элемент.
Пример: <distance_sea>120</distance_sea>
<distance_ski> - Расстояние до горнолыжного подьемника в км.. Необязательный элемент.
Пример: <distance_ski>10</distance_ski>
<distance_rus> - Расстояние до границы с Россией в км..Только для Финляндии, Эстонии,
Латвии, Литвы. Необязательный элемент.
Пример: <distance_rus>80</distance_rus>
<option> - id опции (см. Раздел 4 «Опции»). Необязательный элемент. В случае, если
объекту соответствует несколько опций, элемент <option> повторяется.
Пример:
<option>9</option>
<option>18</option>
<option>15</option>
<lat> - широта
<lng> - долгота
Координаты объекта для привязки к карте. Указываются в градусах, десятичный
разделитель – точка. Необязательный элемент.
Пример: <lat>56.298457922</lat><lng>-23.19283459</lng>
<photo> - url файла с фотографией объекта. Необязательный элемент. Одному объекту
может соответствовать до 15 фотографий. В этом случае элемент повторяется.
Принимаются иллюстрации с шириной не менее 560 пикселов.
Пример:
<photo>http://www.homesoverseas.ru/pic/objects/7648.jpg</photo>
<photo>http://www.homesoverseas.ru/pic/objects/7581.jpg</photo>
<ytid> - YouTube id видео. Необязательный элемент.
Пример: <ytid>oHDnTr5O28Q</ytid>
<developer>- объект от застройщика (только для продажи).
Необязательный элемент (Y/N)
Пример: <developer>Y</developer>
2. Символы и кодировки
По умолчанию (если это не указано явно в заголовке) кодировкой файла считается utf-8. В
противном случае выставление кодировки xml файла обязательно. Наиболее часто
употребляемые кодировки: windows-1251, utf-8, koi8-r
Внимание: фактическая кодировка, отдаваемая веб-сервером, ВСЕГДА должна совпадать
с кодировкой, указанной в заголовке XML.
Встречающиеся в тексте символы < > & ' " необходимо заменять на соответствующие
элементы:
& на &
< на <
> на >
' на '
" на "
² на ²
(здесь точка с запятой - это не разделитель данного списка, а обязательная часть
элемента!)
Замены должны производиться во всех элементах <object> - в <title>, <description>,
<annotation>, <photo> и др.
Например, ссылка "http://some.host.ru/?id=1&page=10" приводится к виду
"http://some.host.ru/?id=1&page=10".
В случае, если RSS-файл передается в koi8-r, необходимо также заменить встречающиеся
в тексте символы кодировки windows-1251 на аналоги из koi8-r:
многоточие код симвода 133
en-dash (короткое тире), код симвода 150
em-dash (длинное тире), код симвода 151
"Русский" номер код симвода 185
Кавычки-"ёлочки" коды символов 171 и 187
"Сглаженные" кавычки-"лапки" коды символов 147 и 148
"Сглаженные" апострофы: коды символов 145 и 146
3. Пример экспортного файла
Пример доступен по ссылке: http://www.homesoverseas.ru/import/example_new.xml
4. Опции
Месторасположение
7 первая линия моря/озера
8 центр города
16 вторая линия моря/озера
21 пригород
Вид
5 вид на горы
6 вид на море/океан/залив
9 панорамный вид
37 вид на озеро
41 вид на город
42 вид на парк/сад
Характеристики участка
43 вода
44 электричество
45 газ
46 дорога
47 разрешение на строительство
Планировка и помещения
23 открытая парковка
25 балкон
32 свободная планировка
33 гараж
34 отдельный вход
35 терраса
36 ландшафтный дизайн
Оборудование
10 бытовая техника
11 джакузи
12 камин/печь
13 меблировка
14 теплый пол
15 «умный дом»
17 отопление
18 кондиционирование
31 спутниковое ТВ
48 интернет
49 подсобные помещения
Отдых и инфраструктура
19 бассейн
20 гольф-поле
22 горные лыжи
24 собственный пляж
26 стоянка для яхт
27 фитнес-центр
28 спа/салон красоты
29 парк
30 детская площадка
50 теннисный корт
51 супермаркет
52 школа/детский сад
53 медицинские учреждения
54 рестораны/кафе
Финансирование и управление
55 доступна ипотека
56 доступна рассрочка
57 возможен торг
58 услуги управляющей компании
59 услуги по сдаче в аренду