Mail.RuПочтаМой МирОдноклассникиИгрыЗнакомстваНовостиПоискВсе проекты
старый XML-формат

 

Данный формат доступен до конца ноября 2014 г.

Актуальный XML-формат системы

 

 

 

Общие требования к формированию автоматических XML-выгрузок

  • Все тексты, размещенные в выгрузке, должны быть очищены от html-cущностей (например,  , — и прочих)

 

XML-документ должен начинаться с декларации версии XML и указания кодировки документа. 

Рекомендуемая кодировка для XML: UFT-8

Так же мы принимаем рекламу в кодировке windows-1251.

 

Примеры XML-файлов для описания различных типов недвижимости:

 

Обязательные для заполнения теги обозначены знаком: * звездочкой.

* <root> Главный элемент документа - root, который содержит множество тагов offer, которые, в свою очередь, содержат детальную информацию об объектах недвижимости.

* <offer> Каждый из объектов недвижимости должен быть описан тагом offer.

Каждый таг offer включает в себя множество тагов-свойств объекта недвижимости:

<id> Идентификатор объекта в вашей базе данных, обязательно для заполнения и действительно должно соответствовать аналогичному объекту в вашей базе данных, тип: целое число (integer) </id>

 
*<direction> предложение </direction>
*<provider> Ваш логин в базе системе "Недвижимость.Про", тип: строка (string).
Обратите внимание: если у вас еще нет логина - зарегистрируйтесь по адресу http://pro.realty.mail.ru/register/
</provider>
 
<lastupdated>Дата последнего обновления информации об объекте, тип: дата (YYYY-MM-DD или DD-MM-YYYY или DD.MM.YYYY) </lastupdated>
 
*<part>Сегмент недвижимости. Возможные значения: жилая, коммерческая, загородная, зарубежная жилая, зарубежная коммерческая. Тип: строка (string) </part>
 
<bargain> Тип сделки. Тип: строка (string). Возможные значения: аренда, продажа. </bargain>
 
<object> Тип объекта.
  • Возможные значения для жилой недвижимости:
    • квартира
    • комната
    • новостройка
  • Возможные значения для коммерческой недвижимости:
    • офис
    • склад
    • ТП
    • ПСН
    • ПСУ
    • ОСЗ
    • нежилое помещение
    • здание
    • земля
    • магазин
    • готовый бизнес
    • инвестпроект
    • гостиница
    • производство
  • Возможные значения для загородной недвижимости:
    • дом
    • участок
    • коттедж
    • дача
    • особняк
    • таунхаус
    • коттеджный поселок
  • Возможные значения для зарубежной недвижимости:
    • Зарубежная жилая:
      • Квартира -> (поддерживаемые синонимы: "студия" "квартиры,апартаменты" "апартаменты" "апартаменты,таунхаус")
      • Дуплекс
      • Замок -> (поддерживаемые синонимы: "замки")
      • Мезонет -> (поддерживаемые синонимы: "мезонет")
      • Коттедж -> (поддерживаемые синонимы: "дом" "резиденция" "особняк" "коттедж,вилла" "дом")
      • Линктхаус
      • Пентхаус -> (поддерживаемые синонимы: "пентхаусы")
      • Таунхаус -> (поддерживаемые синонимы: "таунхаусы")
      • Вилла -> (поддерживаемые синонимы: "виллы и коттеджи")
      • Остров
      • Земельный участок (жилье) -> (поддерживаемые синонимы: "земельные участки")
      • Шале
    • Зарубежная коммерческая:
      • Отель, гостиница (поддерживаемые синонимы: "отель, гостиница" "гостиница" "отель" "мотель")
      • Ресторан, кафе -> (поддерживаемые синонимы: "ресторан, кафе" "ресторан" "кафе" "бар")
      • Торговая -> (поддерживаемые синонимы: "торговая")
      • Офисная -> (поддерживаемые синонимы: "офис" "офисы" "офисный" "офисное помещение")
      • Производство -> (поддерживаемые синонимы: "производство" "производственно-складской")
      • Склад -> (поддерживаемые синонимы: "склад" "склады")
      • Земля -> (поддерживаемые синонимы: "земля" "земельный участок")
      • Спорт и развлечения -> (поддерживаемые синонимы: "спорт и развлечения")
      • Другое -> (поддерживаемые синонимы: "другое")
      • Готовый бизнес -> (поддерживаемые синонимы: "готовый бизнес")
      • Здание -> (поддерживаемые синонимы: "здание")
</object>
 
 
 
<country> Страна, в которой находится объект. Заполняется на русском языке!. Тип: строка (string) </country>
 
<street>Улица, на которой находится объект, тип: строка (string) </street>
 
<house>Номер дома, корпус, литера, строение в формате: д. 2, к. 1, л. А, стр. 2. Тип: строка (string) </house>
 
<address> Полный адрес объекта, включая улицу и номер дома. Страну (для зарубежной недвижимости) здесь указывать не нужно, тип: строка (string) </address>
 
<state> Область, в которой находится объект недвижимости (не обязательно для зарубежной недвижимости). Тип: строка (string). Поддерживаемые значения:
  • Московская
  • Ленинградская
  • Башкортостан
  • Белгородская
  • Брянская
  • Владимирская
  • Волгоградская
  • Воронежская
  • Ивановская
  • Иркутская
  • Калужская
  • Кировская
  • Костромская
  • Краснодарский
  • Красноярский
  • Курская
  • Липецкая
  • Нижегородская
  • Новосибирская
  • Омская
  • Орловская
  • Пензенская
  • Пермский
  • Ростовская
  • Самарская
  • Саратовская
  • Свердловская
  • Смоленская
  • Сочинская
  • Татарстан
  • Тверская
  • Тольяттинская
  • Тульская
  • Тюменская
  • Челябинская
  • Ярославская
Без указания область/край/республика в теге. Указывается всегда и содержит Область или Край, в котором находится объект. Если квартира находится в, например, Москве, то она одновременно находится и в Московской области, поэтому тег <state> нужен всегда, точно так же как Московская область находися в России, и это указывается - <country>Россия. Теги <country> и обязательны для заполнения.
</state>
 
<state_region> Район области/крае, в которой находится объект недвижимости (не обязательно для зарубежной недвижимости). Если информации о районе нет - заполнять тег не нужно.
Внимание: тег обязателен для заполнения в случае отсутствия информации в теге <town>., Тип: строка (string). </state_region>
 
<town> Любой населенный пункт (деревня, село, город и так далее; в том числе и основной город, например, Москва), если указан. Необязательно для зарубежной недвижимости. Если объект находится вне населенного пункта или информации о населенном пункте нет заполнять тег не нужно.
Внимание: тег обязателен для заполнения в случае отсутствия информации в теге <state_region>., Тип: строка (string).
Поддерживаются все значения - обращайтесь на cre@corp.mail.ru
 
В случае с зарубежной недвижимостью любые значения данного поля поддерживаются, но проходят модерацию.
</town>
 
<district> Для городской недвижимости Москвы - административный округ, для загородной недвижимости - шоссе (для загородной недвижимости - обязательно для заполнения). Тип: строка (string). Связанные таги: distance, distancetype.
  • Возможные значения для Москвы:
    • Восточный 
    • Западный 
    • Северный 
    • Северо-Восточный 
    • Северо-Западный 
    • Центральный 
    • Юго-Восточный 
    • Юго-Западный 
    • Южный 
    • Зеленоградский 
  • Для МО:
    • Алтуфьевское
    • Боровское
    • Быковское
    • Варшавское
    • Волоколамское
    • Горьковское
    • Дмитровское
    • Егорьевское
    • Ильинское
    • Калужское
    • Каширское
    • Киевское
    • Куркинское
    • Ленинградское
    • Минское
    • Можайское
    • Новокаширское
    • Новорижское
    • Новорязанское
    • Новосходненское
    • Носовихинское
    • Осташковское
    • Пятницкое
    • Рогачевское
    • Рублево-Успенское
    • Симферопольское
    • Сколковское
    • Щелковское
    • Ярославское
Если шоссе, на котором находится ваш объект, нет в списке - пожалуйста свяжитесь с нами.
</district>
 
<region>Район в населенном пункте указанном в <town>, районы могут быть не только, например, в Москве, но в любом другом городе, селе, поселке, деревне. Если информации о районе внутри населенного пункта нет - заполнять тег не нужно., тип: строка (string). </region>
 
<subway> Ближайшая станция метро, тип: строка (string). Связанные таги: distance, distancetype. Поддерживаются все станции метро в городах с метрополитеном. </subway>
 
<distance>Удаленность от территориальной точки (метро или МКАД) в минутах или километрах, тип: целое число (integer). Единица измерения задается тегом distancetype. </distance>
 
<distancetype> Тип и единица измерения удаленности, тип: строка (string). Возможные значения:
  • минут пешком
  • минут транспортом
  • км от МКАД
</distancetype>
 
<description> описание объекта </description>
 
Для более точного определения точки на Карте рекомендуем указывать Широту и Долготу:
<maplnlt>ln,lt</maplnlt>
Где ln – долгота; lt – широта
 
<rooms> Контейнер количества комнат. Необходимо для объектов жилой, загородной и жилой зарубежной недвижимости. Тип: целое число (integer). В случае с продажей комнат нужно указывать 0. В случае указания количества комнат От-До количеством тегов room не может быть больше 2.
<room>Количество комнат - фиксированное количество. Тип: целое число (integer).</room>
Либо
<room>Количество комнат От. Тип: целое число (integer).</room> <room>Количество комнат До. Тип: целое число (integer).</room>
</rooms>
 
* <prices> Цены на объект недвижимости. Вложенные таги: price. Логика работы этого тага для разных типов недвижимости разная:
  • новостройки - в случае, если в новостройке продается несколько квартир, то нужно указывать минимальную и максимальную строимость этих квартир (связанные таги: areas, flatcount)
  • коттеджные поселки - аналогично новостройкам (связанные таги: areas)
  • коммерческая недвижимость - в случае, если площадь реализуемого помещения может быть "от-до", то и цена должна включать минимальное и максимальное значение

В любом случае, вложенных тагов price не может быть больше двух.

<price>Стоимость. Стоимость напрямую зависит от тагов currency, priceunit, priceperiod, areas. Тип: целое число (integer).</price>

</prices>
 
<currency> Валюта, в которой рассчитывалась Стоимость объекта недвижимости. Тип: строка (string). Возможные значения:
  • RUR
  • USD
  • EUR

</currency>

 
<priceunit> Единица измерения стоимости. Тип: строка (string). Возможные значения:
total - общая цена (мы используем по умолчанию)
m2 - цена за квадратный метр
</priceunit>
 
<priceperiod> Указание периода, за который указана стоимость. Тип: строка (string). Возможные значения:
  • total - для всех операций, кроме аренды, найма
  • hour - за час
  • day - за день/сутки
  • month - за месяц (мы используем по умолчанию для всей аренды)
  • year - за год
</priceperiod>
 
<mortgage> Признак продажи с помощью ипотечного кредита. Тип: целое число (integer). Возможные значения: 1 - возможна ипотека, 0 - невозможна или неизвестно. </mortgage>
 
<newbuilding> Признак новостройки, тип: целое число (integer). Возможные значения: 1 - новостройка, иные значения - не новостройка. Связанные таги: newbuilding_date, object (значения: новостройка, квартира). </newbuilding>
 
<newbuilding_date> Дата госкомиссии для новостройки, тип: строка (string). Формат даты: IVкв 2007г. или IVкв2007г. или 4кв 2007г. или 4кв2007. Иные форматы игнорируются. </newbuilding_date>
 
<housetype> Тип здания для продажи квартир в Москве и МО, тип: строка (string). Связанные таги: pattern.
Возможные значения:
  • панель
  • современная панель
  • кирпич
  • монолит
  • кирпич-монолит
  • сталинский
  • кирпич сталинский
  • старый фонд
  • индивидуальный проект
</housetype>
 
<pattern> Краткое обозначение типа здания, тип: символ (char). Связанные таги: housetype. Возможные значения:
  • П - панель
  • К - кирпич
  • КМ - кирпич-монолит
  • СТ - сталинский
  • КС - кирпич сталинский
  • М - монолит
  • СФ - старый фонд
  • ИП - индивидуальный проект
</pattern>
 
<floor> Этаж, на котором расположен объект, тип: целое число (integer). </floor>
 
<nfloor> Количество этажей в здании, тип: целое число (integer). </nfloor>
 
<areas> Площадь объекта или земельного участка, тип: число с плавающей точкой (float). Возможные значения: конечная площадь, общая площадь, плавающая площадь "От-До". Логика работы в общем виде описана в таге prices. Для коттеджных поселков существует особое указание площади, делящееся на площадь участка (указывается От-До) и площадь коттеджей (указывается От-До). Таким образом для коттеджных поселков указание площадей будет выглядить так:
  • <area type="live">Жилая площадь (От квадратные метры)</area> <area type="live">Жилая площадь (До квадратные метры)</area> <area type="plot">Площадь участка (От сотки)</area> <area type="plot">Площадь участка (До сотки)</area>
Для иных объектов загородной недвижимости:
  • <area type="live">Жилая площадь (квадратные метры)</area> <area type="plot">Площадь участка (сотки)</area>
Для квартир площадь должна быть указана в виде:
  • <area type="live">Полезная жилая площадь (квадратные метры)</area> <area type="kitchen">Площадь кухни (квадратные метры)</area> <area type="total">Общая площадь квартиры (квадратные метры)</area>
Для новостроек, в которых происходит продажа более 1-го объекта нужно указывать площадь таким образом:
  • <area type="total">Общая площадь квартиры в квадратных метрах (От квадратные метры)</area> <area type="total">Общая площадь квартиры в квадратных метрах (До квадратные метры)</area> <area type="live">Полезная жилая площадь (От квадратные метры)</area> <area type="live">Полезная жилая площадь (До квадратные метры)</area>
Для других видов недвижимости площадь может быть указана только в виде "от-до":
  • <area type="total">(От квадратные метры)</area> <area type="total">(До квадратные метры)</area>
Либо, в случае наличия только одной площади:
  • <area type="total">Площадь
</areas>
 
<flatcount>Количество реализуемых квартир (коттеджей - в случае коттеджного поселка), тип: целое число (integer). </flatcount>
 
<images primary="1 или 0"> Множество ссылок на изображения объекта недвижимости, каждая из которых заключена в тег image. В случае, если у изображения установлен атрибут primary="1" - оно считается основным. Все изображения по размеру не должны быть меньше 250 px по ширине и меньше 180 px по высоте.
 
<image> Ссылка на изображение объекта недвижимости у вас на сайте. Тип: строка (string). Формат: http://www.site.ru/image.jpg
Поддерживаемые форматы изображений: jpg, gif, png.</image>
<image>...</image>
</images>
 
<phone> Телефон, который будет выводиться в поле "Контакт", тип: строка (string). Формат телефона: 8 (495) 111-1111, либо 84951111111, либо 4951111111, либо 1111111.
Обратите внимание: телефон должен быть только один - остальные указанные телефоны, а также иные данные будут проигнорированы. Администрация проекта не несет ответственность за потери клиента и третьих лиц из-за указания несуществующего телефона или телефона не в стандатном формате системы.
</phone>
 
<phone_extension> Номер добавочного телефона, который будет выводиться в поле "Контакт", тип: целое число (integer). </phone_extension>
 
<company> Название компании-продавца объекта недвижимости. Тип: строка (string). </company>
 
<email> Адрес электронной почты, тип: строка (string). По указанному адресу заинтересованные посетители смогут отправить заявку на просмотр из карточки объекта недвижимости. Формат: name@domain.ru.
Обратите внимание: администрация проекта не несет ответственность за потери клиента и третьих лиц из-за указания несуществующего адреса или адреса не в стандатном формате адресов электронной почты сети интернет. </email>
 
<url> Ссылка на страницу объекта недвижимости на вашем сайте. Тип: строка (string). По указанной ссылке пользователь будет переходить из фооткаталогов. Формат: http://www.sitename.ru/path_to_object.
Обратите внимание: администрация проекта не несет ответственность за потери клиента и третьих лиц из-за указания несуществующего адреса или адреса не в стандатном формате сетевой адресации сети интернет.
Обратите внимание: Ссылка обязательно должна вести на страницу детального описания объекта недвижимости у вас на сайте, иначе выгрузка может быть сочтена непригодной для размещения.
</url>
 
<client_id>Идентификатор клиента в вашей базе данных. Необходимо для обеспечения статистики только "валовых" рекламных агентств, тип: целое число (integer)client_id> </client_id>
 
<client_name>Название клиента в вашей базе данных. Необходимо для обеспечения статистики только "валовых" рекламных агентств, тип: строка (string)client_name> </client_name>